FORCE

The FORCE instruction forces the execution of an occurrence or of an operation within an occurrence in the current plan.

Table 1 describes the keywords that can be used.

Table 1. Keywords used in the Force Instruction
Keyword Requirement Multiple Values Allowed Description Abbreviation Format
APPL() Required No The name of the application to be started.
OPNO() Optional Yes The number of the operation to be started. It defaults to the default operation number, DEFOPNO, specified in the OCL program.² OP
IADATE() Optional¹ No The input arrival date of the application occurrence. IADATE=() means the current date. IADATE() and IA() are mutually exclusive. IAD YYMMDD
IATIME() Optional¹ No The input arrival time of the application occurrence. If IADATE(=) is specified, IATIME() assumes the default input arrival time that is defined in the DEFIAT parameter of the EQQYRPRM member. IATIME() and IA() are mutually exclusive. IAT HHMM
IA() Optional¹ N The input arrival date and time of the application occurrence. IA(=) assumes the current date and time. It defaults to the earliest or latest input arrival date and time of the application occurrences found in the current plan, depending on the SORT parameter specified in PARMLIB or in the INIT instruction. IA() cannot be used with IADATE() or IATIME(). YYMMDDHHMM
Notes:
  1. Mutually exclusive with another keyword.
  2. In order to start the occurrence from a specific operation number, the program performs the following actions:
    1. Deletes all the special resources associated to the operation
    2. Deletes all the external predecessors
    3. Changes the operation status to R (ready), and changes the following automatic options of the operation:
      • Job submission to YES
      • Time dependent to NO
      • Operation descriptive text to '* OCL forced this oper *'
      • Parallel server to 1
      • Resource R1 to 0
      • Resource R2 to 0
      If the change is successful, the return code is 0. (The return code is stored in the RESULT variable.) Otherwise it does the following:
      1. Deletes the external predecessors of all the internal predecessors of the specified operation
      2. Changes again the operation status to R (ready) and the operation automatic options
    4. Checks whether the occurrence is started.
Examples:
FORCE APPL(TEST01)
Forces the default operation, DEFOPNO, to start
FORCE APPL(TEST01) OP(50)
Forces operation 50 to start
FORCE APPL(TEST01) IA(=)
Forces operation 50 to start, using the current date and time as the input arrival date and time
FORCE APPL(TEST01) IA(9707081800) OP(70)
Forces operation 70 to start, using the input arrival date 970708 and the input arrival time 18.00
FORCE APPL(TEST01) IAD(=)
Forces the default operation, DEFOPNO, to start, using the current date as the input arrival date and the default input arrival time
FORCE APPL(TEST01) IAD(&OYMD1)
Forces the default operation, DEFOPNO, to start, using the input arrival date and time value of variable &OYMD1
FORCE APPL(TEST01) IAD(970708) IAT(&OHHMM) OP(60)
Forces operation 60 to start, using the input arrival date 970708 and the input arrival time value of variable &OHHMM
The FORCE instruction returns one of the following return codes:
RESULT = 0
Occurrence or operations status is started.
RESULT = 4
Occurrence found but operations not found in the current plan.
RESULT = 8
Occurrence not found in the current plan. Invalid instruction or PIF problem. Refer to the error messages.