Holding, releasing, or changing jobs or spool data sets *MODIFY,Q

Function

Syntax

>>-+-*MODIFY-+--,--Q--+-,--------+------------------------------>
   '-*F------'        +-DUPJOBNM-+   
                      +-=--------+   
                      '-+-NO--+--'   
                        '-YES-'      

>--+-,--DD--=--+-ddn-----------+--+-,--CANCEL----------------------+-+-><
   |           |    .-,---.    |  +-,--CYL--=--cyl--,--TRK--=--trk-+ |   
   |           |    V     |    |  +-,--DRAIN-----------------------+ |   
   |           '-(----ddn-+--)-'  +-,--HOLD------------------------+ |   
   |                              +-+-,--RELEASE-+-----------------+ |   
   |                              | '-,--R-------'                 | |   
   |                              +-,--SP--=--spart----------------+ |   
   |                              +-,--STOP------------------------+ |   
   |                              '-,--USE-------------------------' |   
   +-,--P--=--+-prty-----------+--+-,--H-+---------------------------+   
   |          |    .-,----.    |  '-,--R-'                           |   
   |          |    V      |    |                                     |   
   |          '-(----prty-+--)-'                                     |   
   '-,--SP--=--spart1--+-,--O--=--+-spart2-+-+-----------------------'   
                       |          +-YES----+ |                           
                       |          '-NO-----' |                           
                       '-,--MIN--=--nn-------'                           

Parameters

DUPJOBNM={NO|YES}

Specifies whether multiple batch jobs of the same name may be scheduled for the MAIN SE at the same time.

NO

A batch job will not be scheduled for the MAIN SE if another batch job with the same name has already been scheduled for MAIN.

YES

A batch job may be scheduled for the MAIN SE even if another batch job with the same name has already been scheduled for MAIN.

DD =ddn

Specifies the ddname of the spool data set. JES3 assigns this spool data set to the specified partition if you also specify SP=spart. JES3JCT is not a valid ddname for this parameter.

CANCEL

Holds the specified spool data set (places the data set in spool hold status) and cancels all jobs that have data on the data set.

CYL=cyl

Specifies a one- to seven-digit hexadecimal value identifying the cylinder that contains the defective track.

TRK=trk

Specifies a one- to four-digit hexadecimal value identifying the defective track. When specified with more than one digit, only the low digit can be nonzero.

DRAIN

Stops allocating space on the specified spool data set.

HOLD

Holds the specified spool data set and holds further scheduling for all jobs that have data on the data set (places the data set and the jobs in spool hold status).

RELEASE or R

Releases the specified spool data set and all jobs that have data on the spool data set for further scheduling (releases the data set and the jobs from spool hold status).

SP=spart

Specifies the name of a spool partition. JES3 assigns the specified spool data set to this partition.

STOP

Holds the specified spool data set and holds further scheduling for all jobs that have data on the data set if the jobs are not currently active on a main (places the data set and the jobs in spool hold status). This parameter cancels all jobs with data in the data set if the jobs are currently active on a main.

USE

Resumes allocating space on the specified spool data set.

P=prty

Specifies the priority level (0 through 15) of the jobs to be held or released in the JES3 job queue.

H

Specifies that the jobs are to be held from further scheduling (place the jobs in priority hold status).

R

Specifies that the jobs are to be released for further scheduling (release the jobs from priority hold status).

SP=spart1

Specifies the name of a spool partition to which an overflow partition is being assigned.

O=spart2

Specifies the name of the spool partition into which spool data is to overflow if spart1 becomes full.

O=YES

Indicates that spool data is to overflow into the default spool partition.

O=NO

Indicates that spool data is not to overflow into any other spool partitions.

MIN=nn

Allows the minimal spool threshold to be changed. The primary intent of the parameter is that it be used only in emergency situations when a spool shortage exists in a partition. Lowering the threshold or specifying zero for the default partition could prevent JES3 from initializing during the next JES3 restart requiring a coldstart to recover.

nn is a value between 0 and 99. It represents a percentage of the total partition spool space that is left free to perform JES3 system functions. See z/OS JES3 Initialization and Tuning Guide for an explanation of the SPLIM parameter on the SPART initialization statement.

Rules

• Changing DUPJOBNM to 'NO' has no effect on batch jobs with the same name that have already been scheduled for MAIN.
• Do not specify the ddnames of all the spool data sets assigned to the default partition; at least one spool data set must be assigned to the default partition at all times.
• Make sure that all ddnames and partition names are valid; the command does not run if errors are detected.
  • JES3 issues message IAT8090:

    IAT8090  SPOOL DATA SET ddname MOVED TO PARTITION spart

  • JES3 can now write data assigned to the specified partition to the specified spool data set(s).
  • Data written to the specified spool data set(s) before the command is issued remain unchanged.
  • The changes to ddnames and partition names remain in effect after you restart JES3 using a hot start; they are reset based on the initialization stream specifications after you use a warm start, hot start with refresh or *MODIFY CONFIG command with spool initialization statements.
• If no overflow partition is assigned, spool data automatically overflows into the default partition. The default partition does not overflow.
• If you modify the overflow partition, JES3 issues message IAT8097.

  IAT8097  spart1 WILL NOW OVERFLOW INTO PARTITION spart2

• If a circular overflow condition would result, JES3 issues message IAT8098.

  IAT8098  OVERFLOW MODIFY FOR spart1 REJECTED,
           CIRCULAR OVERFLOW WOULD RESULT

• You can specify a maximum of 20 spool data sets each time you issue the command.
• Enter the USE parameter for a spool data set that was previously stopped using the DRAIN parameter.
• For the DRAIN parameter:
  • JES3 issues message IAT8091:

    IAT8091  ALLOCATION FROM SPOOL DATA SET ddname
             SUSPENDED

  • JES3 stops allocating space on the specified spool data set(s). If there are jobs in the system that currently have data on the data set(s), JES3 continues normal processing for these jobs and releases the space as each job completes.
• For the USE parameter:
  • JES3 issues message IAT8091:

    IAT8091  ALLOCATION FROM SPOOL DATA SET ddname RESUMED

  • JES3 resumes allocating space on the specified spool data set(s).
• All changes remain in effect after you restart JES3 using a hot start or a warm start.

• For the HOLD parameter:
  • JES3 issues the following messages:

    IAT8091 ALLOCATION FROM SPOOL DATA SET ddname
            SUSPENDED

    This message is issued for each job affected by the command.

    IAT8083  JOB QUEUE FOR SPECIFIED EXTENTS HELD

  • JES3 puts the specified spool data set(s) in spool hold status and does not allocate additional space on the data set(s).
  • JES3 does not schedule any additional processing for jobs that have data on the specified spool data set(s). Processing that is in progress at the time you submit the command is allowed to complete.
• For the STOP parameter:
  • JES3 issues the following messages:

    IAT8091  ALLOCATION FROM SPOOL DATA SET ddname
             SUSPENDED

    This message is issued for each job put into spool hold status as a result of this command.

    IAT8083  JOB QUEUE FOR SPECIFIED EXTENTS STOPPED

  • JES3 puts the specified spool data set(s) into spool hold status and does not allocate additional space on the data set(s).
  • JES3 puts each job that has data on the specified spool data set(s) and is not active on a main into spool hold status and does not schedule any additional activity for the job. If JES3 is currently performing any activity on behalf of the job, the activity terminates.
  • For each job with data on the specified spool data set(s) that is currently active on a main, JES3 requests that MVS™ cancel the job. If MVS cannot cancel the job, message IEE841I is issued. To cancel the job, you must enter the MVS FORCE command.
• For the RELEASE parameter:
  • JES3 issues the following messages:

    IAT8091  ALLOCATION FROM SPOOL DATA SET ddname RESUMED

    This message is issued once for each job affected by the command.

    IAT8083  JOB QUEUE FOR SPECIFIED EXTENTS RELEASED

  • JES3 releases each of the specified spool data set(s) from spool hold status and resumes allocating space on the data set(s).
  • For each job that has data on the specified data set(s), JES3 releases the job from spool hold status if the job does not also have data on other spool data sets that are being held. If other data sets are being held, JES3 again issues message IAT8091.

    (All the job's spool data sets must be released before the job can be released from spool hold status.)

  • JES3 takes the following action on jobs that it releases from spool hold status:
    • If you originally used the HOLD parameter to put the jobs in spool hold status, each job resumes processing at the point where it left off.
    • If you originally used the STOP parameter to put the jobs into spool hold status, JES3 responds as follows:
      • Reschedules each job to the last JES3 function scheduled for the job before it was put into hold status.
      • Restarts each batch job that was active on a main at the time the job was put into spool hold status. The job is restarted according to the failure option coded on the //*MAIN control statement in the job's JCL (CANCEL, HOLD, RESTART, PRINT).

      JES3 does not restart TSO/E users or started tasks.

  • For the CANCEL parameter:
    • JES3 issues the following messages:

      IAT8091  ALLOCATION FROM SPOOL DATA SET ddname
               SUSPENDED

      This message is issued for each job affected by the command.

      IAT8083  JOB QUEUE FOR SPECIFIED EXTENTS CANCELED

    • JES3 puts the specified spool data set(s) in spool hold status and does not allocate any additional space on the data set(s).
    • JES3 cancels each job that has data on the specified spool data set(s). It also cancels any output from the job that is ready to be printed.

    Jobs and data sets that have track allocation tables (TATs) on the specified data set(s) can also have spool space allocated on other, active spool data sets. When JES3 cancels these jobs, it does not release the spool space on the other spool data sets. As a result, this space is not usable until you restart JES3 using a warm start with analysis or a hot start with analysis.

  • All changes remain in effect after you restart JES3.

Examples

*F,Q,DD=(SPOOL3,SPOOL4),SP=PARTB

*F,Q,SP=PARTA,O=PARTB

*F,Q,SP=PARTB,O=YES

*F,Q,DD=(SPOOLD,SPOOLE),DRAIN

*F,Q,DD=SPOOLE,USE

*F,Q,DD=SPOOL1,HOLD

*F,Q,DD=SPOOL2,STOP

*F,Q,DD=(SPOOL1,SPOOL2),RELEASE

*F,Q,DD=SPOOL3,CANCEL

IAT1145 ENTRY ADDED TO BADTRACK TABLE: DDNAME=ddn,CYL=cyl,TRK=trk

If a BADTRACK element already existed for the track specified on the command, message IAT1145 will not be issued. You can use the BADTRACK inquiry command (*INQUIRY,BT) to get a list of the BADTRACK elements. If the command is rejected, message IAT8055 will be issued with a reason text that describes the error.

*F,Q,DD=SPOOL1,CYL=0064,TRK=000A

*F,Q,H