TCBEXIT subcommand — run a TCB exit routine
- Syntax
{ TCBEXIT } { pgmname | * } { TCBX } data-descr [ AMASK(mask) ]
-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.[ FLAG(severity) ] [ PRINT | NOPRINT ] [ TERMINAL | NOTERMINAL ] [ TEST | NOTEST ]
- Parameters
- pgmname or *
- Specifies an IBM-supplied or installation-supplied exit routine,
which processes system control blocks. The pgmname specifies
the name of a routine. * specifies the following IBM-supplied TCB
exit routines; these exit routines are specified by parmlib members
embedded in the BLSCECT parmlib member.
- Exit Routine
- Data Processed
- IECDAFMT
- Data management control blocks
- IECIOFMT
- Input/output supervisor (IOS) and execute channel program (EXCP) control blocks
- IEAVTFMT
- Recovery termination management (RTM) control blocks
- IEAVSSA1
- Vector Facility data file.IEAVSSA1 exit routine
- IEAVXD01
- Access registers
- IEAVD30
- Linkage stack
An installation-supplied TCB exit routine that you can specify must:- Be named with a maximum of 8 characters. The first character must be alphabetic.
- Reside in a library available to IPCS, such as a step library, job library, or link library.
For more information about writing installation TCB exit routines, see z/OS MVS IPCS Customization.
- data-descr
- Specifies the address of the TCB to be passed to the exit routine.
The data description parameter consists of five parts:
- An address (required)
- Address processing parameters (optional)
- An attribute parameter (optional)
- Array parameters (optional)
- A remark parameter (optional)
Data description parameter explains the use and syntax of the data description parameter.
- AMASK(mask)
- Specifies an integer mask that TCBEXIT is to AND to the dump addresses passed by the exit to the storage access and format service routines. The values of the mask can be only X'00FFFFFF' or X'7FFFFFFF' or the corresponding decimal or binary values.
- Return Codes
Code Explanation 12 Severe error, an error condition or user request forced early end to the subcommand processing. 16 Ending error, an error condition from a called service routine forced an early end to the subcommand processing. other An exit generated return code. - Example 1: Invoke an IBM-supplied TCB exit to display RTM-related
control blocks.
- Action
COMMAND ===> tcbexit ieavtfmt 21C.%
- Result
This example invokes the IBM-supplied TCB exit routine (IEAVTFMT) that processes recovery termination management (RTM) control blocks. Using the indirect addressing notation (21C.%), addressability is established to the current TCB.
*** NOT ALL EED'S AVAILABLE COULD BE ACCESSED *** INVALID EED TYPE ENCOUNTERED AT LOCATION 009FF750 EED1: 009FF750 +0000 E2E3D2C5 009FEA68 00000000 00000000 | STKE.þ.......... | +0010 0000001B 00000000 00000000 00000000 | ................ | +0020 00000000 00000000 00000000 00000000 | ................ | +0030 00000000 00000000 00AA0400 00000000 | ................ | +0040 009FBE00 009FAFB0 00000000 00006EF4 | .--..---......>4 | +0050 00000000 00006F40 00000000 00000000 | ......? ........ | +0060 00000000 00000000 00000000 00000000 | ................ | +0070 00000000 00000000 00000000 00000000 | ................ | +0080 00000000 00000000 00000000 00000000 | ................ | +0090 00000000 00000000 00000000 00000000 | ................ | +00A0 00000000 00000000 00000000 00000000 | ................ | +00B0 00000000 00000000 00000000 00000000 | ................ | +00C0 00000000 00000000 00000000 00000000 | ................ | +00D0 00000000 00000000 00000000 00000000 | ................ | +00E0 00000000 00000000 D4E2E3D9 40404040 | ........MSTR | +00F0 D3D3C140 40404040 40404040 40404040 | LLA | +0190 00000000 00000000 00000000 00000000 | ................ |
- Action
- Example 2: Invoke all IBM-supplied TCB exits.
- Action
COMMAND ===> tcbexit * 21C.%
- Result
This example invokes all of the IBM-supplied TCB exit routines to process TCBs and related control blocks. Using the indirect addressing notation (21C.%), addressability is established to the current TCB.
- Action
- Example 3: Invoke an installation-supplied TCB exit.
- Action
COMMAND ===> tcbexit testtcb 715b0.
- Result
This example invokes an installation-supplied routine TESTTCB, passing it the TCB address X'715B0'.
- Action