System Debug Reference Manual > Chapter 10 System Debug Standard Functions

func grp

	MPE documents
	Complete PDF
	Table of Contents
	Index

	E0201 Edition 4 ♥
	E0300 Edition 3
	E0692 Edition 3

Coerces an expression into a GRP logical code pointer (LCPTR).

Syntax


   grp (value)

During the evaluation of the parameter to this function, the search path used for procedure name lookups is limited to the group library file (GRP).

Formal Declaration


   grp:grp (value:any)

Parameters

value: An expression to be coerced. All types are valid.

Table 10-5 Derivation of the GRP Bit Pattern

Parameter Type	Action
`BOOL`	0.1 if `TRUE`, 0.0 if `FALSE`.
`U16 U32 SPTR`	Set the SID part to zero. Right justify the original value in the low-order 32 bits of the offset part with zero fill.
`S16 S32 S64`	Set the SID part to zero. Right justify the original value in the low-order 32 bits of the offset part with sign extension.
`LONG` Class	Transfer both parts of the address unchanged.
`EADDR SADDR`	Transfer the SID part unchanged. Transfer the low-order 32 bits of the offset part.
`STR`	Transfer the ASCII bit pattern for the last eight characters in the string. Strings shorter than eight characters are treated as if they were extended on the left with nulls.

Examples


   %cmdebug > wl grp( 12.304 )
   GRP %12.304

Coerce the simple long pointer into a GRP logical code pointer.


   %cmdebug > wl grp( sort )
   GRP %2.1364

Print the address of the procedure named sort. Note that the search path used for procedure name lookups is restricted to the group library (GRP).


   %cmdebug > wl grp( sys(24.630) )
   GRP %24.630

The coercion simply changes the associated logical file. Note that no complicated conversion or range checking is performed.


   $nmdat > wl grp( 1 )
   GRP $0.1

   $nmdat > wl grp( ffff )
   GRP $0.ffff

   $nmdat > wl grp( 1234abcd )
   GRP $0.1234abcd

   $nmdat > wl grp( -1 )
   GRP $0.ffffffff

   $nmdat > wl grp( 1234.5678 )
   GRP $1234.5678

   $nmdat > wl grp( true )
   GRP $0.1

   $nmdat > wl grp( "ABCDEFG" )
   GRP $414243.44454647

Limitations, Restrictions

none

func errmsg

func hash