|
Function To release or cancel held output
groups. An output group (or job output element) with an output disposition
of HOLD or LEAVE that is not routed to another node is ‘held'.
All output groups routed to other nodes, regardless of disposition,
are considered ‘ready' at this node because output is not held
until it reaches its destination.
Syntax
>>-$O--+-Job--+--+--------------------------------------+------->
+-JOBQ-+ +-nn--+------------+-------------------+
+-JQ---+ | '- ---+-mm-+-' |
+-Stc--+ | '-*--' |
'-Tsu--' +-'--output--'-------------------------+
| .-,--------------------------. |
| V | |
'-(----+-+-nn-+--+------------+-+-+--)-'
| '-*--' '- ---+-mm-+-' |
| '-*--' |
+-output-----------------+
'-'--output--'-----------'
>--+---------------+--+------------------+---------------------->
'-,--+---+--ALL-' '-,--+---+--CANcel-'
'-/-' '-/-'
>--+--------------------+--------------------------------------->
'-,--Burst=--+-NO--+-'
'-YES-'
>--+-----------------------------------+------------------------>
'-,--CC--+------------------------+-'
| .-,---------. |
| V | |
'-=--( ---+-ABEND-+-+--)-'
+-CODE--+
'-TYPE--'
>--+--------------------+--+------------------------+----------->
'-,--+-C---+--=--fcb-' '-,--+-FLash-+--=--flash-'
'-FCB-' '-O-----'
>--+------------------+--+------------------------+------------->
'-,--Forms=--forms-' '-,--PRIORITY=--priority-'
>--+--------------------+--+----------------------+------------->
'-,--PRmode=--prmode-' '-,--RECORDS=--records-'
>--+------------------------+--+--------------------+----------->
'-,--SECLABEL=--seclabel-' '-,--+-T---+--=--ucs-'
'-UCS-'
>--+--------------------+--+--------------------+--------------->
'-,--USERID=--userid-' '-,--Writer=--writer-'
>--+--------------------------------------------------------+--->
'-,--+---+--CMDauth--+-=--+--+-cmdauth-----------------+-'
'-/-' '-^=-' | .-,-------------. |
| V (1) | |
'-(----------cmdauth-+--)-'
>--+---------------------------------+-------------------------->
'-,--+-+---+--Age--+--+->-+--days-'
| '-/-' | '-<-'
'-+---+--DAys-'
'-/-'
>--+-------------------------------+---------------------------->
'-,--+---+--Hours--+->-+--hours-'
'-/-' '-<-'
>--+----------------------------------------+------------------->
'-,--+-+---+--JM------+--+-=--+--jobmask-'
| '-/-' | +-^=-+
'-+---+--JOBMASK-' +->--+
'-/-' '-<--'
>--+----------------------------------+------------------------->
'-,--+---+--OUTGrp--+-=--+--outgrp-'
'-/-' '-^=-'
>--+--------------------------------+--------------------------->
'-,--+---+--PAGES--+-=--+--pages-'
'-/-' +-^=-+
+->--+
'-<--'
>--+---------------------+-------------------------------------->
'-,--+---+--PROTected-'
'-/-'
>--+--------------------------------+--------------------------->
'-,--+---+--Queue--+-=--+--queue-'
'-/-' '-^=-'
>--+------------------------------------+----------------------->
'-,--+---+--REBUILD--+-=--+--+-No--+-'
'-/-' '-^=-' '-Yes-'
>--+------------------------------------+----------------------->
'-,--+---+--RECORDS--+-=--+--records-'
'-/-' +-^=-+
+->--+
'-<--'
>--+----------------------------------+------------------------->
'-,--+---+--TPJOBID--+-=--+--jobid-'
'-/-' +-^=-+
+->--+
'-<--'
>--+-----------------------------------+------------------------>
'-,--+---+--TPJOBN--+-=--+--jobname-'
'-/-' +-^=-+
+->--+
'-<--'
>--+------------------------------------------+----------------->
'-,--+-+---+--Dest-----+--+-=--+--routecde-'
| '-/-' | +-^=-+
'-+---+--Routecde-' +->--+
'-/-' '-<--'
>--+---------------------------------+-------------------------><
'-| Selection limiting keywords |-'
Selection limiting keywords
|--+-----------------------------------------------+------------|
'-,--+-+---+--JC------+--+-=--+--job correlator-'
| '-/-' | +-^=-+
'-+---+--JOBCORR-' +->--+
'-/-' '-<--'
Notes: - cmdauth can be coded up to 2 times
Parameters - 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 is affected. The days are
counted from the current hour. The creation time used to compute the
age of the output is the time the output was originally created or
the time the output was SPOOL reloaded. CRTIME=RESET is specified
on the corresponding OFFLOAD(x) statement.
- ALL
- The Held
output in all classes is released or cancelled. The ALL operand and
the Q=keyword are mutually exclusive.
- Burst={No|Yes}
- Specifies
whether the printed output is to be burst into separate sheets (Yes)
or to be in continuous, fanfold mode (No).
- CANcel
- JES2
cancels all of the selected held output.
Note: If CANCEL
is not specified on the $O command, the output will not be deleted,
but only released, meaning that it will be moved from the HELD to
OUTPUT queue.
- CC=(ABEND|ABENDED|CANcelled|CNVT_abend|CODE| COMPleted|ENDed_by_cc|EOM_failure|JCLerror|
SECurity_failure|TYPE)
- Displays
the completion information associated with the job.
- ABENDED
- Display only jobs which have abnormally ended.
- ABEND
- Displays the ABEND code associated with the job's termination.
- CANcelled
- Display only jobs which were cancelled by the operator.
- CNVT_abend
- Display only jobs which have abnormally ended during the conversion
phase.
- CODE
- Displays the last (or highest) completion code of steps in the
job.
- COMPleted
- Display only jobs which completed.
- ENDed_by_cc
- Display only jobs which were ended by a step completion code.
- EOM_failure
- Display only jobs which failed in end-of-memory processing.
- JCLerror
- Display jobs which did not execute due to a JCL error.
- SECurity_failure
- Display jobs which failed security validation.
- C|FCB=fcb
- A 1 to 4 alphanumeric character or special
character ($ # @) identifier for the data set forms control or carriage
specifications.
- CMDauth=(auth1{,auth2})
- Only
the output that can be affected from the specified remote(s) or node(s)
will be released. The valid specifications are:
- LOCAL|ANYLOCAL
- Only the local devices at the local node can affect the output.
- Nnnnn|nodename
- Only local devices at the specified node can affect the output.
- Rnnnn
- Only the specified remote device can affect the output.
- NnnnnRnnnn|nodename.Rnnnn
- Only the specified remote device at the specified remote node
can affect the output.
- destid
- A destid corresponding to any of the above remote devices.
Note: Specification
of the CMDAUTH filter does not override the authority of the console
from which the command is issued; both the authority of the console
and the specified CMDAUTH filter must match for the job to be affected.
- Dest|Routecde=routecde
- Specifies the destination to which the
output should be released. When preceded by a slash (/), it indicates
that only held output which has already been routed to this destination
should be released.
Note: - NODENAME=REQUIRED on the DESTDEF initialization statement will
cause JES2 to require that a userid 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 prior to the comparison.
- When using nodal ranges, a specification of "nodename.*" must
be used. Only the nodal routing of the output will be compared.
- FLASH|O=flash
- A 1 to 4 alphanumeric or special character
($ # @) overlay name (FLASH).
- Forms=forms
- A
1 to 8 alphanumeric or special character ($ # @) identifier for the
print or punch forms.
- 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 is affected. The creation
time used to compute the age of the output is the time the output
was originally created or the time the output was SPOOL reloaded.
CRTIME=RESET is specified on the corresponding OFFLOAD(x) statement.
- 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.
- JM|JOBMASK=jobmask
- 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 ‘output' parameter.
- Job
- A batch job
or range of batch jobs is to be released/cancelled.
- JOBQ|JQ
- Specifies all jobs,
STCs, and TSUs across the MAS for processing.
- OUTGrp=outgrp
- Specifies
the job output element(s) that are to be released or cancelled.
- 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 releases or cancels
all the held 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 releases or
cancels 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 releases or cancels only the specified copy
(joeid2) within the job output element (joeID) in that group.
- 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 released/cancelled. 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.
- PAGES
- Only
output groups with the specified number of pages are to be released
or cancelled.
- PRIORITY=priority
- The
queue selection priority (0-255) assigned to the job output element(s).
- PRmode=prmode
- The
process mode (1 to 8 alphanumeric characters) for the job output element(s).
- PROTected
- Indicates
that all specified output groups, including output groups that
have been specified ‘protected', should be purged. The 'protected'
attribute is assigned to programs running in a transactional environment
such as APPC or OMVS, where the transaction output is associated with
the initiators like ASCHINIT or BPXAS. The ‘protected' attribute
can also be assigned to jobs by JES2 installation exits. APPC output
is always protected. This parameter is only valid when used with
the CANCEL parameter.
Note: Since the OUTGRP= parameter identifies
the output to be cancelled, you do not need to specify PROTECTED with
this operand, even for output that is protected.
- Queue=queue
- The held
output in the specified output class(es) (A-Z and 0-9) is released
or cancelled. A maximum of 36 classes may be specified.
- REBUILD={No|Yes}
- Output
on the rebuild queue is to be released/cancelled (Yes) or not released/cancelled
(No).
- RECORDS=records
- Only
output groups with the specified number of records are to be released
or cancelled.
- SECLABEL=seclabel
- The
security label associated with the output group.
- Stc
- A started task
or range of started tasks is to be released/cancelled.
- Tsu
- A time-sharing
user or range of time-sharing users is to be released/cancelled.
- T|UCS=ucs
- A 1 to 4 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.
- TPJOBID=jobid
- Only
output groups with the specified transaction job ID are to be released
or cancelled.
- TPJOBN=jobname
- Only
output groups with the specified transaction job name are to be released
or cancelled.
- USERID=userid
- The
userid associated with the output group.
- Writer=writer
- A
1 to 8 alphanumeric or special character ($ # @) writer name assigned
to the job output element(s).
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, SA32-0991.
Processing Considerations Once a held output
group has been released, 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, SA32-0989.
Scope MAS-wide. This command has
an effect across the entire MAS.
Messages THE $HASP686 message is displayed
to indicate which output groups were released or cancelled by this
command.
Examples 1 $o j'payroll',q=abc,r=r2
JOB00213 $HASP686 OUTPUT(PAYROLL) OUTGRP=1.1.1 RELEASED
JOB00213 $HASP686 OUTPUT(PAYROLL) OUTGRP=8.1.1 RELEASED
JOB00213 $HASP686 OUTPUT(PAYROLL) OUTGRP=9.1.1 RELEASED
JOB00213 $HASP686 OUTPUT(PAYROLL) OUTGRP=24.1.1 RELEASED
JES2 releases all held output data sets in classes A,
B, and C, that belong to the batch job named PAYROLL, to remote work
station 2. Output data sets in other output classes are unaffected.
2 $o j'payroll',q=abc,/r=r2
JOB00213 $HASP686 OUTPUT(PAYROLL) OUTGRP=1.1.1 RELEASED
JOB00213 $HASP686 OUTPUT(PAYROLL) OUTGRP=9.1.1 RELEASED
JES2 releases all held output data sets in classes A,
B, and C, that belong to the batch job named PAYROLL and currently
specify a routing to remote workstation 2. Output data sets in other
output classes or destined for other remote work stations are unaffected.
3 $o j1-20,days>2 -or- $o j1-20,hours>48
JOB00003 $HASP686 OUTPUT(REPORT1) OUTGRP=1.1.1 RELEASED
JOB00003 $HASP686 OUTPUT(REPORT1) OUTGRP=2.1.1 RELEASED
JOB00004 $HASP686 OUTPUT(REPORT2) OUTGRP=1.1.1 RELEASED
.
.
.
JOB00020 $HASP686 OUTPUT(REPORT20) OUTGRP=11.1.1 RELEASED
JOB00020 $HASP686 OUTPUT(REPORT20) OUTGRP=12.1.1 RELEASED
JES2 releases all held output that is at least 2 days
old for batch jobs 1 through 20. 4 $o jq,q=abjk
JOB00020 $HASP686 OUTPUT(MYJOB) OUTGRP=1.1.1 RELEASED
JOB00037 $HASP686 OUTPUT(YOURJOB) OUTGRP=2.1.1 RELEASED
JES2 releases all held output data sets in classes A,
B, J, and K. 5 $o s'aschint',tpjobn=testjob,tpjobid=a0000014
STC00017 $HASP686 OUTPUT(ASCHINT) OUTGRP=TESTJOB.1.1 RELEASED
JES2 releases the held transaction job name of testjob
with a transaction job id of a0000014.
6 $o jq,jc=*:*overnight_print*
JOB00063 $HASP686 OUTPUT(D15USER1) OUTGRP=1.1.1 RELEASED
JOB00064 $HASP686 OUTPUT(D15USER2) OUTGRP=1.1.1 RELEASED
JOB00065 $HASP686 OUTPUT(D15USER3) OUTGRP=1.1.1 RELEASED
JOB00066 $HASP686 OUTPUT(D15USER4) OUTGRP=1.1.1 RELEASED
JES2 releases all held output for batch
jobs with a job correlator user portion containing OVERNIGHT_PRINT.
|