System Debug Reference Manual (32650-90888)

Chapter 5 169
System Debug Command Specifications Fx-LOG
Fmm (freeze)
Syntax
FC logaddr [ bytelength ] Program file
FCG logaddr [ bytelength ] Group library
FCP logaddr [ bytelength ] Account library
FCLG logaddr [ bytelength ] Logon group library
FCLP logaddr [ bytelength ] Logon account library
FCS logaddr [ bytelength ] System library
FCU fname logaddr [ bytelength ] User library
FCA cmabsaddr CM absolute CST
FCAX cmabsaddr CM absolute CST
FDA dstof f CM data segment
FVA virtaddr [ bytelength ] Virtual address
Parameters
logaddr A full logical code address (LCPTR) specifies three necessary items:
• the logical code file (PROG, GRP, SYS, and so on).
• NM: the virtual space ID number (SID).
CM: the logical segment number.
• NM: the virtual byte offset within the space.
CM: the word offset within the code segment.
Logical code addresses can be specified in various levels of detail:
• As a full logical code pointer (LCPTR):
FC procname+20 Procedure name lookups return LCPTRs.
FC pw+4 Predefined ENV variables of type LCPTR.
FC SYS(2.200) Explicit coercion to a LCPTR type.
• As a long pointer (LPTR):
FC 23.2644
sid.offset or seg.offset
The logical file is determined based on the command suffix:
FC implies PROG.
FCG implies GRP.
FCS implies SYS, and so on.
• As a short pointer (SPTR):
FC 1024
offset only
For NM, the short pointer offset is converted to a long pointer using the
function STOLOG, which looks up the SID of the loaded logical file. This
is different from the standard short to long pointer conversion, STOL,
which is based on the current space registers (SRs).