System Debug Reference Manual (32650-90888)

446 Chapter10
System Debug Standard Functions
func str
'GRP' Group library
'PUB' Account library
'SYS' System library
'USER' User library
By default, the selector 'PROG' will be used.
userfname The file name of a user library file. Since multiple NM user libraries can be
in use simultaneously, the
userfname parameter is required when the
logical file selector
logsel is 'USER' .
If
userfname is not fully qualified, the program file's group and account
are used to fully qualify the file name.
Examples
$nmdebug > wl stolog(104c)
PROG $42.104c
By default, the logical selector 'PROG' is used to convert short pointer 104c to the logical
code pointer PROG 42.104c.
$nmdebug > wl stolog(20b34, 'sys')
SYS $a.20b34
The logical selector 'SYS' is used to look up the SID for NL.PUB.SYS, and the resulting
logical code pointer is SYS a.20b34.
$nmdebug > wl stolog(1c68, 'user')
Missing required user library filename for USER logical selector.
When the logical selector 'USER' is specified, the parameter
userfname is required to
specify which user library file, since several may be loaded simultaneously.
$nmdebug > wl stolog(1c68, 'user', 'LIB3')
USER $3c.1c68
The SID for user library is determined to be $3c. The short pointer is converted into logical
code pointer USER 3c.1c68.
Limitations, Restrictions
none
func str
Returns a substring of a source string.