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:
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.