OLIST
Syntax
The parameters are defined as follows:
Parameter | Description |
|---|---|
@ | specifies your own address space |
asi | address space instance; see Identifying-address-spaces for more information |
symbol | symbolic name assigned by the OLIST service to all memory objects owned by an address space The symbolic names begin with MOBJ, followed by a four-digit decimal. You can reference the memory object by its symbolic name and use the symbol in expressions. |
ALL | all memory objects owned by all address spaces |
DATE | (optional) time and date that the memory objects were created (default) |
TOKEN | (optional) causes the user tokens associated with the memory objects to be displayed instead of the time and date |
Examples
To display a list of the memory objects in or associated with address space X00AB and the time and date that the objects were created, type
OLIST,(X00AB)
AMTVX0I MVQAZPAS.P82A (X00AB)
[1] [2] [3] [4] [5] [6] [7]
AMTVX1I MOBJ Origin Size Guard Key Owner Created
AMTVX3I ---- ----------------- ------ ------ --- ------- -----------------
AMTVX4I 0001 00000001_00100000 9M 1M< 8 6FBA90 7:06 9/10/2003
AMTVX4I 0002 00000001_00A00000 9M 1M> 8 6FBA90 7:06 9/10/2003
AMTVX4I 0003 00000001_01500000 9M 1M< 8 6FBA90 7:06 9/10/2003
AMTVX4I 0004 00000001_01E00000 9M 1M> 8 6FBA90 7:06 9/10/2003
To display a list of the memory objects in job name MVQAZPAS and the user token for each object, type
OLIST,MVQAZPAS,TOKEN
AMTVX0I MVQAZPAS.P82A (X00AB)
[1] [2] [3] [4] [5] [6] [8]
AMTVX2I MOBJ Origin Size Guard Key Owner Token
AMTVX3I ---- ----------------- ------ ------ --- ------- -----------------
AMTVX4I 0001 00000001_00100000 9M 1M< 8 6FBA90 00000001_00000000
AMTVX4I 0002 00000001_00A00000 9M 1M> 8 6FBA90 00000001_00000000
AMTVX4I 0003 00000001_01500000 9M 1M< 8 6FBA90 00000002_00000000
AMTVX4I 0004 00000001_01E00000 9M 1M> 8 6FBA90 00000002_00000000
To display detailed information for a specific memory object, type
OL,MOBJ0002
AMTVX5I MOBJ0002 Owned by TCB 6B89B0 in MVQAZPAS.P82A (X00AB) GL=HIGH
[3]
AMTVX6I Store: Bgn 00000001_08000000, End 00000001_0FDFFFFF, Size= 126M
AMTVX7I Guard: Bgn 00000001_0FE00000, End 00000001_0FFFFFFF, Size= 2M
[5]
AMTVX8I Key 8, Fetch Protected [8]
AMTVX9I Alloc at 10:19:01.08 on 10/04/2004, Token=00000000_18460400
To display all of the memory objects owned by all address spaces, type
OLIST,ALL
[1] [2] [3] [4] [5] [6] [7]
AMTVX2I MOBJ Origin Size Guard Key Owner Created
AMTVX3I ---- ----------------- ------ ------ --- ------- -----------------
AMTVX4I 0001 00000001_01E00000 6114M 30M< 0p 7FD230 23:05 3/25/2005
AMTVX4I 0002 00000003_01E00000 4066M 2078M< 0p 7FD230 23:05 3/25/2005
AMTVX4I 0003 00000004_00000000 2029M 0M 0p 7FD230 23:05 3/25/2005
AMTVX0I BMVDWP5 (X0042)
AMTVX1I MOBJ Origin Size Guard key Owner Created
AMTVX3I ---- ----------------- ------ ------ --- ------- -----------------
AMTVX4I 0004 00000200_00000000 128M 0M 4p Shared 9:56 3/26/2005
AMTVX0I BMVDWP6 (X0105)
AMTVX1I MOBJ Origin Size Guard key Owner Created
AMTVX3I ---- ----------------- ------ ------ --- ------- -----------------
AMTVX4I 0004 00000200_00000000 128M 0M 4p Shared 9:56 3/26/2005
AMTVX4I 0005 00000001_00000000 127M 1M> 0p 7DF400 17:29 3/26/2005
AMTVX4I 0006 00000001_08200000 126M 2M< 0p 7DF400 17:29 3/26/2005
Legend:
a sequential number assigned by the OLIST service
The OLIST service creates a symbolic definition for each memory object, in the form MOBJ nnnn. Symbols can be used with the DUMP, EQUATE, and ZAP services. For more details, see Symbolic references.
the lowest accessible virtual address for the memory object
If the memory object contains guard segments at the beginning of the object (GUARDLOC=LOW), then ORIGIN is the address of the first segment after the guard segments.
- the total size of the accessible segments (total segments minus guard segments) within the memory object
the size of the guard segments, if any
The size is followed by a less than sign (<) or a greater than sign (>) to denote the location of the guard segments (low or high end of the object).
- the storage key for the memory object
for private memory objects, the TCB address for the task that owns the memory object
The memory object will be detached by the Recovery/Termination Manager automatically when the task terminates. The word Shared indicates that the memory object is a shared memory object.
time and date that the memory object was created
The format is hh:mm for the time and mm/dd/yyyy for the date.
- the user token associated with the memory object when it was created
the guard location (high or low)
This value is present even if there are no guard segments.
the job name and Started Task ID ( jobName.stid)
This value is displayed when the address space contains a Started Task and the Started Task ID is other than the job name ; in all other cases, only the job name is displayed.
- the address space identifier (ASID) expressed in hexadecimal
Symbolic references
The OLIST service generates a symbolic reference for each memory object. You can display a list of the generated names and the associated storage addresses by executing the DUMP service without any operands. Here is an example:
DUMP
AMTC1GI MOBJ0001 00000001_00100000
AMTC1GI MOBJ0002 00000001_00A00000
AMTC1GI MOBJ0003 00000001_01500000
AMTC1GI MOBJ0004 00000001_01E00000
You can subsequently use these symbolic names to display the storage; for example:
DU,MOBJ0001+60!
AMTC1ZI 00000001_00008000 KEY= 8P BMVDWP4 (ASID 202)
AMTC12I 00008000 C1C2C3C4 40404040 D4D6C2D1 4EF6F040 *ABCD MOBJ+60 *
AMTC12I 00008010 606E40D4 D6C2D14E F8F0F0F0 40404040 *-> MOBJ+8000 *
AMTC12I 00008020 00000000 00000000 00000000 00000000 *................*
AMTC12I 00008030 00000000 00000000 00000000 00000000 *................*