Changing job output *MODIFY,U
You use the *MODIFY,U command to modify job output in a JES3 system. The job output can be at various places within the system and your selection of the proper "Q=" keyword value on the *MODIFY,U command dictates what output you want to modify.
The choices are generally the following:
- *MODIFY,U,Q=BDT
- To modify SNA/NJE job output
- *MODIFY,U,Q=HOLD
- To modify job output on the HOLD queue
- *MODIFY,U,Q=WTR
- To modify job output on the WTR service queue
- *MODIFY,U,Q=TCP
- To modify TCP/IP/NJE output.
- *MODIFY,U
- To modify ALL output
Changing TCP/IP/NJE and SNA/NJE job output
- Function - *MODIFY,U Q=TCP
- Use the *MODIFY,U Q=TCP command to modify TCP/IP/NJE network jobs that are on the output service TCP queue. TCP/IP/NJE network jobs can be either network job streams or network SYSOUT streams. This command might have a length of 126 characters if the command is issued from an input device that permits that command length.
- Function - *MODIFY,U Q=BDT
- Use the *MODIFY,U Q=BDT command to modify SNA/NJE network jobs that are on the output service BDT queue. SNA/NJE network jobs can be either network job streams or network SYSOUT streams. This command may have a length of 126 characters if the command is issued from an input device that permits that command length. See Controlling SNA/NJE for a complete description of SNA/NJE.
Changing the HOLD queue
- Function - *MODIFY,U Q=HOLD
- Use the *MODIFY,U Q=HOLD command to modify requirements for work currently on the output service hold queue. This command may have a length of 126 characters if the command is issued from an input device that permits that command length. You can issue multiple *MODIFY,U commands at a time. The default number is ten. You can change this number by issuing the *MODIFY,X command for the appropriate DSP.
Changing the WTR queue
- Function - *MODIFY,U Q=WTR
- Use the *MODIFY,U Q=WTR command to modify requirements for work currently on the output service writer queue. This command may have a length of 126 characters if the command is issued from an input device that permits that command length. You can issue multiple *MODIFY,U commands at a time. The default number is ten and can be changed by using the N=xx parameter.
Syntax
.-,--Q--=--WTR-. >>-+-*MODIFY-+--,--U--+--------------+--------------------------> '-*F------' >--+------------------------------------------------------------------------------------------+--> +-,--Q--=--HOLD--+-------------------------+--+---------------------------------+----------+ | '-| Q=HOLD Unique Parms |-' '-| Q=HOLD & Q=WTR Common Parms |-' | +-,--Q--=--WTR--+------------------------+--+---------------------------------+------------+ | '-| Q=WTR Unique Parms |-' '-| Q=HOLD & Q=WTR Common Parms |-' | +-,--Q--=--BDT--+------------------------+--+--------------------------------+-------------+ | '-| Q=BDT Unique Parms |-' '-| Q=BDT & Q=WTR Common Parms |-' | '-,--Q--=--TCP--+-----------------------------+--+---------------------------------------+-' '-| Q=TCP Unique Parameters |-' '-| Q=TCP, Q=BDT & Q=WTR Common Parms |-' >--+--------------------------------------------------+---------> '-,--Q--=--WTR--+--------------------------------+-' '-| Q=BDT & Q=WTR Common Parms |-' >--+----------------------------+------------------------------>< '-| *MODIFY,U Common Parms |-' Q=WTR Unique Parameters .-,--GT--=--PRT-------------------. |--+---------------------------------+--+----------------+------> '-,--GT--=--+-PUN---------------+-' '-,--NQ--=--HOLD-' '-(--PRT--,--PUN--)-' >--+-------------------------+--+-------------------+-----------| '-,--NST--=--+-ndevtype-+-' '-,--ST--=--devtype-' '-NONE-----' Q=HOLD & Q=WTR Common Parameters |--+---------------+--+-----------------------------+-----------> '-,--C--=--carr-' '-,--CH--=--+-tab-----------+-' | .-,---. | | V | | '-(----tab-+--)-' >--+-----------------+--+--------------------------+------------> '-,--CL--=--class-' '-,--CM--=--+-module-----+-' +-module,trc-+ '-NONE-------' >--+-----------------+--+---------------+-----------------------> '-,--CONS--=--con-' '-,--CP--=--nnn-' >--+--------------------+--+---------------+--------------------> '-,--DG--=--devgroup-' '-,--F--=--form-' >--+-------------------+--+------------------------+------------> '-,--FD--=--formdef-' '-,--FL--=--+-flash id-+-' '-NONE-----' >--+------------------------------------------+-----------------> +-,--J--=--+-jobname-+---------------------+ | '-jobno---' | '-,--J--=--+-jobname-+--+-,--DD--=--ddn--+-' '-jobno---' '-,--DSN--=--dsn-' >--+------------------+--+----------------------+---------------> '-,--ID--=--userid-' '-,--IP--=--+-Y------+-' +-N------+ '-ipaddr-' >--+-----------------+--+------------------------------+--------> '-,--NC--=--ncarr-' '-,--NCH--=--+-tab-----------+-' | .-,---. | | V | | '-(----tab-+--)-' >--+-------------------+--+-----------------------------+-------> '-,--NCL--=--nclass-' '-,--NCM--=--+-module-------+-' +-(module,trc)-+ '-NONE---------' >--+------------------------+--+---------------------------+----> '-,--NCP--=--+----+--nnn-' '-,--ND--=--+-node--------+-' +-+--+ '-node.remote-' +- --+ +-*--+ '-&--' >--+-----------------+--+------------------------+--------------> '-,--NF--=--nform-' '-,--NFD--=----formdef---' >--+-------------------------+--+-----------------------+-------> '-,--NFL--=--+-flash-id-+-' '-,--NIP--=--+-ipaddr-+-' '-NONE-----' '-NONE---' >--+----------------------+--+-----------------+----------------> '-,--NOB--=--+-nnnnn-+-' '-,--NP--=--nprty-' '-NONE--' >--+------------------------+-----------------------------------> '-,--NPD--=----pagedef---' >--+-----------------------------+--+------------------+--------> '-,--NPM--=--new process-mode-' '-,--NSS--=--+-C-+-' '-S-' >--+------------------+--+---------------------+----------------> '-,--NU--=--cucsid-' '-,--OB--=--+-nnnnn-+-' '-NONE--' >--+-------------------+--+-----------------+-------------------> '-,--PD--=--pagedef-' '-,--PM--=--value-' >--+--------------------+--+--------------------+---------------> '-,--S--=----nnnnn---' '-,--SL--=--seclabel-' >--+-----------------+--+------------------------+--------------> '-,--SS--=--+-C-+-' '-,--T--=--terminal name-' +-S-+ '-?-' >--+----------------+-------------------------------------------| '-,--U--=--train-'
Notes:
- Do not repeat a specific parameter within these parentheses. For example, you can code all three parameters separated by commas (S,O,U) or any combination of two of the parameters separated by a comma (S,O) or (S,U), or (O,U).
Parameters
- Q=TCP
- Specifies that writer-selection characteristics are to be modified for data sets on the output service TCP queue.
- Q=BDT
- Specifies that writer-selection characteristics are to be modified for data sets on the output service BDT queue (BDT).
- Q=HOLD
- Specifies that writer-selection characteristics are to be modified for data sets on the output service hold queue (HOLD).
- Q=WTR
- Specifies that writer-selection characteristics are to be modified for data sets on the output service writer queue (WTR).
- AGE=nnnn(D or H)
- Selects the network stream or SYSOUT stream by the minimum number of days (D) or hours (H) that it has been on the specified queue.
- APPC=Y|N|tpid
- Selects SYSOUT from APPC transaction programs (TPs) only (Y). Selects non-APPC TPs generated for SYSOUT only (N). Selects SYSOUT from a specific TP identifier (tpid). If APPC= is not specified, all work is selected and SYSOUT from APPC TPs is indicated by the string APPC.
- BG=group-id
- Selects the network job or SYSOUT streams by its group identifier.
- BT=JOB or SYSOUT
- Selects the network job or SYSOUT stream you want to modify.
- BY=nnnnnnnn or -nnnnnnn
- Specifies to select for modification data sets having a specified
number of bytes.
- nnnnnnnn (1 to 8 characters)
- Data sets with at least the specified number of bytes.
- -nnnnnnn (up to 7 characters in length)
- Data sets with no more than the specified number of bytes. For example, BY=-4096 selects data sets whose size in bytes does not exceed 4096.
- CANCEL or C
- Specifies that the output that matches the selection criteria
is to be canceled. You can substitute the character (C) as an abbreviation
for the CANCEL parameter. Note: When canceling work intended for the NJERDR, you must include the W=NJERDR keyword on the *F U,Q=HOLD,C command.
- C=carr
- Specifies to modify SYSOUT data sets having the designated carriage tape (FCB).
- CH=(tab[,tab...])
- Specifies to modify the SYSOUT data sets having the specified arrangement tables. SYSOUT data sets can contain up to four image name requirements. Parentheses must be entered as shown.
- CJ=Y or N or client-job-string
- Specifies to modify SYSOUT with spinoff job names only (Y). Selects SYSOUT without spinoff job names only (N). Selects SYSOUT whose spinoff job name or spinoff job id matches client-job-string only (client-job-string).
- CJID=Y or N or client-job-id
- Specifies to modify SYSOUT with spinoff job ids only (Y). Selects SYSOUT without spinoff job ids only (N). Selects SYSOUT with a specific spinoff job id only (client-job-id).
- CJNM=client-job-name
- Specifies to modify SYSOUT with a specific spinoff job name only.
- CL=class
- Specifies to modify data sets in the indicated output class (A to Z; 0 to 9).
- CM=module or (module,trc)
- Specifies to modify output requiring the designated copy modification module are to be modified; trc specifies the table reference character (0, 1, 2, or 3) used to select one of the character arrangement tables. Parentheses are not required if only the module name is specified.
- CONS=con
- Specifies the name of the console to which the response to this command is to be sent. If omitted, the response is sent to the console on which you entered the command.
- CP=nnn
- Specifies that the characteristics of output with the designated copy count are to be modified.
- D=dest
- Specifies that SYSOUT for the designated destination is to be modified.
- DD=ddn
- Specifies the ddname of the output data set whose writer-selection characteristics you want to modify. Specify ddn using procstepname.jobstepname.ddname. You must include a period for names that you omit (for example, ..JESYSMSG). The job must be specified (J=) if the DD= parameter is used. The DD= and DSN= keywords are mutually exclusive; that is, you cannot include both the DD= and DSN= keywords in the same command.
- DSN= dsn
- Displays a summary of output for the designated
data set (dsn) or displays a summary of output for all data sets of
a job (?). You must specify the job (J=) keyword. The DD= and DSN=
keywords are mutually exclusive; that is, you cannot include both
the DD= and the DSN= keywords on the same command. When specified, DSN can be either a fully qualified data set name or only the data set number.
- When specifying the fully qualified data set name, use DSN=userid.jobname.jobid.datasetnumber.dsname. You must include all five qualifiers.
- When specifying only the data set number, use DSN=...datasetnumber Even though the first three qualifiers and the fifth qualifier are left out, the initial separator periods are still required. The final trailing separator period is not required.
- DG=devgroup
- Specifies that writer-selection characteristics are to be modified
for data sets created by jobs submitted from the designated device
group or destined for an output device in the designated group. Device
group names are assigned during JES3 initialization. Note: The DG= parameter cannot be issued from a remote workstation or from NJE.
- DSID =ddid
- Specifies that the output characteristics for data sets destined for the 3540 diskette device identifier are to be modified.
- F=form
- Specifies that writer-selection characteristics for output that requires the designated form name are to be modified.
- FD=formdef
- Specifies that writer-selection characteristics of output requiring the designated formdef are to be modified.
- FL=flash-id
- Specifies that writer-selection characteristics of output requiring the designated flash (forms overlay) name are to be modified.
- H=S|SYS and O|OPER and U|USER or Y or N
- Specifies the data sets placed in the hold state by the system
(S|SYS), operator (O|OPER), or user (U|USER). S|SYS, O|OPER and U|USER
are mutually independent, so you can specify one or more of these
hold types in any order. You cannot specify S|SYS, O|OPER or U|USER
with Y or N.
Y selects jobs or SYSOUT data sets that are being held and N selects jobs or SYSOUT data sets that are not being held. Y or N are mutually exclusive; that is, you can only specify one of these operands. You cannot specify Y or N with S|SYS, O|OPER or U|USER.
- GT=PRT or PUN
- Specifies the general type of output whose writer-selection characteristics are to be modified: print data sets (PRT), or punch data sets (PUN).
- ID=userid
- Specifies that writer-selection characteristics are to be modified for data sets on the output service queue.
- IP=Y or N or ipaddr
- Specifies the inclusion of data sets with (Y) or without (N) an IP address. Specifies selection of a data set using a specific IP address (ipaddr). The IP variable is case sensitive and must be enclosed in quotation marks.
- J=jobname or jobno
- Specifies the network job whose writer-selection characteristics are to be modified. If omitted, the output from all jobs is affected.
- L=nnnnnnnn or -nnnnnnn
- Specifies to select for modification data sets having a specified
number of lines.
- nnnnnnnn (1 to 8 characters)
- Data sets with at least the specified number of lines.
- -nnnnnnn (up to 7 characters in length)
- Data sets with no more than the specified number of lines. For example, L=-1000 selects data sets whose line count does not exceed 1000.
- N=nnn or ALL
- Specifies the number of jobs (1 to 999999) or all jobs (ALL) that are to be affected by the command. If N= is not specified, ten jobs are assumed.
- NC=carr
- Specifies that the selected data set be assigned the new carriage tape(FCB).
- NCH=(tab[,tab...])
- Specifies that defined output is to be reassigned the designated new character arrangement table requirement. Output data sets can contain up to four image name requirements. Parentheses must be entered as shown.
- NCL=class
- Specifies that the defined output is to be assigned a new output class.
- NCM=module or (module,trc) or NONE
- Specifies that the defined output is to be reassigned a new copy modification module; trc specifies the table reference character (0, 1, 2, or 3) used to select one of the character arrangement tables. NONE specifies that the defined output is reassigned with no copy modification module.
- NCP=+ or - or * or &
- Specifies that existing copy count is to be added (+), subtracted
(-), multiplied (*), or divided (&) by a factor of nnn. If omitted,
the copy count is set to the amount designated by nnn.
For data sets routed to an AFP: if copy grouping is in effect for the data set, an increase or a decrease in the copy count affects only the last copy group or groups.
- ND=node or node.remote
- Specifies that the defined output is to be scheduled to a new
destination. Designate a specific destination by node and secondary
destination (device or remote workstation).
If you specify “ND=nodename” on the *MODIFY command for jobs on the writer queue, the secondary destination, if specified, is unchanged.
If you specify “ND=nodename.”, the system uses hexadecimal zeros for the secondary destination.
If you specify “ND=nodename” for jobs on the hold queue and the DD statement for the job or its equivalent also specifies an external writer, the system uses the name of the external writer as the secondary destination. If the OUTPUT statement specifies the external writer, the system uses hexadecimal zeros for the secondary destination.
- NDSID =ddid
- Specifies the new data set diskette device identifier. Use this parameter to modify the output characteristics for the data set destined for the new data set diskette device identifier.
- NF=form
- Specifies that the defined output is to be put on the new forms.
- NFD=formdef
- Specifies that the selected output is to be assigned a new FORMDEF. formdef is a 1-to-6 alphanumeric or special character ($, #, @) variable that specifies a library member containing FORMDEF information.
- NFL=flash-id or NONE
- Specifies that the defined output is to be reassigned a new flash (forms overlay) requirement or with no flash (forms overlay) requirement.
- NH=Y or N
- Places SYSOUT in operator hold (Y), or releases held output (N).
Note: Some spinoff data sets may print out of order when released from hold status because of their reuse of JDS entries.
- NIP=ipaddr or NONE
- Modifies an IP address. If an IP address is to be changed or added, specify ipaddr. The IP address (ipaddr) is case sensitive must be enclosed in quotation marks. If an IP address is to be deleted, specify IP=NONE.
- NOB=nnnnn or NONE
- Specifies that the defined output is to be sent to the designated printer output bin (ID 00001 through 65535). NONE specifies that the defined output is reassigned with no printer output bin ID.
- NP=prty or +nnn or -nnn
- Specifies that the defined output is to be reassigned a new output
scheduling priority. You can also specify a plus (+) to select priorities
to be added to the current list or a minus (-) to select priorities
to be deleted from the current list.
Note that even if you increase the priority, it will not exceed 255, and if you decrease the priority, but will never become negative (0 is lowest value).
- NPD=pagedef
- Specifies that the selected output is to be assigned a new PAGEDEF. pagedef is a 1-to-6 alphanumeric or special character ($, #, @) variable that specifies a library member containing PAGEDEF information.
- NPM=new process-mode
- Specifies that the defined output is to be reassigned a new process mode.
- NQ=HOLD
- Specifies that the defined output is to be placed on the output service hold queue.
- NSS=C or S
- Specifies that the defined output is to be reassigned as continuously stacked (C) or burst into separate sheets (S). The NSS= parameter is valid only if the burster-stacker-trimmer feature is defined for the device.
- NST=devtype or NONE
- Specifies that the defined output is to be scheduled to a new specific device, such as a particular 1403, 2540, 3203, or 3211, or to any device of the same general type as the device specified in the ST= parameter. If you specify NONE, PRT is the default.
- OB=nnnnn or NONE
- Specifies that the writer-selection characteristics for output assigned to the designated printer output bin ID (00001 through 65535) are to be modified. NONE specifies that the defined output is reassigned with no writer selection characteristics. NONE specifies that only output with no printer output bin ID is to be modified.
- NH=N or Y
- Use the NH (new hold) keyword parameter to change the hold status of a network job or SYSOUT stream. You can issue the NH= keyword only for work in an inactive state (BS=INACTIVE).
NOUTDISP=H|HOLD or K|KEEP or L|LEAVE or W|WRITE
- Modifies the output disposition of the selected data sets.
- NQ=WTR
- Specifies that the defined output is to be placed on the output service writer queue.
- NU=ucsid
- Specifies that the defined output is to be scheduled to another train (UCS).
- NW=extwriter
- Specifies that the defined output is to be reassigned
to the new designated external writer.
If you specify NW=*, the defined output is reassigned to the standard external writer. The following external writer names are not valid; NJERDR, INTRDR, and STDWTR.
- OUTDISP=H|HOLD or K|KEEP or L|LEAVE or W|WRITE or N|NONE
- Selects in the output queue with the specified output disposition.
- P=prty
- Selects the network job or SYSOUT stream by its priority.
- PD=pagedef
- Specifies that writer-selection characteristics of output requiring the designated pagedef are to be modified.
- PG=nnnnnnnn or -nnnnnnn
- Specifies to select for modification data sets having a specified
number of pages.
- nnnnnnnn (1 to 8 characters)
- Data sets with at least the specified number of pages.
- -nnnnnnn (up to 7 characters in length)
- Data sets with no more than the specified number of pages. For example, PG=-500 selects data sets whose page count does not exceed 500.
- PM=value or /value
- Specifies that writer-selection characteristics are to be modified for data sets that have the specified process mode.
- S=nnnnn
- Specifies the sequence number of the data set whose writer-selection characteristics you want to modify. Only use this parameter if different data sets use identical ddnames. Sequence numbers are assigned on a first-in-first-out (FIFO) basis. This keyword can only be used when using the DD= keyword.
- SL=seclabel
- Specifies that only those output data sets with the designated security label (seclabel) are to be modified.
- S
- Specifies that only a summary message (IAT8118 or IAT8119) be displayed on the console. Other messages will be written to the hardcopy log. If you omit S, all messages are written to both the console and the hardcopy log.
- SS=C or S
- Specifies that writer-selection characteristics of output to be continuously stacked (C) or output to be burst into separate sheets (S) are to be modified. The SS= parameter is valid only if the burster-stacker-trimmer feature is defined for the device.
- ST=devtype
- Specifies that writer-selection characteristics for output scheduled for the specific device type, such as 1403, 2540, 3203, 3211 are to be modified.
- T=terminal name
- Specifies that writer-selection characteristics are to be modified for data sets created by jobs submitted from the designated RJP terminal.
- TG=? or group-id
- Selects the network job or SYSOUT stream by its group identifier.
- TT=? or JOB or SYSOUT
- Selects network job streams only (JOB) or SYSOUT streams only (SYSOUT) to modify.
- U=ucsid
- Specifies that writer-selection characteristics for output that requires the designated train (UCS) are to be modified.
- W=extwriter
- Specifies that the characteristics of output destined to the designated external writer are to be modified.
Rules
- If you specify more than one operand for H=S|SYS and O|OPER and U|USER, you must use parentheses. Parentheses are optional if you specify only one operand. If you specify H=Y or N only one operand is allowed.
- JES3 cannot include all of the new output characteristics in the
new data set if all of the following are true:
- You are moving a data set from the output service hold queue to the output service writer queue.
- The data set was originally built from an //OUTPUT JCL statement.
- You specify either the NQ= or the NCL= keyword.
- The use of IP=ipaddr, FD=, and PD= will cause extra I/O to be performed and could affect performance. When possible, use the J= keyword to limit the search to one job or the N= keyword to limit the number of jobs processed.
- Adding a new IP address to SYSOUT on the HOLD queue could result in the loss of the IP address. This will occur if the following are true:
- //*FORMAT statements exist.
- The modify command includes NQ=WTR.
If //*FORMAT statements exist when moving SYSOUT from the HOLD queue to the WRITER queue, the SYSOUT is recycled through Output Service to build a new OSE from the modified JDS. An SWB FDB cannot be dynamically added to a JDS as the job could still be active on MAIN creating additional SYSOUT with OUTPUT JCL statements. This requires a reference number to be created to match a JDS with an OSE. Therefore, the SWB FDB created for the original OSE is lost.
Examples
The following reroutes all output
on the output service queue belonging to job MYJOB to remote WS001
at node NODE5:
*F U Q=WTR,J=MYJOB,ND=NODE5.WS001The
following reroutes the job USERSTUF for the data set associated with
the specified ddname (STEP1.SYSUT2) to remote WS001 at node NODE5:
*F U,Q=WTR,J=USERSTUF,ND=NODE5.WS001,DD=.STEP1.SYSUT2Cancel output for a particular job destined for a TCP/IP
connected node:
*MODIFY,U,Q=TCP,J=1247,D=NODE2,C