|
Function To release held jobs. For example
the jobs that are held by the following commands or statements: - $G H commands
- $H A commands
- $H job commands
- /* SETUP control statements
- $T Nn, H=JR commands
- $T RDRn, H=Y commands
- TYPRUN=HOLD JCL parameters
Syntax
>>-$A--+-Job--+--+--------------------------------------+------->
+-JOBQ-+ +-nn--+------------+-------------------+
+-JQ---+ | '- ---+-mm-+-' |
+-Stc--+ | '-*--' |
'-Tsu--' +-'--job--'----------------------------+
| .-,--------------------------. |
| V | |
'-(----+-+-nn-+--+------------+-+-+--)-'
| '-*--' '- ---+-mm-+-' |
| '-*--' |
+-job--------------------+
'-'--job--'--------------'
>--+--------------------------------------------------------+--->
'-,--+---+--CMDauth--+-=--+--+-cmdauth-----------------+-'
'-/-' '-^=-' | .-,-------------. |
| V (1) | |
'-(----------cmdauth-+--)-'
>--+---------------------------------+-------------------------->
'-,--+-+---+--Age--+--+->-+--days-'
| '-/-' | '-<-'
'-+---+--DAys-'
'-/-'
>--+-------------------------------+---------------------------->
'-,--+---+--Hours--+->-+--hours-'
'-/-' '-<-'
>--+----------------------------------------+------------------->
'-,--+-+---+--JM------+--+-=--+--jobmask-'
| '-/-' | +-^=-+
'-+---+--JOBMASK-' +->--+
'-/-' '-<--'
>--+------------------------------------+----------------------->
'-,--+---+--Queue--+-=--+--+-CNV---+-'
'-/-' '-^=-' +-INPUT-+
+-OUT---+
+-PPU---+
+-PURGE-+
+-RCV---+
+-SETUP-+
+-SPIN--+
+-XEQ---+
'-XMT---'
>--+------------------------------------+----------------------->
'-,--+---+--REBUILD--+-=--+--+-No--+-'
'-/-' '-^=-' '-Yes-'
>--+------------------------------------------------------------------------------------------+-->
| .-,------------------------------------------------------. |
| V | |
'-,--+-+---+--SPL---+--=--(----+-+-+---+--%-------+--+->-+--percent-----------------+-+--)-'
| '-/-' | | | '-/-' | '-<-' |
'-+---+--SPOOL-' | '-+---+--Percent-' |
'-/-' | '-/-' |
+-+---+--Tgs--+->-+--tgs-----------------------------+
| '-/-' '-<-' |
'-+---+--Volumes--+-=--+--+-volume-----------------+-'
'-/-' '-^=-' | .-,------------. |
| V (2) | |
'-(----------volume-+--)-'
>--+---------------------------------+-------------------------->
'-,--+---+--TYPE--+-=--+--+-JOB-+-'
'-/-' '-^=-' +-STC-+
'-TSU-'
>--+--------------------+--+------------------+----------------->
'-,--BUSY=--+-YES--+-' '-,--CARDS=--cards-'
+-ANY--+
+-NO---+
'-NONE-'
>--+------------------+--+----------------+--------------------->
'-,--Class=--class-' '-,--OFFS=--offs-'
>--+-------------------------+--+--------------------+---------->
'-,--Priority-=--priority-' '-,--SCHENV=--schenv-'
>--+------------------------+--+------------------------+------->
'-,--SCHENV_AFF=--member-' '-,--SECLABEL=--seclable-'
>--+--------------------------+--+------------------------+----->
'-,--SECLABEL_AFF=--member-' '-,--SRVCLASS=--srvclass-'
>--+-----------------------------------------------------------------+-->
'-+---+--Sysaff--=--+-memname-----------------------------------+-'
'-/-' +-ANY---------------------------------------+
+-IND---------------------------------------+
'-(--+-memname-------------------------+--)-'
+-ANY-----------------------------+
| .-,---------------------------. |
| V (3) | |
'-----+----+--+-memname-+-------+-'
+-=--+ +-ANY-----+
'-^=-' '-IND-----'
>--+--------------------+--------------------------------------->
'-,--USERID=--userid-'
>--+------------------------------------+----------------------->
'-,--+---+--XEQNode--+-=--+--xeqnode-'
'-/-' '-^=-'
>--+---------------------------------+-------------------------><
'-| Selection limiting keywords |-'
Selection limiting keywords
|--+-----------------------------------------------+------------|
'-,--+-+---+--JC------+--+-=--+--job correlator-'
| '-/-' | +-^=-+
'-+---+--JOBCORR-' +->--+
'-/-' '-<--'
Notes: - cmdauth can be coded up to 2 times
- volume can be coded up to 253 times
- Multiple Sysaff values can be coded up to 33 times
Parameters - Age|DAys<days | Age|DAys>days
- Specifies the age of
affected jobs in days. Only jobs 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.
- BUSY=
- Specifies
one of the following:
- The system name or number on which the job is busy. Note that
you can specify a value of 0 to indicate the job is not busy. You
can also specify values above 32 to match systems with invalid values
in the BUSY value (for example, $AJOBQ,BUSY>32)
- YES or ANY, indicating that all busy jobs are to match
- NO or NONE, indicating that all non-busy jobs are to match
- CARDS=cards
- Specifies
the number of input cards associated with the job.
- Class=class
- Specifies a job class used to select a subset of jobs that have a
matching job class. Wildcard characters can also be specified: see
Using wildcards for details.
- CMDauth=(auth1{,auth2})
- Only
the jobs 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.
- H|Hours=hours
- Specifies
the age of affected jobs in hours. Only jobs more (with HOURS>nn)
or less (with HOURS<nn) than the specified number of hours in age
are affected.
- 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
using 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.
- job
- 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 using wild cards, see Using wildcards.
- ‘job'
- The name of the job that is released. 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 released.
- JOBQ|JQ
- Specifies all jobs, STCs, and TSUs across the MAS for processing.
- OFFS=offs
- Specifies
offload device numbers on which the job has been archived.
- Priority=priority
- Specifies
the priority of the job.
- Queue={CNV|INPUT|OUT|PPU|PURGE|RCV| SETUP|SPIN|XEQ|XMT}
- Only
jobs on the specified job queue are to be released.
- CNV
- Only jobs awaiting conversion are to be released.
- INPUT
- Only jobs on the JES2 $INPUT queue are to be released.
- OUT
- Only jobs awaiting output processing are to be released.
- PPU
- Only jobs awaiting print/punch processing are to be released.
- PURGE
- Only jobs awaiting purge processing are to be released.
- RCV
- Only jobs on the JES2 $RECEIVE queue are to be released.
- SETUP
- Only jobs on the JES2 $SETUP queue are to be released.
- SPIN
- Only jobs awaiting spin processing are to be released.
- XEQ
- Only jobs awaiting execution are to be released.
- XMT
- Only jobs queued for network transmission are to be released.
- REBUILD={No|Yes}
- Jobs
on the rebuild queue are to be released (Yes) or not released (No).
- SCHENV=schenv
- Specifies
the scheduling environment associated with the job.
- SCHENV_AFF=member
- Specifies the JES2 MAS members on which the scheduling environment
for this job is available.
- SECLABEL_AFF=member
- Specifies the JES2 MAS members on which the SECLABEL for this job
is available but only if the RACF® SECLABEL_BY_SYS is also active.
- SECLABEL=seclabel
- Specifies
the security label associated with the job.
- SPL|SPOOL={Percent|%|Tgs|Volumes}
- Only jobs with specific
SPOOL characteristics are to be released:
- Percent|%
- Only jobs using more (with %>nn) or less (with %<nn) than the
specified percentage of the total available spool space are to be
released.
- Tgs
- Only jobs using more (with Tgs>nn) or less (with Tgs<nn) than
the specified number of track groups are to be released.
- Volumes=(v1,v2,...)
- Only jobs which have allocated spool space on the specified spool
volume(s) are to be released.
- SRVCLASS=srvclass
- Specifies
the service class of the job. The service class is available for batch
jobs only. It is not available for started tasks or time-sharing users.
The default workload manager (WLM) policy assigns a service class
of blanks to all jobs, and WLM-managed initiators can then select
such jobs for processing.
- Stc
- A started
task or range of started tasks is to be released.
- Sysaff
- Specifies
jobs to process based on this system affinity. Up to 33 entries can
be coded by using a combination of the following values:
- memname
- Specifies the identifier (1 to 4 alphanumeric characters) of a
member in the JES2 multi-access spool configuration that a job has
in its system affinity list.
- ANY
- Specifies jobs that are eligible to run on any member in the JES2
multi-access spool configuration. If you specify ANY followed by the
IND parameter, they must be separated by a comma and the list must
be enclosed in parentheses, for example, (ANY,IND).
- IND
- Specifies the job that is selected and must be executed on a processor
operating in independent mode.
- Tsu
- A time-sharing
user or range of time-sharing users is to be released.
- TYPE={JOB|STC|TSU}
- Indicates
whether only batch jobs (JOB), started tasks (STC), or time-sharing
users (TSU) are to be released.
- USERID=userid
- Specifies
the userid associated with the job.
- XEQNode=xeqnode
- Only
jobs which are destined to execute at the specified node, or which
have already executed at the specified node, are to be released.
The node name may be specified using the decimal node number (Nnnnnn)
or an EBCDIC node name.
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.
Scope MAS-Wide. This command has
an effect across the entire MAS.
Messages The $HASP890 message displays
the released job.
JES2 issues message $HASP003 if the specified
job was not being held.
Examples 1 $aj'payroll'
JOB00024 $HASP890 JOB(PAYROLL)
$HASP890 JOB(PAYROLL) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JES2 releases the batch job named PAYROLL and makes it available
for processing. 2 $aj(?ebg*)
JOB00005 $HASP890 JOB(IEBGENER)
$HASP890 JOB(IEBGENER) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JOB00055 $HASP890 JOB(IEBGENER)
$HASP890 JOB(IEBGENER) STATUS=(AWAITING HARDCOPY),CLASS=A,
$HASP890 PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)
JES2 releases any batch jobs whose job name includes EBG as
the second, third, and fourth characters. 3 $aj1-8,jm=?ebg*
JOB00005 $HASP890 JOB(IEBGENER)
$HASP890 JOB(IEBGENER) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JES2 releases any batch jobs that fall within the range of
jobs 1-8 whose job name includes EBG as the second, third, and fourth
characters. 4 $aj(1-3,i*,5-7)
JOB00003 $HASP890 JOB(D96CLW1A)
$HASP890 JOB(D96CLW1A) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JOB00018 $HASP890 JOB(IEBGENER)
$HASP890 JOB(IEBGENER) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JOB00036 $HASP890 JOB(IBMUSERX)
$HASP890 JOB(IBMUSERX) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JOB00006 $HASP890 JOB(CNTLABC)
$HASP890 JOB(CNTLABC) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JES2 releases any batch jobs that fall within the range of jobs 1-3
or 5-7, PLUS any batch jobs whose job name begins with the letter
I. 5 $ajq(1-3,i*,5-7)
STC00002 $HASP890 JOB(NEWS)
$HASP890 JOB(NEWS) STATUS=(EXECUTING/IBM1),CLASS=STC,
$HASP890 PRIORITY=9,SYSAFF=(IBM1),HOLD=(NONE)
JOB00003 $HASP890 JOB(D96CLW1A)
$HASP890 JOB(D96CLW1A) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
STC00010 $HASP890 JOB(INIT)
$HASP890 JOB(INIT) STATUS=(EXECUTING/IBM1),CLASS=STC,
$HASP890 PRIORITY=9,SYSAFF=(IBM1),HOLD=(NONE),
$HASP890 INITASID=012D
STC00017 $HASP890 JOB(INIT)
$HASP890 JOB(INIT) STATUS=(EXECUTING/IBM2),CLASS=STC,
$HASP890 PRIORITY=9,SYSAFF=(IBM2),HOLD=(NONE)
$HASP890 INITASID=NONE
JOB00018 $HASP890 JOB(IEBGENER)
$HASP890 JOB(IEBGENER) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JOB00036 $HASP890 JOB(IBMUSERX)
$HASP890 JOB(IBMUSERX) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
JOB00006 $HASP890 JOB(CNTLABC)
$HASP890 JOB(CNTLABC) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)
TSU00007 $HASP890 JOB(D96CLW1)
$HASP890 JOB(D96CLW1) STATUS=(EXECUTING/IBM1),CLASS=TSU,
$HASP890 PRIORITY=9,SYSAFF=(IBM1),HOLD=(NONE)
JES2 releases any batch jobs, started tasks, or
time-sharing users that fall within the range of jobs 1-3 or 5-7,
PLUS any whose job name begins with the letter I.
5 $aj(*),jc=*:clientxyzjob*
JOB00069 $HASP890 JOB(D15USER1) C
$HASP890 JOB(INVENTRY) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)
JOB00070 $HASP890 JOB(D15USER2) C
$HASP890 JOB(PAYROLL) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)
JOB00071 $HASP890 JOB(D15USER3) C
$HASP890 JOB(ORDERS) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)
JOB00072 $HASP890 JOB(D15USER4) C
$HASP890 JOB(BACKUP) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890 PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)
JES2 releases any batch jobs with the job
correlator user portion starting with CLIENTXYZJOB.
|