Changing device setup *MODIFY,S

Function

Use the *MODIFY,S command to:

Make a volume unavailable for JES3 setup processing
Make a volume available for JES3 setup processing
Keep a real direct access volume mounted on a designated device. This command is also valid for devices containing SMS-managed volumes
Unload a volume mounted on a designated device
Specify automatic or manual allocation of JES3-managed devices Using this command overrides the specification established by the ALLOCATE parameter on the SETPARAM initialization statement.
Specify whether to include jobs that require only deferred mounts in the setup depth counts (SDEPTH).
Determine if volumes required and presumed mounted for a designated job have been mounted. Use this command if all of the volumes have been mounted, but the expected responses, through JES3 volume verification, have not been recognized.
Change the current number of asynchronous I/O requests that can be processed simultaneously.
Specify, with the THWSSEP= parameter, whether you want scratch and specific tape requests and scratch requests of different media types separated during high watermark processing.
Specify, with the IVERMSG= parameter, whether all initial verify response messages are written to the hardcopy message log (MLOG).

Syntax


>>-+-*MODIFY-+--,--S-------------------------------------------->
   '-*F------'         

>--+-,--AL--=--+-A-+-----------------------------+-------------><
   |           '-M-'                             |   
   +-,--ALWIO--=--nn-----------------------------+   
   +-,--J--=--jobno--,--V------------------------+   
   +-,--M--=--+-+---+--devnum-+--,--main--,--vol-+   
   |          | '-⁄-'         |                  |   
   |          '-devtype-------'                  |   
   +-,--THWSSEP--=--+-IGNORE--+------------------+   
   |                +-PREFER--+                  |   
   |                '-REQUIRE-'                  |   
   +-,--DEFERCT--=--+-YES-+----------------------+   
   |                '-NO--'                      |   
   +-,--U--=----+---+--devnum----,--main---------+   
   |            '-⁄-'                            |   
   +-,--VA--=--+-+-T-vol-----------+-+-----------+   
   |           | |    .-,-----.    | |           |   
   |           | |    V       |    | |           |   
   |           | '-(----T-vol-+--)-' |           |   
   |           '-+-D-vol-----------+-'           |   
   |             |    .-,-----.    |             |   
   |             |    V       |    |             |   
   |             '-(----D-vol-+--)-'             |   
   +-,--VU--=--+-+-T-vol-----------+-+-----------+   
   |           | |    .-,-----.    | |           |   
   |           | |    V       |    | |           |   
   |           | '-(----T-vol-+--)-' |           |   
   |           '-+-D-vol-----------+-'           |   
   |             |    .-,-----.    |             |   
   |             |    V       |    |             |   
   |             '-(----D-vol-+--)-'             |   
   |                .-SUMMARY-.                  |   
   '-,--IVERMSG--=--+-ALL-----+------------------'

Parameters

AL=A or M

Specifies whether allocation is automatic or manual.

AL=A: Specifies that setup is to automatically attempt allocation of resources for all eligible jobs. Jobs that require SMS-managed resources are sent through the system select phase to determine which mains have access to the required SMS-managed resources. Jobs that do not require SMS-managed resources proceed to the allocation phase of MDS processing.
AL=M: Specifies that setup is to place all jobs into the WAITVOL queue following volume fetch. Jobs remain in the WAITVOL queue until an operator issues a *START,S command to indicate that the required resources are available.

ALWIO=nn

Specifies that the number of asynchronous I/O requests that can be processed simultaneously be set to nn. This value overrides the value specified in the ALWIO parameter of the SETPARAM initialization statement. The minimum for this parameter is one. The maximum is the value specified in the MAXIO parameter of the SETPARAM initialization statement. Specifies automatic (A) or manual (M) allocation of devices.

DEFERCT=YES|NO

Specifies whether to include jobs that require only deferred mounts in the setup depth counts (SDEPTH). This commands allows you to override the DEFERCT parameter on the SETPARAM initialization statement.

J=jobno

Specifies the job whose volumes are to be verified.

V

Specifies verification for the designated job.

M=devnum or /devnum or devtype

Specifies the device on which the volume is to be kept. This parameter is not valid for tape volumes. The device number can be a 3-digit or 4-digit hexadecimal number. A slash (/) preceding the device number is required for 4-digit device numbers. The M= parameter treats 4-digits without a slash as a device type. Device numbers can be specified by any of the following formats:

ddd
/ddd
/dddd

main

Specifies the main to which the designated device is attached.

vol

Specifies the volume serial which is to be kept mounted on the designated device. If JES3 does not find the volume on the device, it issues a MOUNT message requesting it.

THWSSEP=IGNORE

Specifies that JES3 not separate scratch and specific tape requests and not separate scratch tape requests of different media types during high watermark processing. Both scratch and specific tape requests and scratch requests of different media types will be allocated on the same tape drive.

THWSSEP=PREFER

Specifies that JES3 attempt to allocate scratch and specific tape requests on separate tape drives or attempt to allocate scratch tape requests of different media types on separate tape drives without allocating additional devices. If JES3 cannot separate the requests, scratch and specific tape requests and scratch requests of different media types will be allocated on the same tape drive.

THWSSEP=REQUIRE

Specifies that JES3 should not allocate scratch and specific tape requests on the same tape drive and not allocate scratch tape requests of different media types on the same tape drive, even if JES3 must allocate additional tape drives to satisfy the request.

U=devnum or /devnum

Specifies the direct or serial access device (devnum or /devnum) on which the volume to be unloaded is located. The device number can be a 3-digit or 4-digit hexadecimal number. Device numbers must be specified in one of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

main

Specifies the main to which the designated device is attached.

VA=T-vol or D-vol

Specifies the tape (T) and disk (D) volumes that are to be made available.

VU=T-vol or D-vol

Specifies the tape (T) and disk (D) volumes that are to be made unavailable. The designated volumes remain unavailable until a *MODIFY,S,VA= command is issued.

Note: Using the *MODIFY,S command to make SMS-managed volumes unavailable has no effect on job scheduling except for those requests for any SMS user catalogs that reside on the volume in question.

To prevent JES3 from scheduling jobs for an SMS-managed volume, use the V SMS,VOLUME(vvvvvv),QUIESCE or V SMS,VOLUME (vvvvvv),QUIESCE,NEW commands. For more information about these commands, refer to z/OS MVS System Commands.

IVERMSG=SUMMARY|ALL

Specifies whether all initial verify response messages (IAT5918 messages received during main connect) are written to the hardcopy message log (MLOG). SUMMARY specifies that a summary message (IAT5919) will be written for every 100 initial verify response messages and at the end of initial verify processing. ALL specifies that all initial verify response messages are written. The default is SUMMARY.

The change applies to all systems connecting after the command is processed and remains in effect until the next JES3 restart or until the setting for IVERMSG is changed.

If you want the command to take effect for only a specific JES3 system, you can vary all the remaining systems offline to JES3 before entering the *START,JSS or *START,main,CONNECT commands. If you want the command to take effect for all systems after a JES3 restart, enter the command before entering the *START,JSS command.

Results

A job that has not been allocated by setup and that requests use of an unavailable volume is placed in the setup volume unavailable queue.
A job that allocated a volume before the volume being made unavailable is allowed to complete normally.
A dynamic allocation request for an unavailable volume is rejected.
A catalog setup request for an unavailable volume causes the job to be canceled by the converter/interpreter DSP.
All jobs that are currently on the setup volume unavailable queue are transferred to the setup allocation queue.

To allow a single job to allocate unavailable volumes, use the *RESTART,S command (see Restarting allocation *RESTART,SETUP).

JES3 issues this message:

IAT5726 THWSSEP=IGNORE | PREFER | REQUIRE

Examples

Tape volumes R67891 and R67892 are to be made unavailable:

*F,S,VU=(T-R67891,T-R67892)

Tape volumes R67891 and R67892 are to be made available:

*F,S,VA=(T-R67891,T-R67892)

Keep volume A55521 mounted on a 3330 disk on main SY2:

*F,S,M=3390,SY2,A55521

Unload the volume mounted on device number 292 on SY2:

*F,S,U=292,SY2