Calling the DJ facility to dump jobs or restore jobs *CALL,DJ
Function
To invoke a DJ DSP to dump jobs out to tape use the *CALL,DJ,OUT= command. To invoke a DJ DSP to restore jobs from tape use the *CALL,DJ,IN= command.
Syntax
Parameters
- OUT= or IN=
- Specifies that the job(s) is to be dumped out to tape (OUT=) or
restored from tape to the job queue (IN=). Specify the output device
as follows:
- 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:
where ddd and dddd represent the device numbers.ddd dddd /ddd /dddd - devname
- For SERVER=NO requests, specifies the device name as defined by the JNAME keyword of a DEVICE initialization statement for a JES3 support unit request. This is not applicable for SERVER=YES requests.
- type
- For a SERVER=NO request, specifies the type of device as defined
by the DTYPE keyword of a DEVICE initialization statement for a JES3
support unit request. For a SERVER=YES request, specifies the generic
device type (for example, 3480 or 3490) or esoteric device type (for
example, TAPE) as defined to MVS™ through HCD. Note:
- This is a required keyword on a *CALL,DJ OUT= request.
- For SERVER=NO requests, the type parameter can be omitted for the IN= keyword; JES3 assumes a TA9 tape unit.
- ,group
- For a SERVER=NO request, specifies the name assigned to a group of devices as defined by the DGROUP keyword of a DEVICE initialization statement for a JES3 support unit request. This is not applicable for a SERVER=YES request.
- SERVER=YES or NO
- Specifies whether (YES) or not (NO) a DJ server address space will be started to process the request.
- DSN=dsname
- For server mode (SERVER=YES) input requests, specifies the data
set name that contains the jobs to be restored.
For standard label tapes, the data set name is the one that was created when the jobs were dumped to tape. It has the following format: jesn.DJ.yyyyddd.Thhmmss, where jesn is the JES3 subsystem name.
For unlabeled tapes, the data set name is jesn.DJOUT, where jesn is the JES3 subsystem name. When an unlabeled tape is specified, the VOL= parameter must also be specified.
DSN= is ignored for server mode (SERVER=YES) output requests.
DSN= is not allowed for nonserver mode (SERVER=NO) requests.
DSN= is not allowed for nonserver mode (SERVER=NO) input or output requests.
- VOL=volser or (vollist)
- Specifies the volume serial numbers for server mode (SERVER=YES)
input requests. This parameter is required when restoring jobs from
an unlabeled tape (LABEL=NL). VOL= should also be used if you want
to restore jobs from a specific input volume that is not the first
volume in a multi-volume data set.
VOL= is ignored for server mode (SERVER=YES) output requests.
VOL= is not allowed for nonserver mode (SERVER=NO) requests.
- DEN=den
- Specifies the tape density, where den may be one of the
following:
7-track 9-track Meaning 2 200 bpi 5 500 bpi 8 8 800 bpi (default for 7-track) 16 1600 bpi (default for 9-track) 62 6250 bpi For a TA0 tape device, ignore the DEN= parameter. The TA0 is an 18-track tape device with a density of 32000 bpi.
Seven-track tape density is not allowed for SERVER=YES requests. If you specify DEN=8 with SERVER=YES, JES3 always treats it as a 9-track 800 bpi request.
- IO=
- Specifies whether tape I/O is to be performed.
- YES
- Tape I/O is performed. DJ dumps jobs from the JES3 job queue to tape. (Jobs that are dumped are recorded on the message log data set.)
- NO
- Tape I/O is not performed. DJ makes a pass at jobs on the JES3 job queue without actually dumping them to tape. Specifying IO=NO causes disposition to default to SAVE, regardless of what is specified on the *START,DJ command. (Jobs that would have been dumped are recorded on the message log data set).
- MOD= COMP or NOCOMP
- COMP specifies data compaction for write-to-tape operations to devices that support compaction. NOCOMP specifies that data will not be compacted. Compaction refers to the 3480 improved data recording capability utilizing an IBM® proprietary algorithm.
- NAV=
- Specifies the action DJ is to take if the required tape unit is
not available when requested:
- R
- Reschedule DJ when the tape unit becomes available.
- C
- Cancel DJ.
JES3 always sets the NAV value to NAV=C for SERVER=YES requests.
- OLD
- Specifies that DJ is not to rewind the tape. The tape is assumed to be correctly positioned. The OLD parameter is not allowed for SERVER=YES requests.
- OUTPUT=NC or ALL
- Specifies how the output service reschedules and processes SYSOUT
data sets when jobs are restored from tape.
- NC
- Specifies that when jobs are restored, output service will process only incomplete SYSOUT data sets, those that had not been processed before being dumped to tape. If the operator omits the OUTPUT parameter on a *CALL,DJ,OUT command, JES3 only reprocesses jobs that had not completed processing before being dumped.
- ALL
- Specifies that when jobs are restored, output service will reschedule
and process all SYSOUT data sets for each job. Note: If you specify OUTPUT=ALL, dump job will not dump APPC SYSOUT.
- PASS=password
- Specifies the password to run DJ, if required.
- TRANS=
- Specifies whether translation is to be performed.
Specify TRANS=YES on this parameter only if you are migrating forward or backward between JES3 releases where a cold start is required by migration. TRANS=YES should always be specified when DJ is called on the higher level release.
Note: This parameter applies only to translation from, or fallback to, JES3 releases that are no longer in service.Specify TRANS=NO (the default) if jobs are to be dumped exactly as they exist on the job queue under the current release level of JES3.- YES
- Translates the format of a job's control blocks back to the format
of an old release of JES3, but not lower than JES3 SP 1.3.4.
When migrating to a higher release of JES3, specify the IN= parameter with the TRANS=YES parameter when calling DJ on the higher level release.
When falling back to an older release of JES3, specify the OUT= parameter with the TRANS=YES parameter when calling DJ on the higher level release.
- NO
- Translation is not performed. NO is the default.
When migrating to a higher release of JES3, specify the OUT= parameter with the TRANS=NO parameter.
When falling back to an older release of JES3, specify the IN= parameter with the TRANS=NO parameter.
- LABEL=
- Specifies whether the output tapes are to be created with or without
operating system standard labels.
- SL
- Indicates that standard labeled tapes are to be produced. Using the SL keyword parameter requires that a standard labeled tape be mounted when the JES3 DJ facility asks for a tape to be mounted. This is the default when TRANS=NO is specified or allowed to default.
- NL
- Indicates that unlabeled tapes are to be produced. This is the default when TRANS=YES is specified.
- SLCHECK=
- Specifies whether DJ is to verify that the tape mounted is unlabeled
when LABEL=NL is specified or allowed to default. This parameter is
ignored when LABEL=SL is specified or allowed to default.
- YES
- Indicates that an unlabeled tape must be mounted when DJ asks for a tape to be mounted.
- NO
- Indicates that dump job will accept either a labeled or an unlabeled tape. If a labeled tape is mounted, DJ will write over the label.
Note: When LABEL=NL and SLCHECK=NO are specified for server mode (SERVER=YES) output (OUT=) requests, the tape data set will be allocated with the bypass label processing (BLP) option.
Rules
- If you have specified IO=NO on an *CALL command and *START DJ to make a pass at dumping jobs, but you now want to invoke DJ with IO=YES to actually dump jobs, you must first enter an *START,DJddd,RESET command before attempting to dump the jobs.
- Before using the TRANS= parameter, consult your system programmer to make sure your installation has done the required setup to use the DJ translation capability.
- Once a DJ DSP has allocated a tape unit, the DSP issues a message indicating it is up and running and ready to be started. This message identifies the particular DJ DSP as DJddd-jobname (ddd is the tape unit and jobname is the job name of the DJ DSP.) All subsequent messages are prefixed with this identifier to indicate the DJ DSP that issued the message.
Examples
For SERVER=NO requests:
- Invoke a DJ DSP in output mode on tape unit 358, to be rescheduled
if that device is currently busy.
*CALL,DJ,OUT=358,NAV=R - Invoke a DJ DSP in output mode on tape unit 45A; do not actually
dump any jobs to tape.
*X,DJ,OUT=45A,IO=NO - Invoke a DJ DSP in output mode on tape unit 261.
*X,DJ,OUT=261 - Invoke a DJ DSP in input mode on tape unit 431; specify a density
of 6250 bpi.
*CALL,DJ,IN=431,DEN=62 - Invoke a DJ DSP in input mode on tape unit 356.
*X,DJ,IN=356 - Invoke a DJ DSP in input mode on tape unit 27E; begin restoring
jobs from where the tape is currently positioned.
*X,DJ,OUT=27E,OLD
For SERVER=YES requests:
- Invoke a DJ DSP in output mode on tape unit 358.
*CALL,DJ,OUT=358,SERVER=YES - Invoke a DJ DSP in output mode on tape unit 45A; do not actually
dump any jobs to tape.
*X,DJ,OUT=45A,IO=NO,SERVER=YES - Invoke a DJ DSP in output mode on tape unit 261.
*X,DJ,OUT=261,SERVER=YES - Invoke a DJ DSP in input mode on tape unit 358; specify a density
of 6250 bpi and the cataloged DJ dump data set name JES3.DJ.D1997343.T085225.
*CALL,DJ,IN=358,DEN=62,DSN=JES3.DJ.D1997343.T085225,SERVER=YES - Invoke a DJ DSP in input mode on tape unit 356. The DJ dump was
created on a JES3 support unit.
*X,DJ,IN=356,DSN=JES3.DJOUT,VOL=DJOOLD,SERVER=YES - Invoke a DJ DSP in output mode on a tape library device. You want
the resulting output tape to be an SL tape.
*X,DJ,OUT=5A0,LABEL=SL,SERVER=YES IAT6306 JOB (JOB00019) IS DJ , CALLED BY 01 IAT6100 ( DEMSEL ) JOB IEESYSAS (JOB00020), PRTY=15, ID=*UNKNOWN SY1 IEESYSAS IEF403I IEESYSAS - STARTED - TIME=16.11.04 IAT5110 JOB IEESYSAS (JOB00020) GET 255 T SCRTCH , SL JES3.DJ.D1998049.T16 IAT7272 DJ05A0 (JOB00019): OUTDSN=JES3.DJ.D1998049.T161102 IAT7213 DJ05A0 (JOB00019): UP AND RUNNING; OUTPUT ON UNIT 05A0, DEVICE MVS 05A0 *IAT7228 ISSUE START OR CANCEL FOR DJ (JOB00019) (05A0) - Invoke a DJ DSP in output mode on a tape library device. You
want the resulting output tape to be an NL tape, and if the scratch
tape that is mounted is an SL tape, you want to overwrite the labels.
This example also shows the typical console messages that are issued
for the entire DJ request.
*X,DJ,OUT=(LDE10435),LABEL=NL,SLCHECK=NO,SERVER=YES IAT6306 JOB (JOB06817) IS DJ , CALLED BY 01 IAT6100 ( DEMSEL ) JOB IEESYSAS (JOB06818), PRTY=15, ID=*UNK NOWN SY1 IEESYSAS IEF403I IEESYSAS - STARTED - TIME=14.07.48 IAT5110 JOB IEESYSAS (JOB06818) GET 255 T SCRTCH ,BL JES3.DJOUT IAT7272 DJ0B80 (JOB06817): OUTDSN=JES3.DJOUT IAT7213 DJ0B80 (JOB06817): UP AND RUNNING; OUTPUT ON UNIT 0B80, DEVICE MVS 0B80 *IAT7228 ISSUE START OR CANCEL FOR DJ (JOB06817) (0B80)