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:
|
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.
"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:
I=01:00:00 TARGET=&IMFORGSS USRID=JDB1
Related topic