You can request allocated
storage information by coding the SPACE=ALLOC
parameter of the VSMLIST macro. The format of the output varies according
to what you specify for the SP parameter.
If you specify SP=SQA,
SP=CSA, or SP=LSQA, the output consists
of the allocated storage information for the subpools in the specified
area. The subpools listed in each of these areas are:
- SQA:
226, 239, 245, 247, 248
- CSA: 227, 228, 231, 241
- LSQA:
205, 215, 225, 255
Figure 1 shows
the output the system produces when you
issue the VSMLIST macro with SP=CSA or SP=SQA specified.
If
you specify SP=PVT, the output consists of the allocated storage
information for subpools in the private area according to the owning
TCB. These subpools are 0-127, 129-132, 229, 230, 236, 237, 244, 249,
251, and 252.
Figure 4 shows the
format of the allocated storage information
for the private area.
If you specify a subpool list, the output
consists of the allocated
storage information for each of the subpools in the list. Figure 5 shows the format of the allocated storage
information
for a subpool list request.
See the following figures for the
format that the system uses to
provide allocated storage information.
- For the format of the
work area that VSMLIST produces when you
specify SP=LSQA, SP=CSA, or SP=SQA, see Figure 1
- For the format of the subpool descriptor, see Figure 2
- For the format of the allocated
block descriptor, see Figure 3
- For
the format of the allocated storage information for the private
area, see Figure 4
- For the format
of the allocated storage information for a subpool
list, see Figure 5
- For the format
of free space information ,see Figure 1
- For the
format of the free space descriptor, see Figure 2
- For the
format of unallocated storage information for CSA and
PVT subpools, see Figure 1
- For the format of the region descriptor, see Figure 2
- For the format of the unallocated block descriptor, see Figure 3
Figure 1. Allocated Storage Information
for Subpools in a Specified AreaThis figure describes the work area that VSMLIST produces
when
you use SP=LSQA, SP=CSA, or SP=SQA. If you also specify SPACE=FREE,
each allocated block descriptor is followed by free space information.
If you specify SPACE=ALLOC, VSMLIST omits free space information.
Figure 2. Format
of Subpool Descriptor- Byte
- Content
- 0
- X‘00’ to identify a subpool
descriptor
- 1
- Length of
subpool descriptor
- 2
- Subpool
ID
- 3
- Miscellaneous flags
and storage key as follows:
- Bit
- Meaning
When Set
- 0-3
- Storage
key
- 4
- The TCB with which
this descriptor is associated owns the storage
described by this descriptor
-
- This
is meaningful for private area storage only.
- 5
- The storage described by this descriptor is shared. This is
meaningful for private area storage only.
- 6-7
- Reserved
- 4-7
- Owning TCB address (if PVT subpool), otherwise zero.
Figure 3. Format of Allocated
Block Descriptor- Byte
- Content
- 0-3
- The virtual address of
the allocated block
- Bit
- Meaning When
Set
- 0
- The caller specified
the REAL31 option and this allocated block
could be backed in central storage above (bit 0=1) or below (bit 0=0)
16 megabytes when the storage is fixed.
- 30
- The caller specified the REALPGFMSZ option
and this storage
can be backed in central storage by 1 megabyte pages (bit 30=1) or
by 4K pages (bit 30=0) when the storage is fixed.
- 31
- The caller specified the REAL64 option
and this allocated block
could be backed in central storage above (bit 31=1) or below (bit
31=0) 2 gigabytes when the storage is fixed.
- 4-7
- The length of the allocated
block
Figure 4. Allocated
Storage Information for the Private AreaThis figure describes
the work area that VSMLIST produces when
you use SP=PVT.
Note: - The number of subpools in the private
area is a 31-bit number.
- The address of the TCB is contained
in a fullword.
- Figure 1 shows the
format of the allocated storage
information for the subpools owned by each TCB. The storage information
begins at offset 0, “number of subpools” in that figure.
- If
you specify SPACE=FREE, free space information follows each
allocated block descriptor. Figure 1 describes the
format
of the free space information.
Figure 5. Allocated Storage Information for
a Subpool List