Calling Dump Core *CALL,DC

Function

Use *CALL,DC,OUT to invoke the dump core (DC) DSP. Also you can specify the device that will receive the dump core output.

Syntax

                     .-,--OUT--=--(--PRT--)----------------.   
>>-+-*CALL-+--,--DC--+-------------------------------------+---->
   '-*X----'         '-,--OUT--=--+-CON------------------+-'   
                                  +-devname--------------+     
                                  +-+---+--devnum--------+     
                                  | '-/-'                |     
                                  +-(--type--)-----------+     
                                  +-(--type--,--group--)-+     
                                  '-(--,--group--)-------'     

>--+---------------------+-------------------------------------><
   '-,--KEY--=--password-'   

Parameters

OUT=

Specifies the device that will receive output when either the OPTION= or PTRAP parameter is specified on the *S,DC command. If OUT= is not specified, the first available local printer is selected. You can select the destination for the dump core output by specifying:

devnum or /devnum

Specifies a 3-digit or 4-digit hexadecimal device number. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd dddd /ddd /dddd

where ddd and dddd represent the device numbers.

devname

Specifies the name of the device as defined by the JNAME keyword of a DEVICE initialization statement.

type

Specifies the type of printer. If you specify PRT, JES3 uses any available printer. Otherwise, specify PRT1403, PRT3211, PRT3203, PRT3800, or PRT3820.

group

Is the name assigned to a group of devices (typically in physical proximity), as defined by the DGROUP keyword on the DEVICE initialization statement.

CON

Specifies that output is to be directed to the calling console. Output from all other dump core requests is directed to the calling console only.

KEY=password

Specifies the password that permits the setting of traps, and the use of the storage-altering capabilities of DC. To use any trap, storage-displaying, or storage-altering capability of the DC DSP, you must specify a password when calling DC.

Examples

Dump Core Command:

*CALL,DC,OUT=CON,KEY=SYSTEM

This command will display the output from dump core on the console where the commands are issued.

System Response: