Previous Topic

Next Topic

Book Contents

Book Index

Miscellaneous Rules

Consider also the following rules when implementing Control-O/COSMOS at your site:

Table 21 Miscellaneous Control-O/COSMOS Rules

Rule

Description

COSBROAD

Triggered during Control-O/COSMOS initialization and termination.

When triggered, this rule broadcasts the current status of Control-O/COSMOS from the computer where Control-O/COSMOS was initialized or terminated to all other computers that are running Control-O/COSMOS in a Sysplex.

This rule is used in combination with the COSBRREC rule, described in this table.

COSBRREC

Triggered when a COSBROAD rule broadcast, described in this table, is received.

When triggered, the COSBRREC rule performs the following actions:

  1. 1 Receives the change in Control-O/COSMOS status broadcast by another computer in the Sysplex.
  2. 2 Updates the respective %%COSTASK_%%computer variable, where computer is the name of the broadcasting computer. If the variable for the broadcasting computer does not exist, the rule creates it

Transmits the status of the reporting computer to the computer that broadcast the status change, which in turn updates or creates the respective variable for the reporting computer

COSCLEAR

Triggered when the $COSMOSO table is loaded. This ON EVENT rule initializes (clears) some global variables used by Control-O/COSMOS. These variables are kept in a temporary AutoEdit pool named COSWORKV during initialization.

COSFSMPR

Triggered when the COSFSMPR message is issued. Display of this message is optional, and depends on the flag in the COSMOLST member, described in COSMOLST Member. The COSFSMPR message indicates that Control-O/COSMOS found a prerequisite that has not been satisfied.

The format of the message is

COSFSMPR obj_db obj_row obj_name prq_db prq_row prq_name abcd

where

  • obj_db, obj_row, obj_name are the database, row, and name of the object analyzed by Control-O/COSMOS
  • prq_db, prq_row, prq_name are the database, row, and name of the missing prerequisite
  • abcd is a 4-character string, comprised of the following:
    a—the current status of the object
    b—the desired status of the object
    c—the current status of the prerequisite object
    d—the desired status of the prerequisite object

COSFSMTX

Triggered each time the value of %%STATUS changes. Updates values in the STATUS column of Working Object databases (viewed using the Object Status screen) with the result of the last scan Control-O/COSMOS performed on the Object database. For more information about the Object Status screen, see Control-O/COSMOS Object Status Screen.

COSINTRL

Triggered by the COSCLEAR rule, described in this table, at Control-O/COSMOS initialization. The COSINTRL rule sets one AutoEdit override variable (%%OVER_rulename) for each rule name contained in the %COSMOSO table. In this way, Control-O/COSMOS can determine whether a rule is stored in either the $COSMOSO or $COSMOSU table.

For example, the statement

DO SET=%%OVER_COSMET12=INTERNAL GLOBAL Y

specifies that, unless explicitly overridden by the user, the COSMET12 rule is INTERNAL. This means that the COSMET12 rule in the $COSMOSO member is used.

Note: The statement

DO SET=%%OVER_COSMET04=OVRMET04 GLOBAL Y

in the USRCLEAR rule is an example of how a user can override internal rules.

COSSTCHK

Triggered at specified intervals to check the status of started tasks controlled by Control-O/COSMOS. If a started task’s current status does not match the status in the Object database, a Shout message (specified in rule COSACT85) is issued to notify the user of the inconsistency.

CTO603I

Triggered by options specified in the Object Status screen. This rule triggers an Action rule that performs the action requested by the user.

CTO613I

Triggered by options specified in the Database Status screen. This rule triggers an Action rule that performs the action requested by the user.

CTO658I and CTO659I

Triggered by messages issued by the CTOCTI utility. These rules are used by the SYSIMAGE facility to build an Object database that creates an image of the current environment. For more information, see SYSIMAGE Facility – Automatic Generation of an Object Database, and the discussion of the CTOCTI utility in the INCONTROL for z/OS Utilities Guide.

USRCLEAR

Overrides some global rules used by Control-O/COSMOS, when modified by the user, which were initially set by the COSCLEAR rule.

VARCLEAR

Triggered when the $COSMOSU member is loaded. This rule initializes variables, directly and by calling other rules, that are required for COSMOS implementation and rule dispatching. It also saves the library name and member from where the $COSMOSU table was loaded.

Parent Topic

Control-O/COSMOS Rules