Conversion Details

This chapter includes the following topics:

Conversion of Specific Parameters
Unique Control-O Parameters

Conversion of Specific Parameters

This chapter contains details about the conversion of specific keywords and parameters of console automation products at your site into Control-O rule definition parameters.

This chapter also describes unique Control-O parameters that can be specified using parameters of conversion utility CTOFANCI.

For an in-depth description of all Control-O Rule Definition parameters, see the Rule Parameters chapter in the Control-O User Guide. The conversion tables below list keywords and parameters of other console automation products and the Control-O parameters to which these keywords and parameters are converted.

Table 7 Conversion of CA-OPS Event Selection Criteria

CA-OPS Event Selection Criteria	Control-O Rule Definition Parameter
)CMD	ON COMMAND
)DOM	ON EVENT
)EOM	ON JOBEND
)GLV	ON EVENT
)MSG	ON MESSAGE
)OMG	ON EVENT
)REQ	ON EVENT
)SCR	ON EVENT
)SEC	ON EVENT
)TOD	ON EVENT, WDAYS, TIME, INTERVAL For details, see Table 8 below.

Table 8 Conversion of CA-OPSTime of Day Specification

CA-OPS Time of Day Keywords	Control-O Rule Definition Parameter	Note (see after email)
)TOD fromtime tottime	TIME FROM / UNTIL	1
)TOD interval	INTERVAL	2
)TOD fromweekday toweekday	WDAYS	1
)TOD fromdate	Not yet supported
)TOD todate	Not yet supported

Note 1

Control-O TIME FROM and UNTIL fields can only be used to specify limits within a single day (24 hours).

If a combination of times and weekdays was specified in an input rule and the time limits are within a single day, these time limits are translated correctly.

If a time limit that exceeds a single day is specified in the input rule, a warning message is issued. The time limits specified in the input rule are translated as if they were specified separately for each day.

For example, the following CA-OPS specification:

MONDAY 05:00,,TUESDAY 10:00

is translated to Control-O as:

WDAYS 1,2

TIME FROM 0500 UNTIL 1000

Note 2

The Conversion Utility translates rule activation intervals as follows:

If the interval in the input rule is smaller than 999 minutes, the same interval is entered in the INTERVAL field in the output rule definition.
If the interval in the input rule is more than 999 but less than 1440 minutes (one day), a warning message is issued and an interval of 999 minutes is specified in the output rule.
If the interval in the input rule is exactly one day or exactly one week, the interval is ignored and a warning message is issued. Because Control-O rules are typically reloaded at the beginning of each working day, the output rule can implement the same interval without a value for parameter INTERVAL being specified in the output rule.
If the interval in the input rule is more than one day, but not exactly one week, a warning message is issued and this rule must be modified manually to provide the desired functionality.
If the interval specified for the input rule includes partial minutes (for example, 150 seconds), the output interval is equal to the number of whole minutes in the input interval. For example, 150 seconds is translated to 2 minutes.

If the number of whole minutes is zero (for example, 30 seconds was specified), an interval of one minute is specified in the output rule.

Table 9 Conversion of CA-OPS Action Statements

CA-OPS Statement	Control-O Rule Definition Parameters
)PROC RETURN "SUPPRESS"	DO DISPLAY SUPPRESS Y
)MSG msgid NOOPSLOG	DO SET %%$AUTOLOG=NO

CA-OPS Statement

Control-O Rule Definition Parameters

)PROC

RETURN "SUPPRESS"

DO DISPLAY SUPPRESS Y

)MSG msgid NOOPSLOG

DO SET %%$AUTOLOG=NO

Table 10 Conversion of CA-AUTOMATE Selection Criteria

CA-AUTOMATE	Control-O Event Selection Criteria
MSGID()	ON MESSAGE
CMDIN()	ON COMMAND
SCREEN()	ON EVENT
STATVAR()	ON EVENT
TIME()	ON EVENT

Table 11 Conversion of CA-AUTOMATE Keywords

CA-AUTOMATE Keyword	Control-O Event Selection Criteria
SUPPRESS	DO DISPLAY SUPPRESS Y
SUPPRESS(NOLOG)	DO DISPLAY SUPPRESS A
TIME(HH:MM)	TIME FROM HHMM TO 2359
EVERY(interval)	INTERVAL (For more information, see "Note 2" above.) APPEARED n TIMES IN m MINUTES

Unique Control-O Parameters

Certain unique Control-O rule definition parameters can be set by the Conversion Tool in the process of creating the Control-O Rule tables. Values for these parameters can be specified using a parameter of conversion utility CTOFANCI, or manually following automatic rule creation.

The following unique Control-O parameters are available:

MODE

This parameter indicates the mode in which a Control-O rule must operate. Valid values:

PROD – Normal operation mode.
LOG – Same as PROD, except that in addition to normal functions, all actions are written to a test journal.
TEST – Console actions are not performed, but messages are written to a test journal, describing actions that would have been performed if the rule was in PROD mode. Setting of variables is performed.

The value for parameter mode in each output rule is determined by parameter RULEMODE of utility CTOFANCI. For more information, see Utility CTOFANCI.

OWNER

This parameter specifies a user ID or user name to be associated with each Control-O rule. The value specified for this parameter can be used by Control-O security to check authorization to perform the actions specified in the rule.

The OWNER value for rules generated during conversion is determined by parameter RULEOWNER of utility CTOFANCI. For more information, see Utility CTOFANCI.