A status definition identifies a user-program that is to be called by CICSPlex® SM at specific intervals.
To display information about existing status definitions, issue the command:
STATDEF [statdef]
where statdef is the specific or generic name of a status definition. If you omit this parameter, the resulting view, illustrated in Figure 44, includes information about all existing status definitions within the current context.
27FEB2005 16:17:25 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =STATDEF===========EYUPLX01=EYUPLX01=27FEB2005==16:17:25=CPSM============== CMD Name Program Intvl Action Description --- -------- -------- ----- -------- ----------------------------- EYURST06 DB2STATE 60 SSet - Probe for DB2 Appl
Table 29 summarizes the action commands you can use with the STATDEF view.
Primary command | Line command | Description |
---|---|---|
n/a | ADD | Add an association between a status definition and an analysis group, as described in topic Adding a status definition to an analysis group. |
n/a | BRO | Browse a status definition in the data repository.
The format of the resulting panel is similar to that shown in Figure 45. The panel fields are not modifiable. |
CREate | CRE | Create a status definition and add it to the data repository, as
described in topic Creating a status definition.
When you use the primary command CREate, some fields in the new view may contain values supplied by CICSPlex SM; you may change these values. When you enter the line command CRE next to the name of a status definition, fields in the new view contain values to be modelled (from the existing status definition). |
n/a | INS | Install a status definition in a CICS® system or CICS system group, as described in topic Installing a status definition. |
n/a | MAP | Display a visual map of real-time analysis definitions using the specified definition as a starting point. |
n/a | REM | Remove a status definition from the data repository. |
TEMPMP cmasid | n/a | Change the temporary maintenance point CMAS to a specific CMAS or display a selection list based on a generic CMAS ID. |
n/a | UPD | Update a status definition in the data repository.
The format of the resulting panel is similar to the panel shown in Figure 45. You can modify the contents of any field in the panel except Name. |
There are no hyperlink fields on the STATDEF view.
Figure 45 shows the format of the panel produced when you use the create primary (CREate) or line (CRE) action command from the STATDEF view.
--------------------- Create Status Definition for EYUPLX01 ------------------ COMMAND ==> Name ===> EYURST06 Description ===> SSet - Probe for DB2 Appl Program Name ===> DB2STATE Name of Status Program Call Interval ===> 60 Interval Between Calls in Seconds Action Name ===> Action Definition Name or Generic User ID ===> User ID for Task Transaction ID ===> Transaction ID for Task VLS LS LW HW HS VHS Entry Intervals ===> 0005 0005 0005 0005 0005 0005 Exit Intervals ===> 0002 0003 0001 0001 0003 0002 Press Enter to create the Status Definition. Type END or CANCEL to cancel without creating.
Provide the following information, as appropriate.
If the program is to return status information about multiple conditions and you can create one status definition for each condition, where:
(For more information about writing programs to monitor status, see Appendix A. Customizing programs that monitor status.)
Press Enter to add the status definition to the data repository.
Figure 46 illustrates the panel produced when you use the add (ADD) line action command from the STATDEF view.
---------------------- Add STATDEF to Analysis Group for EYUPLX01------------- COMMAND ===> Status Definition EYURST06 Description SSet - Probe for DB2 Appl Analysis Group ===> EYURTG10 Analysis Group or Generic Active Period ===> PRIME Period Name or Generic Press Enter to add Status Definition to Analysis Group. Type END or CANCEL to cancel without adding.
Provide the following information:
If the name you specify is not an existing period definition, you can create that period definition later. If you leave this field blank, the status definition remains active for as long as the CICS system is running or until you discard it.
Press Enter to add the status definition to the designated analysis group in the data repository.
You can install a status definition in one or more active CICS systems that are within the CICSplex identified as the context.
Figure 47 illustrates the panel produced when you use the install (INS) line action command from the STATDEF view.
----------------------- Install STATDEF for EYUPLX01 -------------------------- COMMAND ===> Name EYURST06 Description SSet - Probe for DB2 Appl Type STATDEF Scope ===> CICS System, System Group, or Generic Active Period ===> Blank, PERIODEF, or Generic Press Enter to install Status Definition. Type END or CANCEL to cancel without installing.
Provide the following information:
Press Enter to install the definition in the designated CICS systems.
For an installation to succeed, the CICS system must be running and real-time analysis must be active. The status definition becomes active either:
The status definition remains active as long as the CICS system is running, until you discard it, or until the time designated by an associated period definition is reached.
To discard a status definition installed in a CICS system, use the RTAACTV view as described in Table 3.
[[ Contents Previous Page | Next Page Index ]]