Holding or releasing a loaded rule

Rules that are marked as Hold remain loaded but are excluded from the rule search process temporarily during Job Optimizer Pipes execution. Holding a rule is useful when a specific run of the job (for example, a restart after an abend) is performed without using Job Optimizer Pipes services.

A rule remains held until it is released by one of the following actions:

Submitting the RELEASE command
The Pipe Policy Table that contains the rule is refreshed through the LOAD command.

Holding or releasing rules can be performed by using the rule name or the pipe name. When using the rule name, only one rule is held or released. A rule name within a Pipe Policy Table does not have to be unique. HOLD and RELEASE commands locate the first rule with the required name in the required table according to the search order and hold or release it. Subsequent commands locate the next rule that matches the criteria, and so on.

Note

When using the pipe name, all rules that match the pipe name are held or released.

Use the following procedures to hold or release a loaded Rule:

To hold or release a rule by rule name
To hold or release a rule by pipe name

To hold or release a rule by rule name

Enter the following command:

F MBOP,[HOLD|RELEASE]RULE=ruleName,TABLE=tableName,LIB= libraryName,SCOPE=[LOCAL|GLOBAL]

Holding or releasing a rule by rule name parameters

Parameter	Values	Description
RULE	ruleName	The 1-8 character rule name of the Pipe Policy Rule to be held or released.
TABLE	tableName	The 1-8 character Pipe Policy Table name of the Pipe Policy Table that contains the rule to be held or released This name can be found by using the DISPLAY RULE=ALL command.
LIB	libraryName	The 1-44 character Pipe Policy Table Library name of the library from which the Pipe Policy Table was loaded This name can be found by using the DISPLAY RULE=ALL command.
SCOPE	LOCAL
	GLOBAL

When the hold or release request is received by Job Optimizer Pipes, the following message is displayed on the console:

BMC282263I RULE operation STARTED. RULE=ruleName

When the hold or release is performed by Job Optimizer Pipes, the following message is displayed on the console:

BMC282264I RULE operation ENDED. RC=returnCode

The operation value in both messages is HOLD or RELEASE, depending on the command issued.

Example

The following command holds rule ACT001 of Pipe Policy Table ACTGPROD that is loaded from library ACTG.PROD.RULES in a specific Job Optimizer Pipes active environment:

F MBOP,HOLD RULE=ACT001,TABLE=ACTGPROD,LIB=ACTG.PROD.RULES,SCOPE=LOCAL

To hold or release a rule by pipe name

Enter the following command:

F MBOP,[HOLD|RELEASE] RULE=*,PIPE= pipeName,SCOPE=[LOCAL|GLOBAL]

Holding or releasing rules by pipe name parameters (part 1 of 2)

Parameter	Values	Description
RULE	*	The asterisk (*) specifies to hold or release all rules that are in the named pipe.
PIPE	pipeName	The 1-44 character pipe name of the pipe to hold or release
SCOPE	LOCAL
	GLOBAL

When the hold or release request is received by Job Optimizer Pipes, the following message is displayed on the console:

BMC282263I RULE operation STARTED. PIPE=pipeName

When the hold or release is performed by Job Optimizer Pipes, the following message is displayed on the console:

BMC282264I RULE operation ENDED. RC=returnCode

The operation value in both messages is HOLD or RELEASE, depending on the command issued.

Example

The following command holds the rules defining a pipe named PROD.TRAN.FILE in all Job Optimizer Pipes address spaces in the sysplex:

F MBOP,HOLD RULE=*,PIPE=PROD.TRAN.FILE,SCOPE=GLOBAL

Holding or releasing a loaded rule

To hold or release a rule by rule name

To hold or release a rule by pipe name

Comments