1 :Info: aste:  2022-11-06  aste
  2 
  3 Syntax:  aste  { SEGNO | SEGNAME }  {-control_args}
  4 
  5 
  6 Function: displays an Active Segment Table entry (ASTE), page table,
  7 and trailer information.  These components may be displayed
  8 individually or selected as a group.
  9 
 10 
 11 Arguments:
 12 SEGNO
 13    octal segment number of a segment in the selected process whose
 14    ASTE is to be displayed.
 15 SEGNAME
 16    reference_name of a segment whose ASTE is to be displayed.  It must
 17    be the name of a stack_R segment (where R is a ring number), or a
 18    name defined in the Segment Loading Table (SLT).  For a list of such
 19    ref_names, use the azm request:  slte
 20 
 21 
 22 Control arguments (selecting an aste):
 23 -offset ASTE_OFFSET,
 24 -ofs ASTE_OFFSET
 25    octal offset within sst_seg of the ASTE selected for display.
 26    Other data structures usually refer to this offset as the XXX.astep
 27    element.
 28 -ptw PTW_OFFSET
 29    octal offset within SST, unpaged_page_tables or
 30    int_unpaged_page_tables of a PTW (Page Table Word).  The segment
 31    associated with the Page Table containing that PTW is selected
 32    for display.
 33 
 34 
 35 Control arguments (displayed data):
 36    If no control arguments are given, the aste and page table
 37    information is displayed.
 38 -aste
 39    displays active segment table information for the selected entry.
 40 -page_table, -pt
 41    displays page table information for the selected segment.
 42 -trailer, -tr
 43    displays trailer information describing the selected segment.
 44 -brief, -bf
 45    displays everything but the page table.  This is
 46    equivalent to specifying -aste and -tr.
 47 -long, -lg
 48    displays all components.  This is equivalent to specifying -aste,
 49    -pt and -tr.
 50 
 51 
 52 -brief_header, -bfhe
 53    displays only the segment reference name or path name, segment
 54    number, and ASTE location.
 55 
 56 
 57 Examples:
 58 The following shows display of an ASTE, with its associated page table
 59 and the trailer listing processes which know about this segment.
 60 
 61 azm:  aste hcs_ -long
 62 
 63 ASTE for hcs_ (Seg 161  in Proc 0), at SST|103144.
 64 
 65 103144      0 000000000000 102460000000 037636103630 544045573066
 66 103150      4 011001000040 414100300000 000000000000 000000000000
 67 103154     10 000000000011 000000000000 011424011011 000000000102
 68 
 69 
 70 uid = 544045573066, vtocx 40 on pvtx 1 (dska device 0)
 71 max len 9, 9 recs used, 9 in core, cur len 9
 72 Not updated as used.
 73 Not updated as modified.
 74 Par astep = 103630, Son = 0, brother = 102460
 75 Trailer thread = 37636
 76      Quota (S D) = (0 9)
 77 
 78 Flags: usedf hc_sdw aaon ehs nqsw fmch dnzp ddnp
 79 
 80 
 81 PAGE      PTW       DEVADD    PD COPY   at SST|103160
 82 
 83    0  746760401145   20276                 phu phm phu1
 84    1  747000401045   20277                 phu phu1
 85    2  747460400045   20274                 phu1
 86    3  747500400045   20275                 phu1
 87    4  747520400045   20272                 phu1
 88    5  747540400045   20273                 phu1
 89    6  747560400045   20270                 phu1
 90    7  747720400045   20271                 phu1
 91   10  747740400045   20266                 phu1
 92   11  377012000001    null
 93 ====
 94   17  377012000001    null
 95 
 96 Known as:
 97 317 in Proc 0 DBR 17171450 running   on cpu a  Initializer.SysDaemon.z
 98 
 99 
100 :hcom:
101 /****^  HISTORY COMMENTS:
102   1) change(2022-09-29,GDixon), approve(2023-01-16,MCR10129),
103      audit(2023-02-28,Swenson), install(2023-02-28,MR12.8-1054):
104       A) Add -offset ASTE_OFFSET to display an ASTE at a given offset with
105          sst_seg.
106       B) Add -ptw PTW_OFFSET to display ASTE whose page table contains
107          that PTW.
108       C) Clarify description of the SEGNAME argument.
109       D) Add -brief_header control argument.
110       E) Add an Examples section.
111                                                    END HISTORY COMMENTS */
112