If you invoke VTWRE without operands, the number of WREs queued to all LQABs are counted and the counts are displayed.

Use the DETAIL option to get additional information on each WRE. Also, several operands are available to limit processing to a specific LQAB or to specific WREs.

Operands

Event ID

Enter a 1–100 hexadecimal digit value to be used in matching a WRE event ID found in the dump. The specified event ID is left-aligned when comparing with the contents of the dump. For example, if X'1234' is specified and the dump contained X'F1F0F41234', this would not be a match.

Event ID code

Enter a 4 hexadecimal digit value. If the entered code is fewer than 4 digits, results are unpredictable. Only WREs containing this event ID code are processed. The event ID code identifies the reason for the wait state.

LQAB

Enter a specific LQAB name from the following list to limit processing to a single LQAB. The following LQABs, which are pointed to by the ATCVT, can be examined. The default is ALL.

LQAB name

Description

IOLQB

SSCP I/O LQABs (one per attached subarea)

LUSMQ

Service manager LQAB

MCQAB

Miscellaneous command LQAB

PULQB

Physical unit services LQAB

NODAT_CPWAIT_QUEUE

Network operator services LQAB

SSLQB

Miscellaneous LQAB for session services

SSMQB

Second miscellaneous LQAB for session services

All

All of the above LQABs

If a subarea is specified, the LQAB must be entered as IOLQB. If ALL is specified, all subareas defined to IOLQB by ATCSASUP will be processed.

Subarea

Use this operand to limit processing to the SSCP I/O LQAB for a specific subarea. When a subarea is specified, IOLQB must be specified for the Queue, and Subarea is used as an index into the SSCP I/O LQABs. Specify a 1–8 hexadecimal digit number in the form X'x…' or a number in the range of 1–2 147 483 647. This represents the number of the subarea. See field ATCSASUP in the ATCVT for the maximum number of subareas available in a dump. Subarea 0 is not valid.

Mask

Enter a 1–100 hexadecimal digit mask. The mask is left-aligned and ANDed with the event identifier in the dump to determine whether the specified event identifier was found.

Note: Mask must be used with Event ID.

Max

Enter a number in the range of 1–99 999 (1–5 decimal digits or 1–4 hexadecimal digits) for the maximum number of WREs to be processed for the selected LQABs. The default is 100.

Control op code

Only WREs containing this CPCB op code are eligible for selection. The control op code must be 1–8 hexadecimal digits in the form X'x…'. If the op code is fewer than eight digits, it is left-aligned and compared with the leftmost digits in the dump.

User correlator

Enter a 1–8 character value. Only WREs containing this user request correlator (URC) are processed. The URC is typically the resource name of the target of a request.

Format

Use Format to format the WRE and the EID, if present. With Noformat, which is the default, the WRE and EID are not formatted.

Note: Do not specify Format if you use Detail for Report Data. Format is valid only for Scan.

Report data

Scan, which is the default, counts and displays the number of WREs meeting the specified search criteria. Use Detail to have the following fields extracted and displayed from each selected WRE:

• WRE address
• Control block (RUPE) address
• CPCBOPC
• URC
• Event ID
• Event ID Code

Use the following syntax as an alternative to the panel interface.