Data keywords

Use the data keywords to specify what to do with the data identified by the command.

The following list describes the data keywords:

DISPLAY(YES|NO)

Causes a simple line display of each operation found. The display includes the Application ID, Input Arrival, Workstation, Operation number, and Job name. It is followed by a description of the status, and key information relating to that status.

For A, R, and * – SUB=N shows when SUBMIT is set to No.
For W – PR(n/max) shows the number of predecessors when n=complete and max=total number of predecessors.
For W – CPR(n) shows the number of conditional predecessors.
For A, R, *, and W – SR(n) shows the number of special resources.
For E – The error code is shown.
For C and E – The Job ID is shown.
For A, R, and * with Time Dependencies – The time dependency is shown.
For S – The start time is shown.
For C, D, E, and X – The completion time is shown.

FORMAT(FIXED|VARIABLE)

Sets the format for the DISPLAY: FIXED keeps a fixed width for all fields, VARIABLE strips trailing spaces and leading zeroes (default).

OBJECT(<object>)

Specifies the prefix of a set of object variables to store the details of each record identified by the LIST command used as part of the Current Plan Operation command. The base object will contain the number of ALL of the records identified by the LIST statement, even ones later discarded by the filter arguments. Each record is contained in a numerically suffixed object variable, the list of records that have passed the filter criteria may be found in the @FILTER attribute of the object.

SAVELIST(<list>)

Saves a list of the selected operations for use by other commands.

USELIST(<list>)

Uses a previously saved list of operations to drive the actions for the command. Lists from other Current Plan Operation commands and LIST CPOPCOM can be used. The USELIST keyword is mutually exclusive with other Identification, Filter, and Data arguments.

FAIL(SKIP|STOP)

When COUNT is set to 0 or a number higher than 1, or USELIST is specified, one of the actions might fail, leaving the other operations in the list to be processed. Typically this occurs at occurrence level, such as an occurrence being locked in the current plan. The FAIL keyword determines what to do with the rest of the list:

SKIP: Skips the updates to the failing occurrence and continues from the next occurrence in the list. When SKIP is specified, OPTIONS CPFAIL is temporarily considered as ERROR, therefore an ABORT condition is not generated. If errors are found when FAIL(SKIP) is specified, the command ends with RC=8.
STOP: If an error is found the command stops, and further operations are not processed. The command ends with a return code in accordance with the setting of OPTIONS CPFAIL, therefore CPFAIL(ERROR) ends with RC=8, and CPFAIL(ABORT) fails with RC=12.

For example, the following command:

FIND JOBNAME(WT0005) OBJECT(CPO) POSITION(LATEST) COUNT(2)
DISPLAY "Number of objects found" @V(@CPO) 
DISPLAY "Filtered list" @V(@CPO-@FILTER)

returns the following output:

Number of objects found 5 
Filtered list 4 5

You can then identify the filtered records by using a loop to extract the record numbers from the @FILTER attribute:

VARSET LOOPMAX = WORDS(@V(@CPO-@FILTER))
DO X = 1 TO !LOOPMAX
   VARSET Y = WORD(@V(@CPO-@FILTER),@V(X))
   DISPLAY "IA="||@V(@CPO!Y.-CPOPIA) 
END

which would return the following output:

IA=1408251241 
IA=1408251242