$T O Job - Set output characteristics
Function
To set the output characteristics for one or more job output elements belonging to one or more specified jobs.
Syntax
Parameters
- output
- Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of jobs whose job name matches this combination of characters (mask).
- ‘output'
- The name of the job that is to be set. This name must appear as coded on the JOB statement and must be enclosed in apostrophes. If more than one job exists with this name, no action is taken.
- Job
- A Batch job or range of batch jobs is to be set.
- JOBQ|JQ
- Specifies all jobs, STCs, and TSUs across the MAS for processing.
- Stc
- A started task or range of started tasks is to be set.
- Tsu
- A time-sharing user or range of time-sharing users is to be set.
- Age|DAys<days | Age|DAys>days
- Specifies the age of affected output in days. Only output more (with DAYS>nn) or less (with DAYS<nn) than the specified number of days in age are affected. The days are counted from the current hour.
- ALL
- JES2 modifies
the specified job's output elements based on the presence of filters
as follows:
ALL specified? Filters? Meaning YES YES Command is rejected YES NO Command applies to all job output elements belonging to the specified job NO YES ALL is not considered NO NO Command applies to all job output elements belonging to the specified job - B|BURST={No|Yes}
- Specifies whether the printed output is to be burst into separate sheets (Yes) or to be in continuous, fanfold mode (No).
- CC=(ABEND|ABENDED|CANcelled|CNVT_abend|CODE|COMPleted|
- ENDed_by_cc|EOM_failure|JCLerror|FLUSHED|SECurity_failure|TYPE)
- Specifies the completion information
associated with the job.
- ABENDED
- Specifies only jobs which have abnormally ended.
- ABEND
- Specifies the ABEND code associated with the job's termination.
- CANcelled
- Specifies only jobs which were cancelled by the operator.
- CNVT_abend
- Specifies only jobs which have abnormally ended during the conversion phase.
- CNVT_ERROR
- Specifies job that failed due to a converter error.
- CODE
- Specifies the last (or highest) completion code of steps in the job.
- COMPleted
- Specifies only jobs which completed.
- ENDed_by_cc
- Specifies only jobs which were ended by a step completion code.
- EOM_failure
- Specifies only jobs which failed in end-of-memory processing.
- FLUSHED
- The job was cancelled (flushed) and is no longer eligible to run.
- JCLerror
- Specifies jobs which did not execute due to a JCL error.
- SECurity_failure
- Specifies jobs which failed security validation.
- SYSTEM_FAILURE
- Specifies jobs that failed due to system failure.
- C|FCB={xxxx|****}
- A 1 to 4 alphanumeric character or special character ($ # @) identifier for the data set forms control or carriage specifications. Four asterisks (****) specifies that the output group is to be reset to the default setting specified by the installation.
- Dest|Routecde=dest
- The destination assigned to the job output
element(s). You may specify a remote destination (workstation), another node, or a specific local
device. The value for all routing numbers can range from 1 to 32767. For more information about
valid specifications, see Route codes.
If this command originates from another node in the network and the D|ROUTECDE= operand does not specify a node (first-level destination), the receiving node defaults the first-level destination to the node where the command originated.
If this command is sent to another node in the network using the $N command, be aware that the receiving node defaults the node (first-level destination) of Dest|ROUTECDE= operand to the sending node. If another node is wanted, specify a destination on the Dest|ROUTECDE= operand that resolves to the wanted node (first-level destination) at the receiving node.Note:- If an output group is queued for transmission and an operator changes its destination, the user ID portion of the routing is lost. If an output group is interrupted while printing and the destination is changed, the output group begins printing from the top when it is printed at the new destination.
- NODENAME=REQUIRED on the DESTDEF initialization statement causes JES2 to require that a user ID be prefixed with a node name.
- Greater than (> or >=) and less than (< or <=) filters may be used in conjunction to
support route code ranges. For example, you could specify the filters R>=R1,R<=R7 to affect
output for all remotes in the range R1 to R7, Note that:
- The destination being filtered upon is converted to its binary equivalent before the comparison.
- Open-ended ranges (for example, a > filter without a < filter, or a < filter without a > filter) are not allowed.
- When using nodal ranges, a specification of "nodename.*" must be used. Only the nodal routing of the output is compared.
- The following specifications
are valid:
- LOCAL|ANYLOCAL
- Indicates that jobs are to be printed or punched at the local node.
- destid
- Indicates that jobs are to be printed or punched at the specified node(s). You can specify this location by an alias for the name of a node. If destid is specified alone, it refers to both the node and the remote.
- Nnnnn|nodename
- Indicates that jobs are to be printed or punched at the specified node(s). You can specify a node using the decimal node identifier or an EBCDIC nodename.
- NnnnnRmmmm|node.remote|node.userid
- Indicates routing to the remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.
- Ummmm
- Indicates special local routing.
- node.destid
- Indicates a destination at the specified node. The destid refers
to both the node and the remote. The node specified in the destid
must be the same as the node portion of the route code. If the number
of the remote is reassigned, you can use the destid to send to this
node.
- remote
- Indicates routing to a remote. Remote can be specified in any of the following ways:
- LOCAL|ANYLOCAL
- Indicates that jobs are to be printed or punched at the local node.
- Rmmmm
- Indicates routing to the specified remote. Rmmmm can also be specified as RMmmmm or RMTmmmm.
- destid
- Indicates routing to a destid referring to a remote.
- userid
- Indicates routing to a valid TSO user ID.
- node.*
- Indicates that the node name is to be modified to the specified node name, but the remote name remains the same.
- *
- Indicates that the node name is to be modified to the local node name, but the remote name remains the same.
- F|Forms={xxxxxxxx| ****}
- A 1 to 8 alphanumeric or special character ($ # @) identifier for the print or punch forms. Four asterisks (****) specifies that the output group is to be reset to the default setting specified by the installation.
- FLASH|O={xxxx|****}
- A 1 to 4 alphanumeric or special character ($ # @) overlay name (FLASH). Four asterisks (****) specifies that the output group is to be reset to the default setting specified by the installation.
- H|Hours>hours | H|Hours<hours
- Specifies the age of affected output in hours. Only output more (with HOURS>nn) or less (with HOURS<nn) than the specified number of hours in age are affected.
- HELD
- Output is HELD if it is destined for this node and the output disposition is HOLD or LEAVE.
- HOLD={-OPER|-SYS|NONE|OPER}
- This
operand explicitly sets the operator HOLD type. The only hold type
that can be set using this operand is OPER. This parameter prevents
JES2 from selecting an output group for any processing other than
purging. Specifying HOLD= for an output group is more restrictive
than specifying an output group's output disposition. OUTDISP=HOLD
or LEAVE prevents JES2 from selecting an output group for print/punch
or external writer processing only.
Specifying the REL= parameter on this command makes the output available for processing.
- HOLDRC
- Job characteristics are only assigned to objects with the specified hold reason codes.
- JC|JOBCORR=job correlator
- Specifies a combination of 1-64 alphanumeric, special (colon, period or underscore) and wildcard characters that can be used to select a subset of jobs that have a matching job correlator. For a description of wildcard characters, refer to Using wildcards.
- JOBGROUP=jobgroupname
- Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of jobs whose job group name matches this combination of characters (mask).
- JOBMASK|JM=xxxxxxxx
- Specifies 1 to 8 alphanumeric,
special ($, #, or @) or wildcard characters (or a combination of them)
that can be used to select a subset of jobs whose job name matches
this combination of characters (mask). For a description of wild cards,
see Using wildcards. Note:
- This is a positional parameter. Specify this following the job_id (JOB, STC, or TSU) or JOBQ parameter.
- The JOBMASK parameter is not valid with the ‘jobname ' parameter.
- OUTDISP={H|HOLD|K|KEEP|L|LEAVE|P| PURGE|W|WRITE}
- As a modification keyword, OUTDISP= indicates what the new output
disposition should be for the specified job's output. Specify WRITE,
HOLD, LEAVE, KEEP, or PURGE.
As a selection limiting keyword, OUTDISP= indicates that you want to modify the output for the specified job that matches this current disposition. Specify, WRITE, HOLD, LEAVE, or KEEP.
Note: If you do not specify this parameter, all output with a disposition of WRITE, HOLD, KEEP, or LEAVE is modified. - OUTGrp=grpid[.joeid1[.joeid2]]
- The
job output element(s) that are modified.
- grpid
- The 1 to 8 character alphanumeric group ID that is either specified by the user in the JCL or generated by JES2. If you specify only group ID (OUTGRP=grpid) on this command, JES2 modifies all the job output elements in that group.
- joeid1
- A number assigned by JES2 to distinguish between job output elements within the output group. If you specify only group ID and the first qualifier (OUTGRP=grpid.joeid1) on this command, JES2 modifies all copies of the specified job output element in that group.
- joeid2
- A number assigned by JES2 to distinguish between several copies of grpid.joeid1. If you specify group ID and both qualifiers (OUTGRP=grpid.joeid1.joeid2) on this command, JES2 modifies only the specified copy (joeid2) within the job output element (joeid1) in that group.
Note: This parameter is positional and must immediate follow the jobid (JOB, STC, TSU), JOBQ or ‘jobname' (or JOBMASK if coded) parameter. - OFFS=(n[,n,n])|(+n,[n,n])|(-n,[n,n])|0
- Specifies
updates to the archival status of sysout for this job. Output will
be marked as already offloaded for all offload device numbers that
were specified and as not offloaded for all offload device numbers
not specified.
Specifying + or - before the offload device number(s) updates offload status of the output for only the specified offload device numbers. Specifying + marks the output as offloaded and specifying - marks it as not having been offloaded. Use this option to allow offloading of output that have been already been offloaded or to prevent offloading of certain output.
- P|PRIORITY=nnn
- The queue selection priority (0-255) assigned to the job output element(s).
- PAGEs=pages
- Only jobs with the specified number of pages of output are modified.
- PRMode=vvvvvvvv
- The process mode (1 to 8 alphanumeric characters) for the job output element(s).
- Q|QUEUE=c
- The output class (A-Z and 0-9) assigned to the job output element(s).
- READY
- Output is READY if it is not HELD.
- REBUILD={No|Yes}
- Output on the rebuild queue is to be set (Yes) or not set (No).
- RECORDS=records
- Only output groups with the specified number of records are to be modified.
- REL|RELease={ALL|SYS|OPER}
- The operand used to explicitly clear one or more HOLD types. If you are only specifying one type, you may drop the parentheses. Parentheses are required, however, when you specify more than one type. You may use this operand to clear all HOLD types (OPER and SYS). In addition, you may use the type “ALL” to clear all holds applied against the specified output group(s).
- SECLABEL=seclabel
- Only output groups with the specified security label are to be modified.
- TPJOBID=jobid
- Only output groups with the specified transaction job ID are to be modified.
- TPJOBN=jobname
- Only output groups with the specified transaction job name are to be modified.
- TSOavail={No|Yes}
- Only output which is (Yes) or is not (No) eligible for the TSO OUTPUT command is to be modified.
- USERID=userid
- Only output groups associated with the specified user ID are to be modified.
- T|UCS={xxxx|****}
- A 1 to 4 character alphanumeric or special character ($ # @) identifier for the universal character set specification. This will also set the character set (CHAR1) to be used on Non-Impact printers unless the UCS and CHARS values are both assigned to an output data set by a job's JCL and their values are not equal. Four asterisks (****) specifies that the output group is to be reset to the default setting specified by the installation.
- W|Writer={xxxxxxxx|****}
- A 1 to 8 alphanumeric or special ($ # @) character write name assigned to the job output element(s). Four asterisks (****) specifies that the output group is to be reset to a null value.
Authority Required
This command requires job authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.
This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Processing Considerations
- If you use this command to change both the destination and other output characteristics, those changes to the other output characteristics are ignored for duplicate output groups (those groups created by specifying more than one job copy or by issuing the $N command to repeat the processing of an output group).
- If any of the characteristics that you specify on this command are also specified as work selection criteria with the WS= parameter on the device initialization statement or using the $T device command, then those characteristics are compared against the matching output device specifications; work is selected accordingly.
- If the following characteristics are modified, the output group
begins printing from the top when the output starts printing again.
- Burst
- FCB
- Destination
- Form
- Overlay (Flash)
- Process mode(PRMODE)
- UCS
- Writer name
- Once a held output group has been released (the output disposition is changed to WRITE or KEEP), the group is no longer available for processing by the TSO/E OUTPUT command. For more information, see the $HASP686 message in z/OS JES2 Messages.
Scope
MAS-wide. This command has an effect across the entire MAS.
Messages
The $HASP686 message displays the current output characteristics for each job output element specified.
Examples
1 $t o j17,/outgrp=group2,/outdisp=write,outdisp=hold
JOB00017 $HASP686 OUTPUT(D15USER) OUTGRP=GROUP2.2.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686 HOLDRC=,OUTDISP=HOLD,PAGES=,
$HASP686 PRIORITY=144,PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(1 OF 1),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
$HASP686 USERID=D15USER,WRITER=
2 $t o j12,all,hold=oper
JOB00012 00000090 $HASP686 OUTPUT(D15USERC) OUTGRP=2.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(OPER),
$HASP686 HOLDRC=,OUTDISP=WRITE,PAGES=,
$HASP686 PRIORITY=144,PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(38 OF 38),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
$HASP686 USERID=D15USER,WRITER=
$HASP686 OUTPUT(D15USERC) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(OPER),
$HASP686 HOLDRC=,OUTDISP=WRITE,PAGES=,
$HASP686 PRIORITY=144,PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(1 OF 1),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
$HASP686 USERID=D15USER,WRITER=
3 $T O J1-*,JM=IB*,OUTGRP=1.1.1,/OUTDISP=WRITE,OUTDISP=HOLD
JOB00102 $HASP686 OUTPUT(IBMUSERX)
$HASP686 OUTPUT(IBMUSERX) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686 HOLDRC=,OUTDISP=HOLD,PAGES=,
$HASP686 PRIORITY=128,PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(2139 OF 2139),
$HASP686 ROUTECDE=LOCAL,SECLABEL=,TSOAVAIL=NO,
$HASP686 UCS=****,USERID=IBMUSER,WRITER=
JOB00104 $HASP686 OUTPUT(IBMUSERY)
$HASP686 OUTPUT(IBMUSERY) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686 HOLDRC=,OUTDISP=HOLD,PAGES=,
$HASP686 PRIORITY=128,PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(2139 OF 2139),
$HASP686 ROUTECDE=LOCAL,SECLABEL=,TSOAVAIL=NO,
$HASP686 UCS=****,USERID=IBMUSER,WRITER=
4 $T O JOB,OFFS=+4
JOB00104 $HASP686 OUTPUT(IBMUSERY)
$HASP686 OUTPUT(IBMUSERY) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=PUNCH,HOLD=(NONE),
$HASP686 OFFS=(3,4),OUTDISP=WRITE,PRIORITY=7,
$HASP686 PRMODE=LINE,QUEUE=B,
$HASP686 RECORDS=(14 OF 14),
$HASP686 ROUTECDE=LOCAL,SECLABEL=,TSOAVAIL=NO,
$HASP686 UCS=****,USERID=IBMUSER,WRITER=,
5 .TOJ17,/OUTDISP=WRITE,OUTDISP=HOLD
JOB00017 .HASP686 OUTPUT(D15USER) OUTGRP=1.1.1,BURST=NO,FCB=****,
.HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
.HASP686 OUTDISP=HOLD,PRIORITY=144,
.HASP686 PRMODE=LINE,QUEUE=A,
.HASP686 RECORDS=(50 OF 50),ROUTECDE=LOCAL,
.HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
.HASP686 USERID=IBMUSER,WRITER=
6 .TOJ17,OUTDISP=HOLD
JOB00017 .HASP686 OUTPUT(D15USER)
.HASP686 OUTPUT(D15USER) OUTGRP=1.1.1,BURST=NO,FCB=****,
.HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
.HASP686 OUTDISP=HOLD,PRIORITY=144,
.HASP686 PRMODE=LINE,QUEUE=A,
.HASP686 RECORDS=(50 OF 50),ROUTECDE=LOCAL,
.HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
.HASP686 USERID=IBMUSER,WRITER=
JES2 assigns an OUTDISP value of HOLD to all the job output element(s) that belong to batch job 17.
7
$tojq1-*,days>1,forms=dora
STC00003 $HASP686 OUTPUT(IRRDPTAB)
$HASP686 OUTPUT(IRRDPTAB) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=DORA,HOLD=(NONE),
$HASP686 OUTDISP=WRITE,PRIORITY=144,
$HASP686 PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(53 OF 53),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
$HASP686 USERID=++++++++,WRITER=
JES2 changes form for any job on output queue with days greater than 1.
8
$tos1-*,hours>1,hold=oper
STC00003 $HASP686 OUTPUT(IRRDPTAB)
$HASP686 OUTPUT(IRRDPTAB) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=DORA,HOLD=(OPER),
$HASP686 OUTDISP=WRITE,PRIORITY=144,
$HASP686 PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(53 OF 53),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TSOAVAIL=NO,UCS=****,
$HASP686 USERID=++++++++,WRITER=
JES2 changes hold type on any started task with hours greater than 1.
9
$to s'aschint',/tpjobn=testjob,/tpjobid=a0000014,forms=std
STC00017 $HASP686 OUTPUT(ASCHINT)
$HASP686 OUTPUT(ASCHINT) OUTGRP=TESTJOB.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686 OUTDISP=WRITE,PRIORITY=144,
$HASP686 PRMODE=LINE,QUEUE=A,RECORDS=(2 OF 2),
$HASP686 ROUTECDE=PRTB03,SECLABEL=,
$HASP686 TPJOBID=A0000014,TPJOBN=TESTJOB,
$HASP686 TSOAVAIL=NO,UCS=****,USERID=MYUSERID,
$HASP686 WRITER=
JES2 changes forms for the transaction job name of TESTJOB and transaction job ID of A0000014 to STD.
10 $t o j(120-130),jc=*:*clientxyz*,outdisp=hold
JOB00122 $HASP686 OUTPUT(BILLING) C
$HASP686 OUTPUT(BILLING) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686 OUTDISP=HOLD,PRIORITY=144,
$HASP686 PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(48 OF 48),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TPJOBID=,TPJOBN=,
$HASP686 TSOAVAIL=NO,UCS=****,USERID=IBMUSER,
$HASP686 WRITER=
JOB00127 $HASP686 OUTPUT(MAILING) C
$HASP686 OUTPUT(MAILING) OUTGRP=1.1.1,BURST=NO,FCB=****,
$HASP686 FLASH=****,FORMS=STD,HOLD=(NONE),
$HASP686 OUTDISP=HOLD,PRIORITY=144,
$HASP686 PRMODE=LINE,QUEUE=A,
$HASP686 RECORDS=(48 OF 48),ROUTECDE=LOCAL,
$HASP686 SECLABEL=,TPJOBID=,TPJOBN=,
$HASP686 TSOAVAIL=NO,UCS=****,USERID=IBMUSER,
$HASP686 WRITER=
JES2 assigns an OUTDISP value of HOLD to all job output elements for batch jobs within the job number range 120-130 that have a job correlator user portion containing CLIENTXYZ.