IMFC SET REQ=CALLX


This command uses SET REQ=CALLX to start a time-initiated EXEC or SET PRG=CALLX to terminate a time-initiated EXEC.


Command

Parameters

IMFC SET REQ=CALLX

execName

[START=hh:mm:ss,]

[STOP=hh:mm:ss,]

[STOPCNT=( )]

[I=00:01:00|hh:mm:ss,]

[USRID=userid,]

TARGET=targetName

The following table describes the parameters:

Parameter

Function

Notes

execname

Name of the EXEC to be scheduled

No parameters can be passed to the EXEC.

START=

Start time for an EXEC

Format is HH:MM:SS.

The valid start times are from 00:00:01 to 24:00:00 (00:00:00 is not supported). If you have an EXEC that calculates time to 00:00:00, you must ensure that the EXEC translates the 00:00:00 to 24:00:00.

STOP=

Stop time for rescheduling the EXEC

Format is HH:MM:SS.

The valid stop times are from 00:00:01 to 24:00:00 (00:00:00 is not supported). If you have an EXEC that calculates time to 00:00:00, you must ensure that the EXEC translates the 00:00:00 to 24:00:00.

STOPCNT=

Number of times the EXEC will be scheduled

This value is a valid decimal number.

I=

Interval between EXEC schedules

Format is HH:MM:SS.

TARGET=

Target against which the EXEC will be scheduled

n/a

USRID=

Name of the user ID for the request using the online application

The value that is specified will be used for authorization checking. It also will become the owner of the resulting request.

CALLX requests can be viewed and purged when you select the TIMEXEC option from the EXEC Manager Menu.

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

8

Failed because a time-initiated EXEC with this name already exists.

16

0

Handling program was not found.

Example

This example shows how to use the IMFEXEC IMFC SET REQ=CALLX command statement.

/* REXX */
"IMFEXEC IMFC SET REQ=CALLX @HOURLY START=06:00:00 STOP=16:00:00",
       "I=01:00:00  TARGET="IMFORGSS "USRID=JDB1"

This example causes an EXEC named @HOURLY to be issued every hour, beginning at 6:00 A.M. and ending at 4:00 P.M. on the same system that this EXEC is scheduled on. The user with user ID JDB1 will be able to purge this request. Also, any user with PMACC=# coded in the BBPARM user ID authorization member can purge this request.

CLIST example:

IMFEXEC IMFC SET REQ=CALLX @HOURLY START=6:00:00 STOP=16:00:00 +
       I=01:00:00  TARGET=&IMFORGSS USRID=JDB1

 

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

BMC AMI Ops Automation 8.4