When Control-O/COSMOS is started, information is copied from the Source Object databases to the Working Object databases.
Addition, modification and deletion of Control-O/COSMOS-controlled objects are performed on only the Source Object databases. These operations are performed using the Variable Database Definition facility (screen IV), described in Online Facilities.
Each object is described by a row in the Source Object database. The following columns must be included in the Source Object database:
Table 13 Required Columns in the Source Object Database
Column |
Description |
---|---|
OBJECT |
Name of the object (for example, CICSTEST, CICSPROD, JES2, LU1290). |
DESIRED |
Desired status of the object (for example, UP, or DOWN). |
MODE |
Object operating mode. For more information, see Control-O/COSMOS Rules. valid values:
|
CLASS |
Class of the object (for example, CICS). This field is used as an alternative to matching the object’s name when searching for a method to change the current status. |
DETAIL |
Free text description of the object. |
DEBUG |
Generate debugging information created when Control-O/COSMOS handles the object. If Y is specified, the Debug facility is activated and a SHOUT message is issued each time a Control-O/COSMOS-controlled object’s status is changed. |
GROUP |
User-defined group name for the object. |
APPL |
User-defined application 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). |
CPU |
ID of a CPU, or ALL. This field is used to determine which objects are copied to the Working Object databases in each CPU. If ALL is specified for an object, that object is copied to the Working Object database in each CPU. |
ATIPL |
Value of the desired status if Control-O/COSMOS is started during an IPL. |
NOTIPL |
Value of the desired status if Control-O/COSMOS is not started by during IPL. |
USERDAT1 |
Optional user-supplied information. This information does not affect Control-O/COSMOS. This value appears in the USER-I field in the All Fields display type of the Control-O/COSMOS Objects Status screen. |
USERDAT2 |
Same as USERDAT1, but not shown in the All Fields display type. |
COSRSRV1 |
A value of N indicates that IEF403I sets the object's status to UP without waiting for an additional message (such as "… initialization complete" or "… is ready"). |
COSRSRV2 |
Reserved for future use; not shown in the All Fields display type. |
The following screen segment contains sample content of a Source Object database (as displayed in the Variable Database screen):
Figure 10 Source Object Database Example
ROW CPU OBJECT DESIRED ATIPL NOTIPL MODE CLASS
00001000 ALL JES2 DOWN UP DOWN FREE BASE
00002000 ALL VTAM DOWN UP DOWN FREE COMM
00003000 ALL CICP DOWN UP DOWN FREE DC
00004000 ALL CICT DOWN UP DOWN FREE DC
00005000 ALL TCP DOWN UP DOWN FREE COMM
00006000 ALL IDMS DOWN UP DOWN FREE DB
00007000 ALL IMS DOWN UP DOWN FREE DB
00008000 ALL NETV DOWN UP DOWN FREE COMM
00009000 ALL OMON DOWN UP DOWN FREE IOA
Note: Only seven columns of the Source Object database can be displayed at one time. Additional columns can be viewed by using the RIGHT and LEFT scrolling conventions.
Information in the Source Object database is copied to columns with the same names in the Working Object database. If a column exists in the Source Object database, and no column with the same name is found in the Working Object database, information in that column is not copied.
Note: Columns ATIPL, NOTIPL and DESIRED (described above) are not copied to the Working Object database. These fields are used by Control-O/COSMOS initialization procedures to determine the startup value for the DESIRED column in the Working Object database. The Control-O/COSMOS startup option is specified in response to a WTOR message issued by command COSINI, described in COSINI Command – Starting Control-O/COSMOS.
Parent Topic |