Starting or resetting the DJ facility *START,DJdevnum

Function

After a DJ DSP has been invoked, the DJ facility issues its login message and requests the mounting of a tape (unless OLD was specified). After the mount request, you can issue the *START command. Because multiple DJ DSPs can be active concurrently, use the appropriate DJdevnum identifier to start your DJ DSP.

When a DJ DSP is invoked to dump a job or net, the DJ facility sets dump control flags for each job processed. Because of these flags, any jobs remaining on the JES3 job queue after DJ has processed them cannot be dumped again until the flags are reset.

Use the *START command with the RESET parameter to reset DJ dump control flags for all jobs or a selected set of jobs on the JES3 job queue. Enter this command when all other dumping using the DJ facility is complete.

Syntax

Out Mode
>>-+-START-+--+-,--DJdevnum-+----------------------------------> '-S-----' '-,--DJ-------' >--+-,--ALL--------------------------------+--------------------> +-,--C--=--class------------------------+ +-,--DD--=--ddn-------------------------+ +-,--JOBS-------------------------------+ +-,--J--=--jobno------------------------+ +-,--NETS-------------------------------+ +-,--N--=--djcnet-----------------------+ +-,--P--=--prty-------------------------+ '-,--RANGE--=--(--jobno1-- ---jobno2--)-' .-,--DISP--=--PURGE----. .-,--SPIN--=--NO--. >--+----------------------+--+-----------------+----------------> '-,--DISP--=--+-HOLD-+-' '-,--SPIN--=--YES-' '-SAVE-' .-,--TRACE--=--NO------. >--+----------------------+------------------------------------>< '-,--TRACE--=--+-ALL-+-' +-CB--+ +-CBD-+ '-CCW-'

Out Mode


>>-+-*START-+--+-,--DJdevnum-+---------------------------------->
   '-*S-----'  '-,--DJ-------'   

>--+-,--ALL--------------------------------+-------------------->
   +-,--C--=--class------------------------+   
   +-,--DD--=--ddn-------------------------+   
   +-,--JOBS-------------------------------+   
   +-,--J--=--jobno------------------------+   
   +-,--NETS-------------------------------+   
   +-,--N--=--djcnet-----------------------+   
   +-,--P--=--prty-------------------------+   
   '-,--RANGE--=--(--jobno1-- ---jobno2--)-'   

   .-,--DISP--=--PURGE----.  .-,--SPIN--=--NO--.   
>--+----------------------+--+-----------------+---------------->
   '-,--DISP--=--+-HOLD-+-'  '-,--SPIN--=--YES-'   
                 '-SAVE-'                          

   .-,--TRACE--=--NO------.   
>--+----------------------+------------------------------------><
   '-,--TRACE--=--+-ALL-+-'   
                  +-CB--+     
                  +-CBD-+     
                  '-CCW-'

Out Mode To Reset DJ Dump Control Flags
>>-+-START-+--+-,--DJdevnum-+--,--RESET------------------------> '-S-----' '-,--DJ-------' >--+-,--ALL--------------------------------+--------------------> +-,--C--=--class------------------------+ +-,--DD--=--ddn-------------------------+ +-,--JOBS-------------------------------+ +-,--J--=--jobno------------------------+ +-,--NETS-------------------------------+ +-,--N--=--djcnet-----------------------+ +-,--P--=--prty-------------------------+ '-,--RANGE--=--(--jobno1-- ---jobno2--)-' .-,--SPIN--=--NO--. >--+-----------------+----------------------------------------->< '-,--SPIN--=--YES-'

Out Mode To Reset DJ Dump Control Flags


>>-+-*START-+--+-,--DJdevnum-+--,--RESET------------------------>
   '-*S-----'  '-,--DJ-------'             

>--+-,--ALL--------------------------------+-------------------->
   +-,--C--=--class------------------------+   
   +-,--DD--=--ddn-------------------------+   
   +-,--JOBS-------------------------------+   
   +-,--J--=--jobno------------------------+   
   +-,--NETS-------------------------------+   
   +-,--N--=--djcnet-----------------------+   
   +-,--P--=--prty-------------------------+   
   '-,--RANGE--=--(--jobno1-- ---jobno2--)-'   

   .-,--SPIN--=--NO--.   
>--+-----------------+-----------------------------------------><
   '-,--SPIN--=--YES-'

In Mode
>>-+-START-+----,--DJdevnum------------------------------------> '-S-----' >--+-,--ALL--------------------------------+--------------------> +-,--C--=--class------------------------+ +-,--JOBS-------------------------------+ +-,--J--=--jobname----------------------+ +-,--NETS-------------------------------+ +-,--N--=--djcnet-----------------------+ +-,--P--=--prty-------------------------+ '-,--RANGE--=--(--jobno1-- ---jobno2--)-' .-,--SPIN--=--NO--. >--+------------------+--+--------+--+-----------------+--------> '-,--DISP--=--HOLD-' '-,--OLD-' '-,--SPIN--=--YES-' .-,--TRACE--=--NO------. >--+----------------------+------------------------------------>< '-,--TRACE--=--+-ALL-+-' +-CB--+ +-CBD-+ '-CCW-'

In Mode


>>-+-*START-+----,--DJdevnum------------------------------------>
   '-*S-----'                    

>--+-,--ALL--------------------------------+-------------------->
   +-,--C--=--class------------------------+   
   +-,--JOBS-------------------------------+   
   +-,--J--=--jobname----------------------+   
   +-,--NETS-------------------------------+   
   +-,--N--=--djcnet-----------------------+   
   +-,--P--=--prty-------------------------+   
   '-,--RANGE--=--(--jobno1-- ---jobno2--)-'   

                                     .-,--SPIN--=--NO--.   
>--+------------------+--+--------+--+-----------------+-------->
   '-,--DISP--=--HOLD-'  '-,--OLD-'  '-,--SPIN--=--YES-'   

   .-,--TRACE--=--NO------.   
>--+----------------------+------------------------------------><
   '-,--TRACE--=--+-ALL-+-'   
                  +-CB--+     
                  +-CBD-+     
                  '-CCW-'

Parameters

DJdevnum

Specifies the DJ DSP that this command should be processed by. If only one DJ DSP is active, you do not have to specify the device number (devnum or /devnum). The device number can be a 3-digit or 4-digit hexadecimal number. A slash (/) preceding the device number is permitted but not required. Device numbers can be specified by any of the following formats:

ddd
dddd

where ddd and dddd represent the device numbers.

ALL

Specifies that all jobs, including DJC network jobs, are to be dumped or restored.

C=class

Specifies that all jobs in the indicated job class that are not part of a DJC network are to be dumped or restored.

DD=ddn

Specifies that all jobs that have data on the indicated spool data set that are not part of a DJC network are to be dumped.

JOBS

Specifies that all jobs in the JES3 job queue that are not part of a DJC network are to be dumped or restored.

J=jobno or jobname

Specifies a job, that is not part of a DJC network, to be dumped or restored. For out mode, specify jobno. For in mode, specify jobname.

N=djcnet

Specifies the DJC network to be dumped or restored. The network must be in operator hold status to qualify for dumping.

NETS

Specifies that all DJC networks be dumped or restored.

P=prty

Specifies that all jobs at the indicated priority that are not part of a DJC network are to be dumped or restored.

RANGE=(jobno1-jobno2)

Specifies the range of job numbers you want dumped or restored, where jobno1 is the lowest number in the range, and jobno2 is the highest. If a job is part of a DJC network, it will not be dumped or restored.

DISP=

Specifies the disposition of jobs after they are dumped by DJ.

PURGE (default): All jobs dumped are to be purged from the job queue. DJ marks all of the job's scheduler elements except PURGE as complete. PURGE is the default for DJ. If IO=NO is specified on the *CALL command, PURGE is forced to SAVE. Valid on out mode only.
SAVE: The jobs dumped remain on the job queue. Valid on out mode only.
HOLD: All jobs dumped remain on the job queue, but in hold status.

SPIN=YES or NO

Specifies whether the message log data set is to be printed at completion of this *START request. NO is the default.

TRACE=

Specifies whether any tracing is to be performed on this *START command.

NO (default): Specifies that no tracing is to be done. NO is the default.
CCW: Specifies that the channel command words for each I/O operation to tape are to be traced.
CB: Specifies that the name of each control block is to be traced.
CBD: Specifies that the name and data contents of each control block are to be traced.
ALL: Specifies that all types of tracing be performed.

Use the TRACE= parameter with caution. All trace output is logged in the DJ message log data set. If you are dumping a large number of jobs, this could result in a shortage of spool space.

OLD

Specifies that DJ is not to rewind the input tape before processing. You would want to use OLD when the job to be restored has not yet been read past on the tape; this would save the time required to read through jobs that have already been restored by a previous *START command.

RESET

Specifies the DJ control flags for all jobs on the JES3 job queue are to be reset.

Rules

Use care when dumping all jobs or when dumping jobs by priority level. Some jobs can be missed if their priority level is switched or if they are added to the job queue during DJ processing.
If the end of a reel is reached during DJ processing, JES3 or the DJ server address issues a message requesting that another tape be mounted on the same device.
After DJ processing completes, the DJ message log data set will indicate the jobs that were successfully dumped and those that were not.
After DJ processing completes, JES3 requests that the DJ DSP be canceled or that a new *START command be issued. If you issue a new *START command, DJ will be in output (dumping) mode as specified on the *CALL,DJ command.
When a DJ DSP is started with the RESET parameter, no other DJ DSPs can be active in output (dumping) mode.
As each job is reset, the DJ message log data set will indicate the jobs that were successfully reset and those that were not.
Note that when jobs are restored to the JES3 job queue, they might not be assigned the same job number.

Examples

Start DJ27E to dump job number 1319; retain the job on the JES3 job queue:

*START,DJ27E,J=1319,DISP=SAVE

Start DJ342 to dump DJC net COST1500; retain the net on the JES3 job queue in hold status:

*S,DJ342,N=COST1500,DISP=HOLD

Start DJ443 to dump all jobs with priority level 15 that are not part of a DJC network:

*S,DJ443,P=15

Start DJ28D to dump all class A jobs that are not part of a DJC network:

*S DJ28D C=A

Start DJ364 to dump job number 5290; perform all tracing:

*S,DJ364,J=5290,TRACE=ALL

Start DJ457 to dump all jobs that are not part of a DJC network:

*S,DJ457,JOBS

Start DJ42B to dump all jobs on the JES3 job queue and print the message log data set:

*S DJ42B ALL SPIN=YES

Start DJ352 to reset control flags for all jobs that remain on the JES3 job queue:

*START,DJ352,RESET,ALL

Start DJ353 to restore job COPYJOB to the JES3 job queue; begin restoring at the point at which the tape is currently positioned:

*START,DJ353,J=COPYJOB,OLD

Start DJ461 to restore DJC net COST1500 to the JES3 job queue in hold status:

*S,DJ461,N=COST1500,DISP=HOLD

Start DJ267 to restore the first encountered group of jobs with priority level 15 that are not part of a DJC network:

*S,DJ267,P=15

Start DJ449 to restore the first encountered group of class A jobs that are not part of a DJC network:

*S,DJ449,C=A

Start DJ35A to restore all DJC networks to the JES3 job queue:

*S,DJ35A,NETS

Start DJ451 to restore all jobs that are not part of a DJC network to the JES3 job queue:

*S,DJ451,JOBS

Start DJ342 to restore all jobs to the JES3 job queue and print the message log data set:

*S,DJ342,ALL,SPIN=YES