$H Group - Hold job groups

Function

To hold job groups.

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 that are associated with the job group.

CMDauth=(auth1{,auth2})

Only the job groups that can be affected from the specified remotes or nodes are held. 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.

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 wildcards, see Using wildcards.

Note:

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 group name matches this combination of characters (mask).

‘group'

The name of the job group that is held. 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 held.

OWNER=userid

Specifies the user ID 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 held.

CNV

Only job groups awaiting conversion are to be held.

INPUT

Only job groups on the JES2 $INPUT queue are to be held.

OUT

Only job groups awaiting output processing are to be held.

PPU

Only job groups awaiting print/punch processing are to be held.

PURGE

Only job groups awaiting purge processing are to be held.

RCV

Only job groups on the JES2 $RECEIVE queue are to be held.

SETUP

Only job groups on the JES2 $SETUP queue are to be held.

SPIN

Only job groups awaiting spin processing are to be held.

XEQ

Only job groups awaiting execution are to be held.

XMT

Only job groups queued for network transmission are to be held.

REBUILD={No|Yes}

Job groups s on the rebuild queue are to be held (Yes) or not held (No).

SCHENV=schenv

Specifies the scheduling environment that is associated with the job group.

SCHENV_AFF=member

Specifies the JES2 MAS members on which the scheduling environment for this job group is 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 that is associated with the job group.

SPL|SPOOL={Percent|%|Tgs|Volumes}

Only job groups with specific SPOOL characteristics are to be held:

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 held.

Tgs

Only job groups using more (with Tgs>nn) or less (with Tgs<nn) than the specified number of track groups are to be held.

Volumes=(v1,v2,...)

Only job groups that have allocated spool space on the specified spool volumes are to be held.

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 (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 held. The node name can be specified using the decimal node number (Nnnnnn) or an EBCDIC node name.

Related Commands

To release a job group, see the $A Group command.

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

None.

Scope

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

Messages

The $HASP890 message displays the characteristics of the job group that is being held.