$A Group - Release job group

Function

Releases a job group that was held by the $H command or was submitted as held (HOLD=YES on the JOBGROUP statement).

Syntax

Read syntax diagramSkip visual syntax diagram $A GroupGRP nn-mm*'group'(,nn*-mm*group'group') ,/CMDauth=^=cmdauth(,cmdauth),/Age/DAys><days,/Hours><hours,/JM/JOBMASK=^=><jobmask
Read syntax diagramSkip visual syntax diagram,/Queue=^=CNVINPUTOUTPPUPURGERCVSETUPSPINXEQXMT,/REBUILD=^=NoYes
Read syntax diagramSkip visual syntax diagram,/SPL/SPOOL=(,/%/Percent><percent/Tgs><tgs/Volumes=^=volume(,volume))
Read syntax diagramSkip visual syntax diagram,CARDS=cards,SCHENV=schenv,SCHENV_AFF=member,SECLABEL=seclable,SECLABEL_AFF=member/Sysaff=memnameANYIND(memnameANY,=^=memnameANYIND3),OWNER=userid,/XEQNode=^=xeqnode
Read syntax diagramSkip visual syntax diagramSelection limiting keywords
Selection limiting keywords
Read syntax diagramSkip visual syntax diagram,/JC/JOBCORR=^=><job correlator
Notes:
  • 1 cmdauth can be coded up to 2 times.
  • 2 volume can be coded up to 253 times.
  • 3 Multiple Sysaff values can be coded up to 33 times.

Parameters

Age|DAys<days | Age|DAys>days
Specifies the age of affected job groups in days. Only job groups 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.
Age is computed by subtracting the job group's "begin time" from the current time. That is, the time that the job group was initially added to its current queue is the "begin time" except:
  • The "begin time" for job groups that are actively running is the same as the time the command was entered. That is, the age for running job groups is always zero days and hours.
  • The "begin time" for job groups in the OUTPUT or HARDCPY queue is the time that the job group ended execution. If the job group does not run, then the time is the time that the job group was placed in its prior queue.
CARDS=cards
Specifies the number of input cards associated with the job group.
CMDauth=(auth1{,auth2})
Only the job groups that can be affected from the specified remotes or nodes are 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 group to be affected.
H|Hours=hours
Specifies the age of affected job groups in hours. Only job groups 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 subject of job groups that have a matching job correlator. For a description of using wildcards, see 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 job groups whose job group name matches this combination of characters (mask). For a description of using wild cards, see Using wildcards.
Notes:
  1. This is a positional parameter. Specify this following the group_id.
  2. The JOBMASK parameter is not valid with the ‘groupname' parameter.
group
Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of job groups whose job name matches this combination of characters (mask). For a description of using wildcards, see Using wildcards.
‘group'
The name of the group that is released. This name must appear as coded on the JOBGROUP statement and must be enclosed in apostrophes. If more than one job group exists with this name, no action is taken.
Group
A job group or range of job groups is to be released.
OWNER=userid
Specifies the user ID of the owner that is associated with the job group.
Queue={CNV|INPUT|OUT|PPU|PURGE|RCV|SETUP|SPIN|XEQ|XMT}
Only job groups on the specified job queue are to be released.
CNV
Only job groups awaiting conversion are to be released.
INPUT
Only job groups on the JES2 $INPUT queue are to be released.
OUT
Only job groups awaiting output processing are to be released.
PPU
Only job groups awaiting print/punch processing are to be released.
PURGE
Only job groups awaiting purge processing are to be released.
RCV
Only job groups on the JES2 $RECEIVE queue are to be released.
SETUP
Only job groups on the JES2 $SETUP queue are to be released.
SPIN
Only job groups awaiting spin processing are to be released.
XEQ
Only job groups awaiting execution are to be released.
XMT
Only job groups queued for network transmission are to be released.
REBUILD={No|Yes}
Job groups on the rebuild queue are to be released (Yes) or not released (No).
SCHENV=schenv
Specifies the scheduling environment associated with the job group.
SCHENV_AFF=member
Specifies the JES2 MAS members on which the scheduling environment for this job groupis available.
SECLABEL_AFF=member
Specifies the JES2 MAS members on which the SECLABEL for this job group is available but only if the RACF® SECLABEL_BY_SYS is also active.
SECLABEL=seclabel
Specifies the security label associated with the job group.
SPL|SPOOL={Percent|%|Tgs|Volumes}
Only job groups with specific SPOOL characteristics are to be released:
Percent|%
Only job groups using more (with %>nn) or less (with %<nn) than the specified percentage of the total available spool space are to be released.
Tgs
Only job groups using more (with Tgs>nn) or less (with Tgs<nn) than the specified number of track job groups are to be released.
Volumes=(v1,v2,...)
Only job groups which have allocated spool space on the specified spool volumes are to be released.
Sysaff
Specifies job groups 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 of one to four characters using A-Z, 0-9, $, #, and @ of a member in the JES2 multi-access spool configuration that a job group has in its system affinity list.
ANY
Specifies job groups 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 group that is selected and must be executed on a processor operating in independent mode.
XEQNode=xeqnode
Only job groups that are destined to execute at the specified node, or that 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.

Scope

MAS-Wide. This command has an effect across the entire MAS.

Messages

The $HASP890 message displays the characteristics of the job group that was released.

Examples

 1 $AG11
$HASP890 JOB(STEVE)                                       
$HASP890 JOB(STEVE)     JOB_GROUP_STATUS=ACTIVE,ONERROR=SUSPEND,    
$HASP890                ERROR=,SYSAFF=(ANY),HOLD=(NO), 
$HASP890                OWNER=FRED

 2 $AG'STEVE'
$HASP890 JOB(STEVE)                                       
$HASP890 JOB(STEVE)     JOB_GROUP_STATUS=ACTIVE,ONERROR=SUSPEND,    
$HASP890                ERROR=,SYSAFF=(ANY),HOLD=(NO),
$HASP890                OWNER=FRED