INQUIRE MVSTCB

Retrieve addresses and storage usage information for MVS TCBs.

Read syntax diagramSkip visual syntax diagramINQUIRE MVSTCB
 
                              .----------------------------.
                              V                            |
>>-INQUIRE MVSTCB(data-area)----+------------------------+-+---><
                                +-NUMELEMENTS(data-area)-+
                                +-ELEMENTLIST(ptr-ref)---+
                                +-LENGTHLIST(ptr-ref)----+
                                '-SUBPOOLLIST(ptr-ref)---'
 

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

This command is threadsafe.

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE MVSTCB command returns the address and storage usage information for the MVS TCB.

Browsing

This command can only be used in browse mode.

Options

ELEMENTLIST(ptr-ref)
returns the address of a list of the addresses of all areas of private storage owned by this TCB. The number of addresses in this list is the NUMELEMENTS option value.

CICS obtains the storage for this list and frees it when the inquiring task ends, or issues another INQUIRE MVSTCB command with the NUMELEMENTS option. The task cannot free the storage itself.

LENGTHLIST(ptr-ref)
returns the address of a list of fullword binary lengths. Each entry in this list is the length of the storage area to which the corresponding entry in the ELEMENTLIST list points.

CICS obtains the storage for this list and frees it when the inquiring task ends, or issues another INQUIRE MVSTCB command with the NUMELEMENTS option. The task cannot free the storage itself.

NUMELEMENTS(data-area)
returns the number of storage elements, in fullword binary form, owned by this TCB, in the data area you provide. If you request an ELEMENTLIST, LENGTHLIST, or SUBPOOLLIST, this value is the number of entries in the list.
MVSTCB(data-area)
returns the address of the MVS TCB in the CICS address space. The TCB address that is returned can be used as input to the EXEC CICS COLLECT STATISTICS MVSTCB command to retrieve the storage and CPU time information for the TCB.
SUBPOOLLIST(ptr-ref)
returns the address of a list of fullword binary subpool numbers. Each entry in this list is the number of the MVS subpool for the corresponding entry in the ELEMENTLIST list.

CICS obtains the storage for this list and frees it when the inquiring task ends, or issues another INQUIRE MVSTCB command with the NUMELEMENTS option. The task cannot free the storage itself.

Conditions

END
RESP2 values:
2
All authorised resources have been retrieved. All data areas specified on this command are left unchanged.
ILLOGIC
RESP2 values:
1
You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
1
The TCB specified on the command was not found.
[[ Contents Previous Page | Next Page Index ]]