System Debug Reference Manual (32650-90888)

Chapter 10 445
System Debug Standard Functions
func stolog
Examples
$nmdebug > dr sr4; dr sr5
sr4=$41
sr5=$53
$nmdebug > wl sp
$40163088
$nmdebug > wl stol(sp)
$53.40163088
$nmdebug > wl stol(1cbb8c)
$41.1cbb8c
$nmdebug > wl stol(15f.1cbb8c)
$15f.1cbb8c
Limitations, Restrictions
none
func stolog
Short to logical. Converts a NM short pointer (SPTR) to a NM logical code address (LCPTR).
Syntax
stolog ( shortptr [ logsel ] [ userfname ])
Based on a logical file selector,
logsel , the SID of a loaded NM executable library is used
to build a logical code pointer.
This conversion is very different from the STOL conversion, which uses the current space
registers SR4 - SR7 to determine the SID.
Formal Declaration
stolog:lcptr ( shortptr :sptr [ logsel :str="PROG"] [ userfname :str])
Parameters
shortptr The short pointer to be converted into a logical code pointer.
logsel A string which selects a particular logical file. The SID portion of the
resulting logical pointer are based on the SID of the specified logical file
selector. Valid selector strings are:
'PROG' Program file