ASDNUMBER (Actual Segment Descriptor Number)

The ASDNUMBER command prints out information about ASDs.

Syntax

── ASDnumber ─┬─────────────────────────────┬──────────────────────────►
              ├─<NUMBER>─┬──────────────────┤
              │          ├─ UNTIL <NUMBER> ─┤
              │          └─ FOR <NUMBER> ───┤
              └─ STACK ──<NUMBER>───────────┘
►─┬────────────────────────────────┬───────────────────────────────────┤
  │ ┌◄───────────────────────────┐ │
  └─┴─┬─ /1\ ──<output format>─┬─┴─┘
      ├─ /1\ ──<ASD filters>───┤
      └─ /1\ ── USAGE ─────────┘

<output format>

►─┬──────────┬─────────────────────────────────────────────────────────┤
  ├─ EXPAND ─┤
  └─ RAW ────┘

<ASD filters>

──┬─────────────────────────────────────────────────────────────┬──────┤
  │ ┌◄───────────────────────────────────────────────┐          │
  └─┴─┬─ /1\ ── ABSENT ────────────────────────────┬─┴──────────┘
      ├─ /1\ ── PRESENT ───────────────────────────┤
      ├─ /1\ ── AVAIL ─────────────────────────────┤
      ├─ /1\ ── INUSE ─────────────────────────────┤
      ├─ /1\ ── LOCKED ────────────────────────────┤
      ├─ /1\ ── SENSITIVE ─────────────────────────┤
      ├─ /1\ ── VIRGIN ────────────────────────────┤
      ├─ /1\ ── OLAY ──────────────────────────────┤
      ├─ /1\ ── SPACEUSAGE <spaceusage field> ─────┤
      └─ /1\ ── MASK ──────────────────────────────┘

Explanation

The following text describes the meaning of each variable. Refer to “Basic Constructs” earlier in this section for information about the <number> construct.

ASDNUMBER

Produces the ODT ASD display corresponding to the data collected at the time of the dump.

ASDNUMBER <number>

Prints out ASD1 through ASD4 for the specified ASD number.

ASDNUMBER <number> UNTIL <number>

Prints out ASD1 through ASD4 for the specified range of ASDs.

ASDNUMBER <number> FOR <number>

Prints out ASD1 through ASD4 for the number of ASDs specified starting at the designated ASD number.

ASDNUMBER STACK <number>

Prints a list of the ASDs contained in the specified stack.

ASDNUMBER EXPAND

The EXPAND option causes all fields within the various ASD table words to be presented. The EXPAND option is set by default, that is, the commands (as shown below) are functionally equivalent.

ASD 1234
ASD 1234 EXPAND

ASDNUMBER RAW

The use of the RAW option overrides EXPAND (the default) and causes the selected ASD table entries to be presented in their raw (or in their unEXPANDed) form.

ASDNUMBER USAGE

Analyzes the entire ASD table and produces a summary table displaying the distribution of ASDs by space usage.

ASDNUMBER <asd number> USAGE

The segment for the ASD is scanned recursively to count the number of ASDs contained below this root ASD.

ASDNUMBER <asd number range> USAGE

The ASD USAGE tabular report is created, but only for the ASDs in the range.

ASDNUMBER STACK <number> USAGE

The ASD USAGE tabular report is created, but the ASDs considered are found by searching the ASD table for a match with the owner stack.

ASDNUMBER <output format>

The optional <output format> specifies whether the ASD information has to be expanded or not. The range of ASD entries is printed if an output format of RAW or EXPAND is used. The default output format is EXPAND.

ASDNUMBER <ASD filters>

If one or more ASD filters is specified, then only those ASDs for the specified ASD range or owner stack number that meet the filter criteria are printed and/or summarized. The following are the ASD filters:

ASD filters

Description

AVAIL

ASD entries that have an AVAIL ASD1 TAG

INUSE

ASD entries that have an INUSE ASD1 TAG

PRESENT

ASD entries with segments present in memory

ABSENT

ASD entries with segments absent from memory

LOCKED

ASD entries that are LOCKED or BUSY

SENSITIVE

ASD entries that are marked as SENSITIVE

VIRGIN

ASD entries that are marked as VIRGIN

OLAY

ASD entries that have data OVERLAID to disk. These entries are INUSE and ABSENT; however, an ABSENT entry is not necessarily overlaid.

SPACEUSAGE <spaceusage field>

ASD entries that have the specified SPACEUSAGE.

MASK

ASD entries with ASD4 that match the current global MASK and PATTERN setting

Example 1

The following example shows the output from the ASDNUMBER command.

Notes:
  • The TBIT_RCWS entry exists only on a DIAGNOSTIC MCP.

  • The ASD LOCK STACK entry exists only on an ASDDIAGNOSTICS MCP.

INPUT: ASDNUMBER 6E949 FOR 2 
ASD1[006E949]:[00001BA524]   8 660026 D259E8  
      ASD1_SEGTYPEF            =  1  (E-MODE OR BYTE MEMORY) 
   ASD1_PRESENTTOPROCF      =  1      
   ASD1_CODESEGMENTHALTF    =  0  
   ASD1_NOTSTACKF           =  1  
   ASD1_ADDRESSVALIDF       =  1
   ASD1_READONLYF           =  0 
   ASD1_ADDRESSF            =  0026D259E8  
ASD2[006E949]:[00001BA525]   8 000000 00003C  
   ASD2_DONTRESIZEF      =  0      
   ASD2_VIRGINASDF       =  0                  
   ASD2_NIBBLE_EXCESSF   =  0                 
   ASD2_WORD_DEFICIENCYF =  0000   (0)         
   ASD2_SPACEUSAGEF      =  00  (NORMALAREA)
   ASD2_LENGTHF          =  0003C  (60)  
ASD3[006E949]:[00001BA526]   D 900052 1019AF 
   INDEX                 = 00521  (1313)   
   ASDINDEX              = 000CD7C    
ASD4[006E949]:[00001BA527]   0 000000 A00250
   ASD4_LINKASDINDEXF       =  0000000 
   ASD4_OLAYSTATEF          =  5 (PRESENT OVERLAYABLE SEG)
   ASD4_POOLOBJECTF         =  1 
     POOL LINKA WORD        =    3 006E94 901190, OFFSET  = 4496 
     POOL LINKB WORD        =    3 000000 00003E, COREADJ = 62 
     POOLAREA ASD           =  006568A 
   ASD4_HOLDALLPBITSF       =  0       
   ASD4_OWNERSTACKF         =  00012
   ASD4_MARKEDFORWSSHERIFFF =  0
   ASD4_UNLOCKDISPOSALF     =  0 
   ASD4_LOCKBITF            =  0 
 TBIT_RCWS[006E949]:   0 055D4F 931532   
   DIAG STKNR               =  0055D 
   DIAG SDI:PWI:PSI         =  1532:0F93:2  (04298216/37891080) GET
ASD LOCK STACK              =  0055D 
ASD1[006E94A]:[00001BA528]   B 000000 0670E2  
   NEXT AVAILABLE ASD  =  00670E2   
ASD2[006E94A]:[00001BA529]   B 000000 000005 
   ASD2_DONTRESIZEF      =  0
   ASD2_VIRGINASDF       =  0
   ASD2_NIBBLE_EXCESSF   =  0
   ASD2_WORD_DEFICIENCYF =  0000   (0)
   ASD2_SPACEUSAGEF      =  00  (NORMALAREA)
   ASD2_LENGTHF          =  00005  (5)
ASD3[006E94A]:[00001BA52A]   B 006804 431026   
   DEALLOCATED @ 1026:0443:0 (24524860/24534200/24584050) BLOCKEXIT 
ASD4[006E94A]:[00001BA52B]   B 000000 800D11 
   ASD4_LINKASDINDEXF       =  0000000  
   ASD4_OLAYSTATEF          =  4 (UNINIT OVERLAYABLE SEG)
   ASD4_POOLOBJECTF         =  1 
   ASD4_HOLDALLPBITSF       =  0
   ASD4_OWNERSTACKF         =  00068   
   ASD4_MARKEDFORWSSHERIFFF =  0 
   ASD4_UNLOCKDISPOSALF     =  0
   ASD4_LOCKBITF            =  1
TBIT_RCWS[006E94A]:   0 1F9C4F 931532
   DIAG STKNR               =  01F9C   
   DIAG SDI:PWI:PSI         =  1532:0F93:2  (04298216/37891080)
                                                         GETHEADER
ASD LOCK STACK              =  01F9C            

Example 2

The following example shows the output from various ASDNUMBER USAGE commands.

INPUT: ASD USAGE 
                             ASD 0000001 thru 006F54E Usage Summary
                             --------------------------------------------
             Addr Valid   Kwords    PoolObj    Kwords     No Mem   Kwords  
          ----------------------------------------------------------------
 NORMALAREA    266,116     47,673    255,221    21,681    13,065    2,848 
 FIBMARK         1,417        153      1,417       153         0        0 
 SEGDOPE           617         25        613         6         0        0
 SEGSEG          1,321      9,978         20         3         0        0
 TABMARK           960        161        950       159         0        0
 DOPEVECT        9,140      1,729      8,018       306         0        0
 IOCBAREA        2,245        132      1,197        71         0        0
 DIRECTIOBUFF    3,044      9,587      1,543       513         0        0 
 EVENTAR           618        252        585        54         0        0
 DIRECTIOBUFFTOBE    0          0          0         0       239      299
 STACKMARK         839      2,027        194        67         0        0 
 POOLAREA        4,049      1,046          0         0         0        0 
 SIBMARK            19          2          0         0         0        0
 PIBMARK           868        203        858       200         0        0
 BUFFERHEADER      534          6        534         6         0        0
 STRUCTUREDAREA  9,289      1,297      9,165     1,289         0        0
 SUBSPACE_ARRAY  6,158     12,168          0         0         0        0
 MESSAGEAREA     2,524         82      2,520        82    10,361       34
 IOCDAREA        3,041        283      3,041       283         0        0
 CODEAREA       15,968      6,271     14,550     2,463    29,771    5,491
 INSTACKAREA       227          3          0         0         0        0
 ICMMARK           111          3        111         3         0        0
 IOBUFFER          482      1,021          0         0         0        0
 EVENTCONTAINERAR  692         69        681        58         0        0
 DOPEOREVENTAREA 1,453         60        359        15         0        0
 EVENTSEG           10         80          0         0         0        0
 RESERVEAREA        16          9          0         0         0        0
 EVENTMESSAGEAREA   18          1          5         1         0        0
 IOCBMESSAGEAREA   310         19        279        17         0        0
 MCBAREA         3,294        490          0         0         0        0
 EVSTATEAREA    25,814        328     25,610       326         0        0 
               ----------------------------------------------------------
 Totals        365,125     97,826    329,722    28,381    53,436    8,671

Present
  Save segments      119,424     48,153     90,418     7,389 
  Overlayable        245,701     49,674    239,304    20,992    
                 -------------------------------------------    
                     365,125     97,826    329,722    28,381   
 No Memory                                     
  Uninit overlay         641        371        567       121      
  OS=0/Virgin         52,795      8,301        213       104 
                 -------------------------------------------       
                      53,436      8,671        780       224
 AvailabLe ASDs                                                 
  Deallocated          5,292            
  Reserved            32,161            
                 -----------           
                      37,453               
 ASDs Examined       456,014 of   2,742,026 ( 16.63 %) 
 PoolObject ASDs     329,722 of     365,125 ( 90.30 %)      
 PoolObject KW        28,381 of      97,826 ( 29.01 %)     
 Area Reduction       35,403 vs     361,076 ( 90.20 %)     
 PoolObject/Area       81.43 in       4,049 PoolAreas