Online Facilities

Introduction

Control-O/COSMOS monitors the status of specified objects (resources) in your computing environment and if necessary modifies the status of an object when its current status does not match a specified desired status.

Control-O/COSMOS screens facilitate management of Control-O/COSMOS-controlled objects and databases of objects.

Control-O/COSMOS Main Menu

To enter the Control-O/COSMOS Main menu, specify option OC in the IOA Primary Option menu and press Enter. For more information about the IOA Primary Option menu, see the online facilities chapter of the Control-O User Guide.

The following screen is displayed:

Figure 1 Control-O/COSMOS Status Screen

Copy 
-----------------------  CONTROL-O COSMOS STATUS  ------------< D >--------(OA)
COMMAND ===>                                                     SCROLL===> CRSR
O OPTION                         DESCRIPTION
S OBJECT    COSMOS Object Status
  DATABASE  COSMOS Database Status
====== >>>>>>>>>>>>>>>    NO MORE ENTRIES IN THE LIST    <<<<<<<<<<<<<<<< ======
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
SELECT AN OPTION AND PRESS ENTER                                        14.46.00

This screen displays the available Control-O/COSMOS screens. The following screens are available:

Table 3 Status Screens

Screen

Description

OBJECT

Object Status screen. This screen allows management of individual Control-O/COSMOS-controlled objects.

DATABASE

Database Status screen. This screen allows management of Control-O/COSMOS-controlled objects in a specific database or multiple databases.

OS databases. Options specified in this screen affect the functioning of all objects in the specified database or databases.

Select a Control-O/COSMOS screen by specifying S (Select) to the left of the desired option and pressing ENTER.

To return to the IOA Primary Option menu, press END (PF03/PF15).

During startup or shutdown of the system, the Control-O/COSMOS screens may not be available. For this reason, a set of operator commands can be used to perform actions normally performed using Control-O/COSMOS screens. For more information about Control-O/COSMOS commands, see Component Details.

Control-O/COSMOS Object Status Screen – Selection Criteria

The Control-O/COSMOS Object Status screen enables management of Control-O/COSMOS-controlled objects on an individual basis. For example, this screen can be used to view object status or to change the Control-O/COSMOS mode for an object.

To display the Object Status screen, specify S (Select) to the left of option OBJECT in the Control-O/COSMOS Main menu and press ENTER. The following Selection Criteria window is displayed:

Figure 2 Object Status Screen

Copy 
----------------------  CONTROL-O COSMOS STATUS  ------------< D >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                         DESCRIPTION
S OBJECT    COSMOS Object Status
  DATABASE  COSMOS Database Status
===== +--------------------------------------------------------------------+
      |                                                                    |
      |                      Please Enter Parameters                       |
      |                                                                    |
      |   OBJECT         ==> *                                             |
      |   CURRENT        ==> *                                             |
      |   DESIRED        ==> *                                             |
      |   CLASS          ==> *                                             |
      |   MODE           ==> *                                             |
      |   DATABASE       ==> *                                             |
      |   GROUP          ==> *                                             |
      |   APPL           ==> *                                             |
      |   SYSTEM NAME    ==> CURRENT                                       |
      |   EXCEPTION Y/N  ==> N                                             |
      |                                                                    |
      +--------------------------------------------------------------------+
   
   
SELECT AN OPTION AND PRESS ENTER                                       15.36.53

The Selection Criteria window enables the filtering of objects displayed in the Objects Status screen.

When you first open the window, most of the criteria have an * value. Filtering is not performed on criteria that have* as their value. Therefore, by default, all objects in all Control-O/COSMOS Object databases are displayed.

To activate filtering on desired criteria, specify the desired values or masks for these criteria. Mask characters (* and ?) can be specified in any of the selection criteria fields (except for EXCEPTION Y/N). Each ? represents any one character; each * represents any number of characters.

Multiple criteria are linked by an implied AND logic (meaning, an object must satisfy all specified criteria to be displayed).

All selection criteria fields (except for EXCEPTION Y/N) allow up to eight characters.

The following table contains descriptions of all fields in the window.

Table 4 Object Status Screen - Selection Criteria

Criteria

Description

OBJECT

Object name or mask.

CURRENT

Current status or mask.

DESIRED

Desired status or mask.

CLASS

Object class or mask.

MODE

Control-O/COSMOS mode of the object. Display only objects with the specified Control-O/COSMOS mode (or with a mode that matches the specified mask).

DATABASE

Object database name or mask.

GROUP

Group name or mask.

APPL

Application name or mask.

SYSTEM NAME

Name of the Sysplex system, or mask. This name is used to select the system from which the Control-O/COSMOS working databases are displayed. Default value: CURRENT (this value indicates the system on which the user is currently logged-on). This field is valid only when displaying TYPE 1 XAE databases used to store Control-O/COSMOS working databases.

EXCEPTION Y/N

Indicates whether to display all objects, or only objects whose current and desired statuses do not match. Valid values are:

  • Y (Yes) – Display only objects whose current and desired statuses do not match.

  • N (No) – Display all objects (regardless of whether or not current and desired statuses match). Default.

Change selection criteria if desired. Press Enter to close the entry panel. The Object Status screen is displayed.

Control-O/COSMOS Object Status Screen

The Object Status screen displays information about Control-O/COSMOS-controlled objects.

Use the scrolling PFKeys to scroll the Object Status screen forward and backward.

Table 2-3 contains predefined display types that are available for the Object Status screen:

Table 5 Object Status Screen - Display Type

Display Type

Description

D

Default display type

S

System Name display

A

All Fields display type

O

Operator display type

Changing Display Types

While in the Object Status screen, the display type can be changed using the DISPLAY command. Format of the command is:

DISPLAY x

where x is the identifying letter for the desired type.

DISPLAY may be abbreviated to DI.

For a list of display types, enter DISPLAY ? to show the Display Options window. To select a display type in the window, specify S in the Option field next to the ID. To exit the window without selecting a display type, press the END key (PF3).

DI A displays the All Fields display type.

Display Type D (Default)

Figure 3 Object Status Screen – Display Type D (Default)

Copy 
----------------------- CONTROL-O COSMOS OBJECT STATUS  ------< D >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OBJECT   CURRENT  DESIRED  CLASS    MODE     STATUS
  JES2     UP       UP       BASE     FREE     CD=OU
  VTAM     DOWN     UP       COMM     FREE     CD=DU PR=JES2
  CICP     DOWN     UP       DC       FREE     CD=DU PR=VTAM APLCICP
  CICT     DOWN     UP       DC       FREE     CD=DU PR=VTAM
  TCP      DOWN     UP       COMM     FREE     CD=DU PR=VTAM APLTCP
  IDMS     DOWN     UP       DB       FREE     CD=DU PR=JES2
  IMS      DOWN     UP       DB       FREE     CD=DU PR=JES2
  NETV     DOWN     UP       COMM     FREE     CD=DU PR=VTAM JES2 APLNETV
  OMON     DOWN     UP       IOA      FREE     CD=DU PR=JES2 APLOMON
  CTM      DOWN     UP       IOA      FREE     CD=DU PR=JES2
  CTD      DOWN     UP       IOA      FREE     CD=DU PR=JES2
  ADAB     DOWN     UP       DB       FREE     CD=DU PR=JES2
  DB2T     DOWN     UP       DB2      FREE     CD=DU PR=JES2
  DB2P     DOWN     UP       DB2      FREE     CD=DU PR=JES2
  APLOMON  CHANGING ACTIVE   COMM     FREE     CD=OU
  APLNETV  CHANGING ACTIVE   COMM     FREE     CD=OU
  APLCICP  CHANGING ACTIVE   COMM     FREE     CD=OU
  APLCICT  CHANGING ACTIVE   COMM     FREE     CD=OU
  APLTCP   CHANGING ACTIVE   COMM     FREE     CD=OU
   ELD      UP       UP       SYSIMAGE FORCE_OK GLOBAL FORCE_OK
   S START  P STOP  B BOUN. F FREE  H HELD  O FORCE_OK. N NOPRE  R USER  15.38.48

Fields in the Default (D) Display Type

The following information is displayed:

Table 6 Fields in the Default (D) Display Type

Field

Description

<D>

Indicates the Default display type.

O (Option)

Option field. Allows entry of line options to be applied to a specific object.

OBJECT

Name of the object.

CURRENT

Current status of the object.

DESIRED

Desired status of the object

CLASS

Object class. This field can be used to create logical groups of objects, for easier management by method rules, described in Component Details.

MODE

Control-O/COSMOS mode of the objects. Indicates how Control-O/COSMOS is currently managing the object. Valid values are:

  • FREE – Normal operation mode.

  • NOPRE – Prerequisites are not checked before changing the status of the object.

  • FORCE_OK – Desired status of the object is modified to match the current status. If the current status is changed, the desired status is modified again so that it continues to match the current status.

  • HELD – The object is kept in the current status. No changes are made to the object status (regardless of whether or not the current status and desired status of the object match).

If a mode other than FREE is specified for a database or for all of Control-O/COSMOS, that mode overrides the mode specified for specific objects. For more information, see Database Status Screen.

STATUS

Status of the object as determined by Control-O/COSMOS the last time Control-O/COSMOS scanned the Object database. Valid values are:

  • STEADY UP – The current and desired statuses of the object are UP (or an equivalent status).

  • STEADY DOWN – The current and desired statuses of the object are DOWN (or an equivalent status).

  • GLOBAL HELD – HELD mode is specified either for the Object database containing the object or for the entire Control-O/COSMOS facility.

  • GLOBAL FORCE_OK – FORCE_OK mode is specified either for the Object database containing the object or for the entire Control-O/COSMOS facility.

  • GLOBAL NOPRE – NOPRE is specified either for the Object database containing the object or for the entire Control-O/COSMOS facility.

CD=xy PR=pr1 pr2 pr3 ...

The current and desired statuses of the object do not match where:

  • xy is an abbreviated form of the current and desired statuses. (For more information, see the CD field explanation in "Display Type A (All)".)
  • pr1, pr2, and so on, are prerequisites that must be fulfilled before the difference between the current and desired statuses can be resolved.

    • If the current or desired status of the object was changed more recently than the last time Control-O/COSMOS scanned the Working Object database, the value in the STATUS field may not reflect the current object status. (The STATUS field is updated the next time Control-O/COSMOS scans the Working Object database.

Display Type S (System)

This display is identical to the Display Type D, except that it replaces the MODE column with CPU.

Figure 4 Object Status Screen – Display Type S (System)

Copy 
----------------------- CONTROL-O COSMOS OBJECT STATUS  ------< S >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OBJECT   CURRENT  DESIRED  CLASS    CPU      STATUS
  JES2     UP       UP       BASE     SYSTEMA  CD=OU
  VTAM     DOWN     UP       COMM     SYSTEMA  CD=DU PR=JES2
  CICP     DOWN     UP       DC       SYSTEMA  CD=DU PR=VTAM APLCICP
  CICT     DOWN     UP       DC       SYSTEMA  CD=DU PR=VTAM
  TCP      DOWN     UP       COMM     SYSTEMA  CD=DU PR=VTAM APLTCP
  IDMS     DOWN     UP       DB       SYSTEMA  CD=DU PR=JES2
  IMS      DOWN     UP       DB       SYSTEMA  CD=DU PR=JES2
  NETV     DOWN     UP       COMM     SYSTEMA  CD=DU PR=VTAM JES2 APLNETV
  OMON     DOWN     UP       IOA      SYSTEMA  CD=DU PR=JES2 APLOMON
  CTM      DOWN     UP       IOA      SYSTEMA  CD=DU PR=JES2
  CTD      DOWN     UP       IOA      SYSTEMA  CD=DU PR=JES2
  ADAB     DOWN     UP       DB       SYSTEMA  CD=DU PR=JES2
  DB2T     DOWN     UP       DB2      SYSTEMA  CD=DU PR=JES2
  DB2P     DOWN     UP       DB2      SYSTEMA  CD=DU PR=JES2
  APLOMON  CHANGING ACTIVE   COMM     SYSTEMB  CD=OU
  APLNETV  CHANGING ACTIVE   COMM     SYSTEMB  CD=OU
  APLCICP  CHANGING ACTIVE   COMM     SYSTEMB  CD=OU
  APLCICT  CHANGING ACTIVE   COMM     SYSTEMB  CD=OU
  APLTCP   CHANGING ACTIVE   COMM     SYSTEMB  CD=OU
  ELD      UP       UP       SYSIMAGE FORCE_OK GLOBAL FORCE_OK
  S START  P STOP  B BOUN. F FREE  H HELD  O FORCE_OK. N NOPRE  R USER  15.38.48

Fields in the Default (S) Display Type

This display type contains all of the information on the Display Type D. However, in place of the MODE column, the following field and information is displayed:

CPU – Name of the system to which the managed object belongs.

Display Type A (All)

Below is an example of the All Fields display type of the Object Status screen.

Figure 5 Object Status Screen – Display Type A (All)

Copy 
----------------------- CONTROL-O COSMOS OBJECT STATUS  ------< A >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OBJECT   CD  OBJECTDB OPSYSID  CLASS    LASTCHNG GROUP    APPL      CURRENT
  JES2     DD  COSSTCOB STC25362 BASE     COSACT04 SYSMVS   JES2      DOWN
   
           DETAIL  JES2                                     DESIRED   DOWN
           STATUS  STEADY DOWN                              MODE      FREE
           CPU     ESA1          DEBUG  N RETRIES  0        NUMOFCHG  7
           USER-I
           ESERV
  VTAM     DD  COSSTCOB STC25363 COMM     COSACT04 SYSNCP   VTAM      DOWN
   
           DETAIL  VTAM                                     DESIRED   DOWN
           STATUS  STEADY DOWN                              MODE      FREE
           CPU     ESA1          DEBUG  N RETRIES  0        NUMOFCHG  7
           USER-I
           RESERV
  CICP     DD  COSSTCOB STC25371 DC       COSACT04 SYSTEM   AUTOSTC   DOWN
   
           DETAIL  CICS PROD                                DESIRED   DOWN
           STATUS  STEADY DOWN                              MODE      FREE
           CPU     ESA1          DEBUG  N RETRIES  0        NUMOFCHG  7
           USER-I
           RESERV
  CICT     DD  COSSTCOB STC25372 DC       COSACT04 SYSTEM   AUTOSTC   DOWN
   
S START  P STOP  B BOUN. F FREE  H HELD  O FORCE_OK  N NOPRE  R USER 14.13.39

Fields in the All Fields (A) Display Type

The following information is displayed:

Table 7 Fields in the All Fields (A) Display Type

Field

Description

<A>

Indicates the All Fields display type.

O (Option)

Allows entry of line options to be applied to a specific object.

OBJECT

Name of the object.

CD

Abbreviated combination of the current and desired statuses of the objects. The value appearing in this field is in format:

xy

where

  • x: One-character value indicating the current status.
  • y: One-character value indicating the desired status.

Valid values for x and y:

  • D: Down status (or a specified synonym).

  • U: Up status (or a specified synonym).

  • ?: Unknown status (or a specified synonym).

  • O: Other status (for example, CHANGING, or STARTING).

OBJECTDB

Name of the Object database in which the object is defined.

OPSYSID

ID assigned by the operating system to the current run of the object (for example, job ID of the started task).

CLASS

Object class. This field can be used to create logical groups of objects, for easier management by method rules, described in Component Details."

LASTCHNG

Name of the Control-O/COSMOS rule that last changed the object’s status or mode

GROUP

User-defined group name for the object.

APPL

User-defined name for the application of the object. This field can be used as a common descriptive name for object groups (meaning, for one or more different groups).

CURRENT

Current status of the object.

DETAIL

Free text description of the object.

DESIRED

Desired status of the object.

STATUS

Status of the object as determined by Control-O/COSMOS’s analysis of the object the last time Control-O/COSMOS scanned the Object database.

MODE

Control-O/COSMOS mode of the objects. Indicates how Control-O/COSMOS is currently managing the object. valid values:

  • FREE – Normal operation mode.

  • NOPRE – Prerequisites are not checked before changing the status of the object.

  • FORCE_OK – Desired status of the object is modified to match the current status. If the current status is changed, the desired status is modified again so that it continues to match the current status.

  • HELD – The object is kept in the current status. No changes are made to the object status (regardless of whether or not the current status and desired status of the object match).

  • If a mode other than FREE is specified for a database or for all of Control-O/COSMOS, that mode overrides the mode specified for specific objects. For more information, see Database Status Screen.

CPU

ID of the CPU on which the object is running.

DEBUG

Whether or not the object is running in DEBUG mode. If the object is running in debug mode, a shout message is issued each time a change is made to the object’s status.

RETRIES

Number of times a Control-O/COSMOS action has been attempted unsuccessfully (meaning, the number of unsuccessful attempts made to change the current status of the object since the last time its status was changed).

NUMOFCHG

Number of times the status of the object changed since Control-O/COSMOS was activated.

USER-I

User supplied data or information, if desired (taken from column USERDAT1 in the database. The contents of this field do not affect Control-O/COSMOS.

RESERV

Reserved for future use (in column COSRSRV1 in the database).

Display Type O (Operator)

Below is an example of the Operator display type of the Object Status screen.

Like the Default display type, the Operator display type describes each object on one line of the screen. However, different fields (meaning, fields more relevant to the operator) are displayed.

Figure 6 Object Status Screen – Display Type O (Operator)

Copy 
----------------------- CONTROL-O COSMOS OBJECT STATUS  ------< O >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OBJECT   CD  OBJECTDB OPSYSID  CLASS    LASTCHNG GROUP    APPL      CURRENT
  ELD      UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 ELD      ELD        UP
  PDSMAN   UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 PDSMAN   PDSMAN     UP
  BB$CSWRN UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 BB$CSWRN BB$CSWRN   UP
  RESOLVE  UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 RESOLVE  RESOLVE    UP
  LSERV    UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 LSERV    LSERV      UP
  D54TROLD UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 D54TROLD D54TROLD   UP
  TSO      UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 TSO      TSO        UP
  LPSERVE  UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 LPSERVE  LPSERVE    UP
  SNMPD    UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 SNMPD    SNMPD      UP
  LPSERVE  UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 LPSERVE  LPSERVE    UP
  S22ACS   DD  COSIMGOB UNKNOWN  SYSIMAGE COSMET03 S22ACS   S22ACS     DOWN
  NETVSSI  UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 NETVSSI  NETVSSI    UP
  PROTROLO UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 PROTROLO PROTROLO   UP
  N5OTROLO UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 N5OTROLO N5OTROLO   UP
  MB5TROLM DD  COSIMGOB UNKNOWN  SYSIMAGE COSMET03 MB5TROLM MB5TROLM   DOWN
  M51ASMPE DD  COSIMGOB UNKNOWN  SYSIMAGE COSMET03 M51ASMPE M51ASMPE   DOWN
  D54PRINT UU  COSIMGOB UNKNOWN  SYSIMAGE COSACT82 D54PRINT D54PRINT   UP
  AB5OMON1 DD  COSIMGOB UNKNOWN  SYSIMAGE COSMET03 AB5OMON1 AB5OMON1   DOWN
  GBWGATE  DD  COSIMGOB UNKNOWN  SYSIMAGE COSMET03 GBWGATE  GBWGATE    DOWN
  S23GATE  DD  COSIMGOB UNKNOWN  SYSIMAGE COSMET03 S23GATE  S23GATE    DOWN
  S START  P STOP  B BOUN. F FREE  H HELD  O FORCE_OK  N NOPRE  R USER 14.16.16

Fields in the (O) Display Type

The following information is displayed:

Table 8 Fields in Display Type O

Field

Description

<O>

Indicates the Operator display type.

O (Option)

Allows entry of line options to be applied to a specific object.

OBJECT

Name of the object.

CD

Abbreviated combination of the current and desired statuses of the object. For more information, see the description of this field in Display Type A (All).

OBJECTDB

Name of the Object database in which the object is defined.

OPSYSID

ID assigned by the operating system to the current run of the object (for example, job ID of the started task).

CLASS

Object class. This field can be used to create logical groups of objects. Control-O/COSMOS methods can be created for management of specific objects, or all objects in a specific class. For more information about Control-O/COSMOS methods, see Component Details.

LASTCHNG

Name of the Control-O/COSMOS rule that last changed the object’s status or mode.

GROUP

User-defined group name for the object.

APPL

User-defined name for the application of the object. This field can be used as a common descriptive name for object groups (meaning, for one or more different groups).

CURRENT

Current status of the object.

Options of the Object Status Screen

The following valid options, listed at the bottom of the screen, can be applied to any row in the Object Status screen:

Table 9 Options of the Object Status Screen

Code

Option

Description

S

(START)

Set the Desired status of the object to UP.

P

(STOP)

Set the Desired status of the object to DOWN.

B

(BOUNCE)

Recycle an object by first setting the desired status to DOWN and then (after the object is brought down) resetting it to UP.

F

(FREE)

Set the Control-O/COSMOS mode of the object to FREE.

H

(HELD)

Set the Control-O/COSMOS mode of the object to HELD.

O

(FORCE_OK)

Set the Control-O/COSMOS mode of the object to FORCE_OK.

N

(NOPRE)

Set the Control-O/COSMOS mode of the object to NOPRE.

R

(USER)

Triggers a user-defined action (rule) on the object. Choosing this options triggers rule COSACT98 that is supplied with Control-O/COSMOS. This rule can be customized by the user to perform an action not handled by predefined options. For more information, see Component Details.

UP and DOWN statuses mentioned above refer to the values specified for UP and DOWN statuses for the relevant Object database in member COSMOLST. For more information on the various status names, see Component Details.

Control-O/COSMOS Database Status Screen – Selection Window

The Database Status screen displays information about Control-O/COSMOS Object Databases. Options in the Database Status screen can be used to modify the mode of an Object database or of the entire Control-O/COSMOS facility.

To display the Database Status screen, specify S (Select) to the left of option DATABASE in the Control-O/COSMOS Main menu and press Enter. The following window is displayed.

Figure 7 Database Status Screen – Selection Window

Copy 
-----------------------  CONTROL-O COSMOS STATUS  ------------< D >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OPTION                         DESCRIPTION
  OBJECT    COSMOS Object Status
S DATABASE  COSMOS Database Status
===== +--------------------------------------------------------------------+
      |                                                                    |
      |                      Please Enter Parameters                       |
      |                                                                    |
      |   DATABASE       ==> *                                             |
      |                                                                    |
      +--------------------------------------------------------------------+
   
   
   
   
   
   
   
   
   
   
SELECT AN OPTION AND PRESS ENTER                                       15.36.53

Specify the name (or mask) of the Object databases to be displayed and press ENTER. The Database Status screen is displayed.

Database Status Screen

The Database Status screen contains basic information about Control-O/COSMOS Object databases. Options in this screen are similar to the options that can be specified in the Object Status screen (described above). However, in this screen, the options affect the mode of a specified database.

In addition, the first record in this screen (ALL) can be used to specify options that affect Global Control-O/COSMOS mode.

Use the scrolling PFKeys to scroll the Database Status screen forward and backward.

Figure 8 Database Status Screen

Copy 
---------------------- CONTROL-O COSMOS DATABASE STATUS  -----< D >--------(OC)
COMMAND ===>                                                    SCROLL===> CRSR
O OBJECTDB     METHODDB     MODE         UP           DOWN         UNKNOWN
  ALL                       FREE
  COSSTCOB     COSALLMT     FREE         UP           DOWN         UNKNOWN
  COSVTMOB     COSALLMT     FREE         ACTIVE       INACTIVE     UNKNOWN
  COSIMGOB     COSALLMT     FORCE_OK     UP           DOWN         UNKNOWN
====== >>>>>>>>>>>>>>>    NO MORE ENTRIES IN THE LIST    <<<<<<<<<<<<<<< ======
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
OPTIONS:  F FREE  H HELD  O FORCE_OK  N NOPRE                       15.41.46

The information included in the Database Status screen is built from member COSMOLST in the Control-O PARM library. For information about the format of this member and how to modify the information, see Component Details.

The following fields are displayed in the Database Status screen:

Table 10 Fields of the Database Status Screen

Field

Description

O (Option)

Option field. Allows entry of line options to be applied to a specific object.

OBJECTDB

Name of the Object database.

METHODDB

Name of the Method database used to determine actions for the Object database.

MODE

Control-O/COSMOS mode for the database. Valid values are:

  • FREE – Normal operation mode.

  • HELD – Objects in the database are kept in the current status. No changes are made to the status of objects in the database (regardless of whether or not the current status and desired status of the objects match)

  • FORCE_OK – Desired status of objects in the database are modified to match the current status. If the current status of an object is changed, its desired status is modified again so that it continues to match the current status

  • NOPRE – Prerequisites are not checked before changing the status of objects in the database.

UP

Name of the UP status for objects in the database (for example, UP, ONLINE, or ACTIVE).

DOWN

Name of the DOWN status for objects in the database (for example, DOWN, OFFLINE, or INACTIVE).

UNKNOWN

Name of the UNKNOWN status for objects in the database (for example, UNKNOWN, or NOTFOUND).

Options of the Database Status Screen

The following valid options, listed at the bottom of the screen, can be applied to any row in the Database Status screen:

Table 11 Database Status Screen Options

Code

Option

Description

F

(FREE)

Sets the Control-O/COSMOS mode of the database to FREE.

H

(HELD)

Sets the Control-O/COSMOS mode of the database to HELD.

O

(FORCE_OK)

Sets the Control-O/COSMOS mode of the database to FORCE_OK.

N

(NOPRE)

Sets the Control-O/COSMOS mode of the database to NOPRE.

Specifying an Option for the Entire Control-O/COSMOS Facility

The first row in the Database Status screen can be used to specify the mode in which all Control-O/COSMOS-controlled objects are handled. Specify a valid option to the left of the first record in the screen (with ALL in the OBJDB column) to apply an option to all Control-O/COSMOS-controlled objects.

When a mode is specified for all of Control-O/COSMOS, the mode is not changed in each record in the Object databases, but the objects are handled as if the specified mode was indicated for them.

  • If mode FREE is specified for the first record in the Database Status screen, the mode of each Object database determines the handling of objects.

  • If mode FREE is specified for the first record in the Database Status screen, and mode FREE is specified for an Object database, objects defined in the database are handled according to the mode specified in each record of that Object database (meaning, object-specific mode).

Screen IV: IOA Variable Database Facility

Screen IV enables you to define, view, and manipulate the Control-O/COSMOS databases (as well as other IOA databases).

For more information about this facility, see IOA Variable Database Facility in the INCONTROL for z/OS Administrator Guide.