IMFC SET PRG=CALLX |  ALL


This command uses SET PRG=CALLX|ALL to terminate a time-initiated EXEC.


Command

Parameters

IMFC SET PRG=CALLX| ALL

execName

[USRID=userID,]

TARGET=targetName

Warning

Important

If PRG=ALL is specified, security is performed against the user ID that is specified on the AUTOID parameter in BBPARM member BBIISP00.

The following table describes the parameters:

Parameter

Function

Notes

USRID=

Name of the user ID against which authorization checking is performed (if this user ID is different from the user ID of the originator of the request)

If the user ID is different from the user ID of the request's originator, the purging user ID must have authority to purge the originator's CALLX requests.

To accomplish this process, code PMACC=# on the AUTHJOB= statement in the BBPARM authorization member for the appropriate user ID.

TARGET=

Target against which the CALLX request will be purged

n/a

Condition codes are listed in the following table:

IMFCC value

IMFRC value

Description

0

0

Command was executed successfully.

8

0

One of the following situations occurred:

  • TARGET= is missing.
  • An error in the monitor or analyzer service occurred (Msg PM0334E issued).
  • Syntax error occurred in SET command (Msg PM0337E issued).

8

4

Specified time-initiated EXEC was not found. This IMFRC value is never issued when PRG=ALL is specified.

8

8

EXEC is not authorized to purge the time-initiated EXEC. This IMFRC value is never issued when PRG=ALL is specified.

16

0

Handling program was not found.

The IMFRC value is created only when both the target BBI-SS PAS and the BBI-SS PAS that is issuing the IMFEXEC IMFC SET command are running BMC AMI Ops Automation version 7.1.xx or later. If either BBI-SS PAS is running a version earlier than 7.1.xx, the IMFRC value is not returned.

For information about how your automation with time-initiated EXECs can be affected when you change the MVS Local Time to observe daylight savings time, see Managing-daylight-saving-time-and-time-initiated-automation

Example

This example shows how to use the IMFEXEC IMFC SET PRG=CALLX command statement that terminates a time-initiated EXEC called IMSCHECK. It can be called from a Rule when IMS terminates.

"IMFEXEC IMFC SET PRG=CALLX IMSCHECK"

CLIST example:

IMFEXEC IMFC SET PRG=CALLX IMSCHECK

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.4