$H A

Function

To perform the following functions:

Hold all jobs that have affinity for the member through which the command is entered.
Hold all jobs whose affinities include the specified member.
Hold all jobs within the entire multi-access spool configuration.

Syntax


>>-$H--A--+----------+-----------------------------------------><
          +-,memname-+   
          '-,ALL-----'

Parameters

A: All jobs currently in the member are held.
If this is a multi-access spool configuration, and neither member name nor ALL is specified, all jobs that have affinity for the member through which the command is entered are held. Even if the member name is specified in the command, all jobs that do not explicitly specify a member affinity is held across the MAS.
ALL: All jobs, regardless of their affinities, are held.
memname: The 1 to 4 character alphanumeric identifier of a member in the multi-access spool configuration. All jobs that have affinity for the specified member are held.

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

Any new jobs read into the member after you issue this command will not be held.
Use the $A command to release the held jobs.

Scope

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

Messages

The $HASP000 message indicates the command was accepted.

Examples

 1   $h a

  $HASP000 OK

JES2 holds all jobs that are currently in the member. If the member is in a multi-access spool configuration, JES2 holds all jobs that have affinity for the member through which the command is entered.

 2   $h a,sysa

  $HASP000 OK

JES2 holds all jobs that have affinity for member SYSA.