HP 3000 Manuals

System Debug Reference Manual

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
                 '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

MPE/iX 5.0 Documentation