Reporting status for objects and sets


The MAMSTAT EXEC helps you to report on the status of specified objects or sets. You can choose to report on the named object, set of parents, children, both or neither. You can also filter the result for a system or for a status. 

MAMSTAT was designed for use from a TSO session when the user interface is unavailable. It can also be executed as a call from another piece of automation (Rule or EXEC).  If BMC AMI Ops Automation is running in the local system results will be written to the BBI journal.  If automation is not available, results will be written back to the TSO session.

The following parameters can be used by MAMSTAT:

Node

Required

Description

NAME()

Object or set name to report status. (Optional)

BBPLEX01.SYSA.TSO

TYPE(OBJ|SET)

Specify OBJ to return status for an object or SET to return status for a set.  Leave blank to get information for either type. (Optional)


OBJ

SYSTEM()

Name of a system for returning object status.  Leave blank to get status for all systems. This parameter will be ignored for sets


SYSA

TOMID()

ID of a TOM PAS.  Used to get the status on the system associated with the TOM PAS.


TOMKZt

STATUS()

Specify to return only objects or sets with the named status.  Leave it blank to get all status. (Optional).

LOCKED

SCOPE(NONE|ALL|PARENTS|CHILDREN)

Indicates whether to return statuses for the specified object or set along with its parent, children, both or neither. Value defaults to NONE.

NONE

To use MAMSTAT

  1. From  the BBSAMP data set, copy EXEC MAMSTAT to a library in the SYSPROC DD concatenation of the 

    BMC AMI OpsA

     PAS.

  2. (Optional) In the SYSPROC DD, edit the copy of MAMSTAT to make any required changes to the default values of the parameters.

    Warning

    Important

    MAMSTAT should be scheduled from the BMC AMI OpsA PAS that is connected to the TOM PAS.  

    When you issue MAMSTAT, the results are shown in the following format:

     OBJECT: <object name>
        SYSTEM:<system #1 in objects VSL>        STATUS:<status on system #1>
        SYSTEM:<system #2 in objects VSL>        STATUS:<status on system #2>
        SET:<set name>
        STATUS:<status of the set>                                             

    For example, we have two objects:

    Information
    Example

    Object 1:

     Name: OBJ1

    System #1: SYSA      status: ACTIVE
    System #2: SYSB      status: STOPPED

    Object 2:

    Name: OBJ2

    System #1: SYSA      status: LOCKED

    Example #1:

    Issuing: “%MAMSTAT NAME(OBJ1)” will result in:

                          OBJECT: OBJ1

    SYSTEM: SYSA        STATUS:ACTIVE
    SYSTEM: SYSB        STATUS: STOPPED

                             

    Example #2:

    Issuing: “%MAMSTAT SYSTEM(SYSA)” will result in:

                          OBJECT: OBJ1

    SYSTEM: SYSA        STATUS: ACTIVE

                             

                          OBJECT: OBJ2

    SYSTEM: SYSA        STATUS: LOCKED

    Example #3:

    Issuing: “%MAMSTAT STATUS(LOCKED)” will result in:

                          OBJECT: OBJ2

    SYSTEM: SYSA        STATUS: LOCKED

 

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

BMC AMI Ops Automation 8.3.01