func ltolog
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| E0201 Edition 4 ♥ | |
| E0300 Edition 3 | |
| E0692 Edition 3 |
Syntax
ltolog (longptr)
The SID of the long pointer (input parameter) is compared with the SID of each
of the loaded NM executable libraries for a match. If a SID match is found,
then the appropriate logical code pointer is returned.
If the SID does not match any of the loaded NM files, then the long pointer is
tested to see if it points to a NM section of translated CM code produced by
the Object Code Translator (OCT). If the long pointer is found to be translated
code, then a special TRANS logical code pointer is returned.
Refer to appendix C for a discussion of CM object code translation, node
points, and breakpoints in translated CM code.
If both of the previous tests fail, then a special unknown type (UNKN)
is returned.
Formal Declaration
ltolog:lcptr (longptr:lptr)
Parameters
- longptr
The long pointer to be converted into a NM logical code pointer.
Examples
$nmdebug > wl ltolog (a.2034c) SYS $a.2034The SID $a matches the SID for the system library (SYS) NL.PUB.SYS. The long pointer is converted into the logical code pointer SYS a.2034.
$nmdebug > wl ltolog (3c.3208) PROG $3c.3208The SID $3c matches the SID of the program file.
$nmdebug > wl ltolog (20.10264) TRANS $20.10264The SID $20 does not match any of the loaded NM files. A final test is applied, in case the virtual address is in translated CM code. In this example, the address does point to a NM section of translated CM object code (translated by the Object Code Translator).
$nmdebug > wl ltolog (123.45678) UNKN $123.45678The SID $123 does not match any of the loaded NM files and does not point to translated code. The special unknown logical code pointer is returned.
Limitations, Restrictions
none
|
func lpub |
func ltos |