Changing device scheduling *MODIFY,W

Function

Use the *MODIFY,W command to:

Control whether JES3 is to limit output for a device to only those data sets that are destined for its device group. You must restart any jobs in the output service queue when you use this command to dynamically change the device group scheduling criteria.
Control whether a writer for a printer can start dynamically or requires the *CALL,WTR command.
Control whether JES3, during setup of a writer, will issue message IAT7030 and require operator intervention.
Control whether certain FSS writer default values should be obtained from JES3 initialization defaults or from the FSS procedure.
Control whether non-displayable characters for a printer are to be translated to blanks. You cannot specify a 3211 printer or a 3211 compatible device because the device performs its own translation.
Control at what points a peripheral data set information record (PDIR) is sent with a job being sent to a remote writer.

Syntax


>>-+-*MODIFY-+--,--W--+-,--devname-----------+------------------>
   '-*F------'        |       .-,-------.    |   
                      |       V         |    |   
                      +-,--(----devname-+--)-+   
                      '-,--+---+--devnum-----'   
                           '-/-'                 

>--+----------------------+------------------------------------->
   '-,--DGRPY--=--+-YES-+-'   
                  +-Y---+     
                  +-NO--+     
                  '-N---'     

>--+-----------------------------------------+------------------>
   '-+-,--DYN--=-----+----+-YES-+--timeout---'   
     '-,--DYNAMIC--=-'    +-Y---+                
                          +-NO--+                
                          '-N---'                

>--+-------------------------+---------------------------------->
   '-,--OPACTLOG--=--+-YES-+-'   
                     +-Y---+     
                     +-NO--+     
                     '-N---'     

>--+-------------------------------------------------------+---->
   '-,--PDEFAULT--=--+-NONE------------------------------+-'   
                     +-+---+--FCB------------------------+     
                     | '-/-'                             |     
                     +-+---+--CHARS----------------------+     
                     | '-/-'                             |     
                     '-(--+---+--FCB--,--+---+--CHARS--)-'     
                          '-/-'          '-/-'                 

>--+-----------------------+--+----------------------+---------->
   '-,--SETUPMSG--=--+-Y-+-'  '-,--XLATE--=--+-YES-+-'   
                     '-N-'                   +-Y---+     
                                             +-NO--+     
                                             '-N---'     

>--+---------------------+-------------------------------------><
   '-,--PDIR--=--+-ALL-+-'   
                 '-BDS-'

Parameters

devnum or /devnum or devname

Specifies the output device. The device number can be a 3-digit or 4-digit hexadecimal 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.

DGRPY=Y or YES

Specifies that the device cannot process data sets that are destined for any local device.

DGRPY=N or NO

Specifies that the device can also process data sets that are destined for any local device.

DYNAMIC or DYN =Y or YES

Specifies that the device can be started dynamically.

DYNAMIC or DYN =(Y,timeout) or (YES,timeout)

Specifies that you want the writer to stop after the indicated 'timeout' value has elapsed but to restart dynamically when work is available to be processed.

Note: If the timeout value is at its default (meaning it has not been overridden by an initialization statement or an operator command), the corresponding timeout value will be put into effect. For a DYN=NO specification, the timeout value will be set to ''NONE''. For a DYN=YES specification, the timeout value will be set to zero. If the command sets the same timeout value as the default, the timeout value will remain in effect regardless of changes to the first subparameter. You can use the "/" specification (see below) to restore the default attribute.

timeout

The possible values for the timeout parameter are:

nnnM: Specifies the timeout interval in minutes (up to 999 minutes).
nnnH: Specifies the timeout interval in hours (up to 999 hours).
nnnD: Specifies the timeout value in days (up to 999 days).
0: Specifies that the writer is to be stopped when no more output is available for processing.
*: Specifies that the writer is to stay up until an operator stops it using JES3 *CANCEL command.
/: Specifies that the timeout value should be reset to its default setting. If DYN=YES was specified (or is currently in effect) the timeout value is set to zero. If DYN=NO is in effect, no timeout will be set.

DYNAMIC or DYN =N or NO

Specifies that the device cannot be started dynamically. You can only start the device by using the *CALL,WTR command.

DYNAMIC or DYN =(N,timeout) or (NO,timeout)

Specifies that you want the writer to stop after the indicated timeout value has elapsed. The writer has to be manually started when work is available to be processed.

Note: Possible values for timeout are the same as for DYNAMIC or DYN =(Y,timeout) or (YES,timeout).

OPACTLOG=Y or YES

Specifies that operator command actions will be logged in the output of the modified device using message IAT7066 or IAT7067. This parameter is only valid for FSS devices.

OPACTLOG=N or NO

Specifies that operator command actions will not be logged in the output. This parameter is only valid for FSS devices.

PDEFAULT=NONE or FCB|/FCB or CHARS|/CHARS

If PDEFAULT=NONE, this specifies that no characteristics for either FCB or CHARS should be obtained by the FSS from the procedure definitions in PROCLIB.

Otherwise, specifies that the FCB or CHARS characteristics, if not defined in the job's JCL, should be obtained by the FSS from the procedure definitions in PROCLIB. If the keyword is prefixed with a slash (/), the characteristics are obtained from the JES3 defaults set during initialization.

Note:

This keyword affects devices that were started with the work selection parameter for the requested characteristics. For FCB, the affected work selection parameter is WS=C. For CHARS, the affected work selection parameter is WS=U.
The FCB and /FCB keywords and also the CHARS and /CHARS keywords are mutually exclusive; that is, you cannot request that a default for either parameter be obtained from both the FSS procedure and JES3 definitions at the same time.
You can specify the FCB or /FCB keyword and the CHARS or /CHARS keyword together if they are separated by a comma and enclosed with parentheses.

SETUPMSG=YES

Specifies that the writer setup action message IAT7030 will be issued for the specified device (YES|Y).

SETUPMSG=NO

Specifies that the writer setup action message IAT7030 will be suppressed for the specified device (NO|N).

XLATE=YES

Specifies that the device is to translate non-displayable characters to blanks (YES|Y).

XLATE=NO

Specifies that the device is to send non-displayable characters to the device without translating them (NO|N).

PDIR=ALL

Specifies that a PDIR is to precede every data set in a job.

PDIR=BDS

Specifies that a PDIR is sent at the beginning of a job, when JES3 sends the begin destination select (BDS) command.

You want to use printer 002 for special jobs. Issue the *MODIFY,W command so that only a *CALL,WTR command can start the printer:

*MODIFY,W,002,DYNAMIC=NO

Assume the output for device PRT804 is being written to the RPM-3 spool. The device will select on forms, and forms are changeable. If the operator does not want to respond to message IAT7030 for form changes (the operator does not have to intervene), RPM-3 handles the forms changes. The operator can suppress these messages on device PRT804 by issuing the following command:

*MODIFY,W,PRT804,SETUPMSG=NO

You are located in Chicago. Printer 003 is an AFP printer located in Atlanta. JES3 considers AFP printers local devices, even though they can be placed at distant locations. Issue the *MODIFY,W command so that data sets that are destined for any local device (ANYLOCAL) do not print on this device:

*MODIFY,W,003,DGRPY=YES

You want to change the remote writer ABCDEPR1 so that a PDIR is sent with every job. You can enter the following command:

*MODIFY,W,ABCDEPR1,PDIR=ALL

You want to change the remote writer ABCDEPR2 to translate all non-displayable characters to blanks when it prints output. You can enter the following command:

*MODIFY,W,ABCDEPR2,XLATE=YES