LINKS (Memory Links)

The LINKS command prints the addresses and contents of each link of the memory area that contains a specified simple address. The analysis also includes the following memory area attributes, which are encoded in the links:

  • Whether the area is available, save, csave (currently saved), or olay (overlayable)

  • If in-use, whether it is code, data or read-only

  • The area size

  • The area MOM address

  • Whether or not the MOM address for the area is in the MCP D[0] stack and, if the name of that cell is available, the D[0] MOM address name

  • The area stack number

  • If present, the link C RCW

  • The memory priority of the area

  • If the area is available, the RCW trace of FORGETSPACE

Syntax

── LINKS ─┬─<simple address>────┬─┬──────────┬─────────────────────────┤
          └─ VIA ──<ASD number>─┘ └─ EXPAND ─┘

Explanation

The following text explains the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <simple address> and the VIA <ASD number> constructs.

EXPAND

Expands the fields of the associated ASD.

Example 1

The following shows an example of LINKS command output for an in-use area.

INPUT:  LINKS 4000 EXPAND
00003D19   INUSE AREA  DATA: LENGTH=04209(16905)MOM ADDR=000028AD
  (D[0] + 07AD)
ASD1[010D5]:  [000410D9] 5 670000 003DIC
   ASD1 PRESENTTOPROCF       =  1
   ASD1-UNALTEREDF           =  0
   ASD1-NOTSTACKF            =  1
   ASD1-PRESENTFORIOF        =  1
   ASD1-NOTPAGEF             =  1
   ASD1-READONLYF            =  0
   ASD1-DONTRESIZEF          =  0
   ASD1-PAGEDF               =  0
   ASD1-ADDRESSF             =  00003D1C


ASD2[010D5]:  [0006A034] 3 160000 004209
   ASD2 SPACEUSAGEF       =  16  (PERMSAVEAREA)
   ASD2-LENGTHF           =  04209


ASD3[010D5]:  [00092F8F] 1 012000 8407AD
  STACK NUMBER           = 012
  DISPLACEMENT           = 0008
  OFFSET                 = 07AD


ASD4[010D5]:  [000BBEEA] 0 000000 001200
   ASD4 LINKASDINDEXF        =  00000
   ASD4-OLAYSTATEF           =  0 (NON OVERLAYABLE SEG)
   ASD4-OWNERSTACKF          =  012
   ASD4-VIRGINASDF           =  0
   ASD4-MARKEDFORSSHERFFF    =  0
   ASD4-UNLOCKDISPOSALF      =  0
   ASD4-LOCKBITF             =  0


LINK A : [00003D19] 6 E0420D 0010D5
  D[0] MOM ADDRESS NAME = RESCODE MEMORY
  SPACE USAGE            = (PERMSAVEAREA)
  INUSE_SEGSTATEF        =  SAVE AREA
  INUSE_ASDINDEXF        =  010D5
  INUSE_SIZEF            =  00420D  (16909)


LINK C : [00003D1B] 3 000000 000000


LINK Z : [00007F25] 3 E0420D 000000
  INUSE_SIZEF            =  00420D  (16909)

Example 2

The following shows an example of the LINKS command output for an available area. Note that the RCW trace information appears only for dumps created on a system running a DIAGNOSTICS MCP.

'INPUT:  LINK 732DE
007E4209   AVAILABLE AREA   :  LENGTH = 00000016(22)
LINKS: 1 480000 000016  0 000000 D67275   0 000000 000000  0 000000 0000
  00   0 000000 000000  . . . I 400000 000016
    RCW TRACE OF FORGETSPACE - - -
       STACK:  894
         @ 1005:037F:0 (04899700) FORGETSPACE
         @ 100F:00A9:4 (04700750) AMNESIA
         @ 1106:0ACB:1 (20881800) MUTATE
         @ 0248:003E:1
         @ 0247:0198:1
         @ 1297:0103:4 (24565550) BLOCKEXIT
         @ 0247:016D:4
         @ 10EA:06DB:1 (16562000) BOJEOJ