Multi-hold Services function

Purpose

To allow jobs to be held by category and with annotation.

Function identifier

MHS

Dependencies

Control File

Description of usage

Multi-hold Services (MHS) allows jobs to placed into specific hold categories so that it is easier to determine why the job is being held. To complement this capability, MHS also supports the ability to add an annotation to the job.

At present, there are four categories of MHS holds or delays:

• JAL holds are applied in JAL through the MHS ADD action statement, and can be removed with the MHS_JAL RELEASE command.
• OPERator holds are applied and removed with the/MHS_OPER HOLD and MHS_OPER RELEASE commands.
• TM holds are applied automatically when ThruPut Manager must hold a job for reasons such as catalog errors, and can be removed with the MHS_TM RELEASE command.
• VOLume delays are applied automatically when ThruPut Manager determines that a DASD volume required by the job is unavailable. You can allow these jobs to run with the MHS_VOL RELEASE command.

Note that MHS does not actually hold jobs in the VOL category. Instead, it removes the system affinity so that the job is not eligible to be selected, thereby delaying the job. For simplicity, this delay is treated as a hold in some displays and commands.

These holds are independent of both z/OS JES2 holds and other ThruPut Manager holds (JSS, JBS, etc.). Jobs can have one or more of these holds and other holds applied simultaneously.

To display a summary of MHS information

This command displays a summary of MHS information, including the last times the MHS application was cold started and warm started, and a summary of the number of jobs held for each MHS category.

To display jobs managed by MHS

This command displays a list of every job managed by MHS.

To display jobs held for a specific MHS category

These commands display a tabular summary of all jobs held for the selected MHS hold category.

To display MHS details for a job

If an annotation has been made for a job held by MHS, these commands display it. For the OPER category, the annotation must have been added by the NOTES keyword on the command that held the job. For the TM and VOL categories, the annotation is generated automatically, and provides specific information about why ThruPut Manager applied the hold or delay.

To apply an MHS hold to a job

This applies an OPER hold and saves information about it. The ID keyword assigns an MHS Group identifier that you can use to manage several jobs at once.

To release jobs held by MHS

You can release jobs by name or job number from any MHS hold category. For example:

If jobs in the OPER category are assigned to an MHS Group, you can release them as a group:

Jobs automatically placed in the MHS hold category TM are grouped by abend code or catalog name, depending on the condition that caused the MHS hold to be applied. These jobs can also be released as a group:

Jobs automatically placed in the VOL category can be grouped by volume serial number for purposes of releasing them:

MHS command summary