/DIAGNOSE command SNAP function
The /DIAGNOSE command SNAP function provides a non-intrusive alternative to creating a console dump. Use of this command can decrease the time that is required to generate problem determination data for IBM® Software Support.
The /DIAGNOSE command SNAP function takes a current
snapshot of system resources at any time without negatively impacting IMS. This system resource information is displayed on the issuing LTERM.
Optionally, the resource information can be sent to one of the following data sets:
- Online data set (OLDS)
- SYSOUT data set
- Trace data sets (as type X'6701' log records)
The /DIAGNOSE command SNAP function captures information for the following resources:
- A specific IMS control block. For example, the command /DIAGNOSE SNAP BLOCK(CSCD) captures storage information for the APPC/OTMA SMQ SCD Extension control block.
- One of the following user-defined resources:
- User-defined database
- Communication line
- Logical link
- Logical link path
- Node
- Program
- Transaction
- Logical terminal (LTERM)
- User
- Primary control blocks for a dependent region.
- Any area of storage within the control region address space (by specifying the address of that storage area).
- Prolog information for an IMS load module. The command /DIAGNOSE SNAP MODULE (modname) identifies the entry point address and captures prolog information for the specified IMS module. The prolog information contains the current maintenance level for a module on your system, which can help you to determine whether any maintenance is missing.
- A user-defined shared queues structure. The command /DIAGNOSE SNAP STRUCTURE (structurename) captures storage information for the DFSSQS control block storage for the specified shared queues structure.
You might also use the /DIAGNOSE command SNAP function to:
- Show filtered resource information captured by the SNAP function.
- Specify a limit for the number of lines of formatted SNAP data to display in response to the command.
- Specify the control blocks to be captured by the SNAP function.
The /DIAGNOSE command is a standard type-1 command.