Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

CSM Global Overview panel


The following figure shows an example of the Global Overview panel for CSM.

BMC Software ------------------ Global Overview ------------------- BMC AMI OpsA
COMMAND ===>                                                   SCROLL ===> CSR
                                                                  TGT ---  KMZ1
Primary Commands: EXCeption  Group     SORT    SAVE      ADD      
                  CALendar   CANcel    UNsort  PROFile   BUild
                  Locate     CMDSHOW   Xref    SAVERULE  SHUTSYS

LC CMDS -------- (S)tart   b(O)unce  rese(T)   depe(N)dents  (A)dd
                 sto(P)    (EX)ec    (E)dit    c(L)ients     (D)elete
                 (CAN)cel  (M)ove    (R)epeat  (B)rowse      s(Y)nc
                 (EN)able  (DIS)able                  
                        
LC  Object    Group    System    Actual      Desired      Ind    Type
    ________ ________ ________  ____________ ____________ _____ ________
___ MVS                                                         NORM
___ AAOCSM01 KMZ1     SJSD      UP           UP                 NORM
___ AAOCSM01 KMZ5               INACTIVE     INACTIVE           NORM
___ AAOCSM02 KMZ1     SJSD      COMPLETE     COMPLETE           TRAN
___ AAOCSM02 KMZ2               INACTIVE     INACTIVE           TRAN
___ AAOCSM02 KMZ5               INACTIVE     INACTIVE           TRAN
___ AAOCSM08 KMZ1     SJSD      UP           UP                 NORM
___ AAOCSM08 KMZ2               INACTIVE     INACTIVE           NORM
___ AAOCSM08 KMZ5               INACTIVE     INACTIVE           NORM

To view additional information about each object, scroll left by pressing PF10/PF22.

BMC Software ------------ Global Overview - Desc/Stats ----------- BMC AMI OpsA
COMMAND ===>                                                   Scroll ===> CSR
                                                                  TGT ---  KMZ1
Primary Commands: EXCeption  Group     SORT    SAVE      ADD      
                  CALendar   CANcel    UNsort  PROFile   BUild
                  Locate     CMDSHOW   Xref    SAVERULE  SHUTSYS

LC CMDS -------- (S)tart   b(O)unce  rese(T)   depe(N)dents  (A)dd
                 sto(P)    (EX)ec    (E)dit    c(L)ients     (D)elete
                 (CAN)cel  (M)ove    (R)epeat  (B)rowse      s(Y)nc
                 (EN)able  (DIS)able                                           

LC   Object       Description                         Id      Date      Time
     ________     _______________________________ _______  __________  _____
___ AAOCSM01     Child of MVS                     BAOKMZ2  07/10/2000  15:58
___ AAOCSM01     Child of MVS                     BAOKMZ2  07/10/2000  15:58
___ AAOCSM02     Child of MVS, Also               BAOKMZ2  07/10/2000  09:05
___ AAOCSM02     Child of MVS, Also               BAOKMZ2  07/10/2000  09:05
___ AAOCSM02     Child of MVS, Also               BAOKMZ2  07/10/2000  09:05
___ AAOCSM08     Child of MVS Again               BAOKMZ2  06/21/2000  19:35
___ AAOCSM08     Child of MVS Again               BAOKMZ2  06/21/2000  19:35
___ AAOCSM08     Child of MVS Again               BAOKMZ2  06/21/2000  19:35

The following table describes the fields for the CSM Global Overview panel.

Field

Description

Object

contains the name of the object as specified in the object definition

Objects are listed in alphabetical order.

Group

is the name identifying a group of objects managed by Continuous State Manager

This name must be unique among the other members of the CSM-Plex to ensure proper object status reporting on the Global Overview display.

System

is the MVS SYSNAME where the group is enabled

If the group is disabled, this column is blank.

Actual

indicates the object’s current status in the system

This state should always match the desired state. When the actual and desired state do not match, CSM attempts to make them match.

Desired

indicates the object’s desired state which is governed by its schedule

This state should always match the actual state. When the actual and desired state do not match, CSM attempts to make them match.

Ind

indicates object relationships

Possible values are as follows:

L indicates the object has clients.

N indicates the object has children (dependents).

X indicates the object has an outstanding ALERT associated with it. To view the ALERT and its contents, you must use the ALERT Management Facility.

E indicates that the outstanding ALERT associated with the object has a follow-up EXEC.

You can schedule the follow-up EXEC by entering the e(X)ec line commands next to the object in the LC column.

Type

shows the type of object: possible values are NORM (normal object) and TRAN (transient object)

Description

shows a description of the object as specified in the object definition

Id

shows the TSO ID of the last person who modified the object

Date

is the last date that the object was modified

Time

is the last time that the object was modified

The following table describes the primary commands for the CSM Global Overview panel.

Command

Description

Exception | EXC

displays the CSM Exceptions panel

The (MON)itor and (EXC)eption primary commands toggle the display between the CSM Global Overview panel and the CSM Exceptions panel.

On the CSM Global Overview panel, the (EXC)eption command is shown. On the CSM Exceptions panel, the (MON)itor command is shown.

Group

displays the Object Groups application, where you can manage CSM Groups

Sort | SORT

sorts data in (up to) two columns of the CSM display in either ascending or descending order

The default sort sequence is ascending alphabetical order based on the data in the Object column.

Save | SAVE

saves changes but does not activate them until CSM has been reinitialized or a BUILD command is issued

SAVE does not make changes effective immediately. Issue the BUILD command for changes to be saved and activated.

Add | ADD

adds new objects to be controlled by CSM

The added object automatically assumes that MVS is the parent. Enter ADD on the COMMAND line of the CSM panel when defining new objects.

ADD takes effect after you issue the BUILD command.

Calendar | CAL

displays the Global Calendar Override panel from which you can define special schedules for one-time only situations

Cancel | CAN

causes CSM to issue the (CAN)cel command for the selected object

If the definition does not have a (CAN)cel command, the sto(P) command is issued. The (CAN)cel command does not affect the object’s parents or children.

Before canceling the object, CSM prompts you for verification:

Please confirm Cancel for object
Cancel?? N (Y/N)

This command takes effect immediately.

Unsort | UN

causes CSM to return the display to the default sequence of ascending object names

The UNSort has the same effect as specifying: SORT OBJECT A

The UNsort command refreshes the CSM display only; it does not affect the database.

Build | BU

saves your parameter changes in the CSM database and automatically issues a command that tells CSM to reload the control parameters and make the changes effective immediately

This command requires the GROUPNAME parameter. When you issue this command, a confirmation panel appears, requesting verification.

BUILD makes changes effective immediately.

Locate | L

finds a specified object on the CSM display

Format: L object name

CMDSHOW

enables you to control the display of the Primary and Line commands

Issuing the command causes the application to be displayed without the Primary and Line commands.

Issuing CMDSHOW again reverses the change and re-displays the Primary and Line commands.

Xref | X

invokes the CSM Diagnostic Cross-Reference facility to define a cross-reference of the CSM database

The cross-reference report is written to a specified data set from which the report can be browsed or printed. To obtain a printed copy of the report:

  1. Change the default value for Browse from Y to N.
  2. Specify the SYSOUT class; for example:
  3. Data Set Name==>'ABC.CSMXREF.RS31'
  4. Browse report after generation (Y/N)? N
  5. SYSOUT class for printed report? R
  6. Press END to generate or print the cross-reference report.

SAVERULE

generates the CSM Ruleset that is defined for the specified group

The command requires the group name as a parameter.

SHUTSYS

shuts down all the objects in a group with a single command

The command requires that a group name is specified and can have an object as an optional parameter. The default for object is MVS; therefore, if an object is not specified, all objects from the group are stopped. If an object other than MVS is specified, the shutdown occurs for this object and all of its children (dependents).

Format: SHUTSYS groupid object

Example
SHUTSYS PROD - CSM shuts down all objects in group PROD
SHUTSYS PROD TSO - CSM shuts down TSO and all of its children

Exceptions | EXC

when issued on the CSM Global Overview panel, displays the CSM Exceptions panel

The (EXC)eption and (MON)itor primary commands toggle the display between the CSM Global Overview panel and the CSM Exceptions panel.

On the CSM Global Overview panel, the (EXC)eption command is shown. On the CSM Exceptions panel, the (MON)itor command is shown.

Monitor | MON

when issued on the CSM Exceptions panel, displays the CSM Global Overview panel

The (EXC)eption and (MON)itor primary commands toggle the display between the CSM Global Overview panel and the CSM Exceptions panel.

On the CSM Global Overview panel, the (EXC)eption command is shown. On the CSM Exceptions panel, the (MON)itor command is shown.

The following table describes the line commands for the CSM Global Overview panel.

Command

Description

Start | S

starts an object

CSM uses this command or the EXEC that is specified for this object. Before starting this object, CSM prompts you with three verification fields:

Please confirm START for object
? N (Y/N)
START all PARENTS of object
? Y (Y/N)
START now, but STOP as scheduled:
? N (Y/N)

If an object must start without starting its parents, specify N in the second verification field.

If TSO/E and ISPF are not active and an object must be started, use the CSM EXEC, CSMACT.

If the Start or Stop command needs to be issued in response to an outstanding WTOR, you can use the EXEC CSMWTOR supplied by BMC. The CSMWTOR EXEC works only in a JES2 environment. This EXEC has two parameters: object name and reply. The syntax is as follows:

%CSMWTOR object_name reply_text

CSMWTOR can be defined in the Command Specifications panel as the Start or Stop command.

This EXEC locates the outstanding reply from the object and responds to it with the reply text that you specified.

This command takes effect immediately.

Bounce | O

causes CSM to issue a stop command for the selected object and then restart the object immediately if the object’s schedule indicates that the object should be active

All other control parameters for the object remain in effect. The b(O)unce command lets you recycle a task without modifying the normal control parameters for the object.

The b(O)unce command affects only the selected object. It does not affect the object’s parents or children.

This command takes effect immediately.

Reset | T

causes CSM to restore the object to its defined schedule

You might use this command if you have used the (S)tart or sto(P) line commands to start and stop objects.

Before resetting this object, CSM prompts for the following verifications:

Please confirm RESET for object
? N (Y/N)
RESET command count for object
? N (Y/N)
Scope of RESET of :pv.object:epv.
? S (Single/Parent/Children)

The third verification field provides you with three options:

S returns object to its defined schedule.

P returns object and its parents to their defined schedules.

C returns object and its children to their defined schedules.

The rese(T) line command clears the status of an object in a section state and returns it to CSM control.

To reset all objects to their normal schedules, reset MVS and specify C as the scope. Rese(T) takes effect immediately.

Dependents | N

displays the objects that are defined as being dependents (children) of the selected object

In a parent-child relationship, the parent object must be active for the child object to be active. Therefore, if a parent object is taken down, all dependent objects are taken down first.

If the selected object has no dependents defined, the Dependents of object panel contains no data.

Add | A

adds objects to the CSM database

The added object automatically assumes the schedule of the object on which the (A)dd line command was performed and assumes the selected object as a required object.

This command invokes the Object Detail Control panel.

(A)dd takes effect after you issue the BUILD command.

Stop | P

stops an object from the CSM application

CSM uses this command or the EXEC that is specified for this object.

Before stopping this object, CSM prompts for the following verifications:

Please confirm STOP for object
? N (Y/N)
STOP all DEPENDENTS object
? Y (Y/N)
STOP now, but START as scheduled:
? N (Y/N)

If a parent object must stop without stopping its children, specify N in the second verification field.

If TSO/E and ISPF are not active and an object must be stopped, CSMACT should be used.

If the Start or Stop command needs to be issued in response to an outstanding WTOR, you can use the CSMWTOR EXEC supplied by BMC. The CSMWTOR EXEC works only in a JES2 environment. This EXEC has two parameters: object name and reply. The syntax is as follows:

%CSMWTOR object_name reply_text

CSMWTOR can be defined in the Command Specifications panel as the Start or Stop command.

This EXEC locates the outstanding reply from the object and responds to it with the reply text that you specified.

This command takes effect immediately.

Exec | EX

specifies that CSM will schedule a predefined Alert follow-up EXEC for the object on the subsystem indicated in the target field

The E(X)ec command takes effect immediately.

Edit | E

modifies the current control parameters for the selected object

When you issue this command next to the MVS object, the Default Control Parameters panel is displayed.

When you issue this command next to any other object, the Object Detail Control panel is displayed. (E)dit modifications take effect after you issue the BUILD command.

Clients | L

shows the clients of the selected object

In this relationship, an object defined as a server can be started and stopped independently of its clients. After the clients are disconnected from the server through commands, the server then stops. When the server is operational again, all defined clients are reconnected automatically to the server through commands (if the clients are scheduled to be up at that time).

Clients continue to operate while the server is unavailable but might operate in a partially degraded state.

If the selected object has no clients defined to CSM, the Clients of object panel contains no data.

Delete | DE

eliminates the object from CSM control

The selected object must be managed through some other means after this command is issued.

If you attempt to (DE)lete an object that has children, CSM does not allow deletion of the object. Do one of the following actions to delete a parent object:

  • Delete the child objects and then delete the parent object.
  • Redefine the parent-child dependency relationship to be a client-server relationship.
  • Define the child objects to another parent.

(DE)lete modifications take effect after you issue the BUILD command. If you delete an object by mistake, issue the CANCEL primary command.

Cancel | CAN

causes CSM to issue the (CAN)cel command for the selected object

If the definition does not have a (CAN)cel command, the sto(P) command is issued. This command does not affect the object’s parents or children.

Before canceling the object, CSM prompts you for verification:

Please confirm Cancel for object
Cancel?? N (Y/N)

This command takes effect immediately.

Move | M

enables you to move CSM objects from the local BBI-SS PAS to a remote BBI-SS PAS where CSM is installed

Repeat | RE

enables you to duplicate an existing object’s definition to define a new object with the same information

Use this command when you want to define objects with similar attributes. The only limitation is that no two objects can have the same name.

Browse | B

enables you to browse the control parameters for the selected object

The control parameters cannot be modified with this line command. The (B)rowse command displays the Object Detail Control panel.

Synchronize | Y

checks for discrepancies between the current state and the physical state of an object

For example, an object could change state without issuing the expected start/stop messages, so its current and physical states would become unsynchronized.

When you issue this command, CSM checks every defined object to see if it is physically present on the system. After checking for the presence of an object, CSM updates the object’s current state variable.

This command does not change the status of objects that are in a section state.

ENable

enables CSM's control over the object

CSM controls starting or stopping this object.

Issuing the ENable line command enables the object immediately.

DISable

disables CSM's control over the object

CSM does not start or stop this object. CSM ignores this object if it is part of the dependency chain of another object that CSM is starting or stopping.

The object will remains disabled until the object is enabled.

Related topic

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*