VERBEXIT LEDATA subcommand — format Language Environment data
There is one version of the LEDATA subcommand for AMODE 31/24 format,
and another for AMODE 64 format. For the latest version of each IPCS
LEDATA subcommand, see the following topics:
- For AMODE 31/24 format, see the topics about Formatting and analyzing system dumps and Understanding Language Environment® IPCS VERBEXIT LEDATA AMODE 31/24 in z/OS Language Environment Debugging Guide.
- For AMODE 64 format, see the topics about Formatting and analyzing system dumps and Understanding Language Environment IPCS VERBEXIT LEDATA AMODE 64 in z/OS Language Environment Debugging Guide.
Specify the LEDATA verb name and optional parameters on the VERBEXIT
subcommand to format diagnostic data for the Language Environment component
of z/OS.
LEDATA displays the following:
- A summary of the Language Environment at the time of the dump
- Runtime options
- Storage management control blocks
- Condition management control blocks
- Message handler control blocks
- C Runtime Library control blocks
- Syntax
VERBEXIT LEDATA [ 'parameter [,parameter]...' ] The parameters are: Report type parameters: [SUMMARY] [HEAP | STACK | SM] [HPT(value)] [CM] [MH] [CEEDUMP] [COMP(value)] [PTBL(value)] [ALL] Data selection parameters: [DETAIL | EXCEPTION] Control block selection parameters: [CAA(caa-address)] [DSA(dsa-address)] [TCB(tcb-address)] [ASID(address-space-ID)] [NTHREADS(value)]
- Report Type Parameters Use these parameters to select the type of report. You can specify as many reports as you want. If you omit the parameters, the default is SUMMARY.
- SUMmary
- Specifies a summary of the Language Environment at the
time of the dump. The following information is included:
- TCB address
- Address space identifier
- Language Environment release
- Active members
- Formatted CAA, PCB, RCB, EDB, and PMCB
- Runtime options in effect.
- HEAP | STACK | SM
- HEAP
- Specifies a report on Storage Management control blocks pertaining to HEAP storage.
- STACK
- Specifies a report on Storage Management control blocks pertaining to STACK storage.
- SM
- Specifies a report on Storage Management control blocks. This is the same as specifying both HEAP and STACK.
- HPT(value)
- Specifies the heappools trace (if available) be formatted. If the value is 0 or *, the trace for every heappools poolid is formatted. If the value is a single number (1-12), the trace for the specific heappools poolid is formatted. If the HPT keyword is specified with no value, the HPT value defaults to 0.
- CM
- Specifies a report on Condition Management control blocks.
- MH
- Specifies a report on Message Handler control blocks.
- CEEdump
- Specifies a CEEDUMP-like report. Currently this includes the traceback, the Language Environment trace, and thread synchronization control blocks at process, enclave, and thread levels.
- COMP(value)
- Specifies component control blocks to be formatted, where value is
one of the following options:
- C
- Specifies a report on C/C++ Run-Time Control Blocks.
- CIO
- Specifies a report on C/C++ I/O Control Blocks.
- COBOL
- Specifies a report on COBOL-specific Control Blocks.
- PLI
- Specifies a report on PL/I-specific Control Blocks.
- ALL
- Request a report on all the control blocks. If the value specified in COMP is not valid, the COMP value defaults to ALL.
Note: When LEDATA report type ALL is specified, the COMP value defaults to ALL. - PTBL(value)
- Specifies the PreInit tables to be formatted, where value is
one of the following options:
- CURRENT
- The PreInit table associated with the current or specified TCB is displayed.Note that when report type ALL is specified, the PTBL value defaults to CURRENT.
- address
- The PreInit table at the specified address is displayed.
- *
- All active and dormant PreInit tables within the current address space are displayed. This option is time consuming.
- ACTIVE
- The PreInit tables of all TCBs in the address space are displayed.
- ALL
- Specifies all above reports, in addition to a report on C Runtime Library.
- Data Selection Parameters Use these parameters to limit the scope of the data in the report. If no data selection parameter is selected, the default is DETAIL.
- DETAIL
- Specifies the formatting of all control blocks for the selected components. Only significant fields in each control block are formatted.
- EXCEPTION
- Specifies validating all control blocks for the selected components.
The output produced names only the control block and its address
for the first control block in a chain that is not valid. Validation
consists of control block header verification at the very least. Note: For the Summary, CEEDUMP, and C Runtime Library reports, only the DETAIL output is available.
- Control Block Selection Parameters Use these parameters to select the CAA and DSA control blocks used as the starting points for formatting.
- CAA(caa-address)
- Specifies the address of the CAA. If not specified, the CAA address is obtained from the TCB.
- DSA(dsa-address)
- Specifies the address of the DSA. If not specified, the DSA address is assumed to be the general purpose register (GPR) 13 value for the TCB.
- TCB(tcb-address)
- Specifies the address of the TCB. If not specified, the TCB address of the current TCB from the CVT is used.
- ASID(address-space-ID)
- Specifies the hexadecimal address space ID. If not specified, the IPCS default address space ID is used. This parameter is not needed when the dump only has one address space.
- NTHREADS(value)
- Specifies the number of TCBs for which the traceback will be displayed. If NTHREADS is not specified, value will default to (1). If value is specified as asterisk (*), all TCBs will be displayed.
- Example: For an example of the LEDATA output, see z/OS Language Environment Debugging Guide.