TRANDUMP - Transaction dump codes

The TRANDUMP view shows general information about transaction dump codes for active CICS® systems.

Availability

The TRANDUMP view is available for all managed CICS systems except CICS for Windows.

Access

Issue command:
TRANDUMP [dumpcode]

dumpcode
is a specific or generic transaction dump code. If you omit this parameter, the view includes information about all transaction dump codes within the current context and scope.

Select:
REGION from the OPERATE menu, and TRANDUMP from the REGION submenu.
Hyperlink from:
the Trandumps or Trandumps Sup field of the CICSRGN2 view.

Figure 99 is an example of the TRANDUMP view.

Figure 99. The TRANDUMP view
 27FEB2005  16:20:25 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =TRANDUMP==========EYUPLX01=EYUPLX01=27FEB2005==16:20:25====CPSM==========1
 CMD Dump CICS     Tran Sys  Curr   Max    Tran   Tran   Sys    Sysdmp Shut
 --- Code System-- Dump Dump Dumps- Dumps- Dumps- Suprsd Dumps- Suprsd Down
     EYU1 EYUMAS1A YES  NO        1    999      1      0      0      1 NO
 

Action commands

Table 202 shows the action commands you can issue from the TRANDUMP view. The overtype fields are shown in Table 203.

Table 202. TRANDUMP view action commands
Primary command Line command Description
CREate n/a Displays the CICS TRANSACTION DUMP CREATE input panel (Figure 100), which lets you create a new transaction dump code.
INItialize
dumpcode sysname
INI Initializes the number of dump calls for a transaction dump code to 0.
REMove
dumpcode sysname
REM Removes a dump code from the transaction dump code table in each CICS system where the dump code is listed.
n/a SET Sets a transaction dump attribute according to the new value you specify in an overtype field (see Table 203).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
Where:
dumpcode
Is a specific transaction dump code. dumpcode cannot be a generic value because CICSPlex SM considers the asterisk (*) and plus sign (+) to be valid characters in a dump code.
sysname
Is the specific or generic name of a CICS system.

Table 203. TRANDUMP view overtype fields
Field name Values
Tran Dump YES | NO
Sys Dump YES | NO
Max Dumps 0-999
Shut Down YES | NO

When you issue the CREATE action command from the TRANDUMP view, the CICS TRANSACTION DUMP CREATE input panel appears, as shown in Figure 100.

Figure 100. The CICS TRANSACTION DUMP CREATE input panel
 ---------------------- CICS TRANSACTION DUMP CREATE ---------------------------
 COMMAND  ===>
 
 Specify the transaction dump code and options desired:
 
  Scope            ===> EYUCSG01       CICS System or Group for Dump
 
  Trans dump code  ===>                4-character Transaction Dump Code
 
  Maximum dumps    ===> 0              0 - 999
 
  Shut option      ===>                SHUTDOWN or NOSHUTDOWN
 
  Trans dumping    ===>                TRANDUMP or NOTRANDUMP
 
  System dumping   ===>                SYSDUMP or NOSYSDUMP
 
Press Enter to add transaction dump code.                               .
Type END or CANCEL to terminate without adding.

To create a transaction dump code, specify the scope, the code, the maximum number of dumps allowed, whether or not you want a CICS system to shut down if it gets an error related to this code, and whether or not you want CICSPlex SM to take a transaction or system dump following an occurrence of this dump code. When you issue the END command, the Information Display panel reappears.

Hyperlinks

Table 204 shows the hyperlink field on the TRANDUMP view.

Table 204. TRANDUMP view hyperlink field
Hyperlink field View displayed Description
Dump Code TRANDUMD Detailed view of the specified transaction dump code.
Note:
You can also display the TRANDUMS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]