Previous Topic: unistart - Start Enterprise Management Functions

Next Topic: unishutdown-Shut Down Enterprise Management and Related Services

unifstat-Check Status of Enterprise Management

Applies to UNIX/Linux, Windows, z/OS

Use the unifstat command to display the status of the Enterprise Management functions, common objects, and services currently configured on the specified machine.

unifstat (UNIX/Linux)

This command has the following format:

unifstat

This command has the following format:

unifstat [-h]
         [-r]
         [-p]
         [-v]
         [-c component]
         [-u subcomponent]
         [-s node]

Note: If UNIFSTAT is issued without any options, the assumed default is UNIFSTAT -C * -U *. This displays the status of all components and subcomponents on the current machine.

-h

Displays syntactical help information for the unifstat command.

-r

Displays requisite information for the selected components/subcomponents. Both prerequisite and corequisite information is displayed. A component that is a prerequisite must reach an ACTIVE state before the dependent component can be started or resumed. A component that is a corequisite must maintain an ACTIVE state before the dependent component can be paused.

Note: This option should be specified only under the direction of CA Technologies Support.

-p

Displays process information associated with the selected components/subcomponents. An Active Process list and a Critical Process list are displayed (as appropriate) for each component/subcomponent.

Within each list the process ID and thread ID of the processes for the component are listed. Processes listed in the Critical Process list are essential to the operation of the component. If a Critical Process should die, the component would stop.

-v

Provides additional details about the information requested.

Note: This option should only be specified under the direction of CA Technologies Support.

-c component

Identifies the Enterprise Management components for which status information is desired. A trailing asterisk (*) may be used to select a group of components. Specify -c * to display all of the currently registered components for a machine. This list will show you the possible values, which may be specified for component.

Every registered component moves through several states during the course of Enterprise Management operation. There are three groups of states: terminal, transitory, and wait:

Terminal States

Terminal states are reached using the unicntrl command or through the control panel. The possible terminal states are:

ACTIVE

The component is active

INACTIVE

The component is inactive

PAUSED

The component is paused

Transitory States

Transitory states occur on the way to a terminal state. It is NOT normal for these states to persist for more than a minute or two. The possible transitory states are:

START_PENDING

The component is being started

PAUSE_PENDING

The component is being paused

RESUME_PENDING

The component has been resumed after a pause

TERM_PENDING

The component has received a STOP order

Wait States

Wait states may persist for a while, but are not indicative of a fully active system. The possible wait states are:

START_PENDING_REQUISITE

The START order for the component has been delayed because the component is a dependent and the requisite component is not at the necessary state.

RESUME_PENDING_REQUISITE

The RESUME order for the component has been delayed because the component is a dependent and the requisite component is not at the necessary state.

-u subcomponent

Identifies the subcomponents (of Enterprise Management components) for which status information is desired. A trailing asterisk (*) may be used to select a group of subcomponents. If the -u option is not specified, the status of all the subcomponents of the selected Enterprise Management components will be generated. For a list of all possible subcomponents, specify only the -c * option.

-s node

Identifies the machine for which you are requesting Enterprise Management status. If the -s option is not specified, the machine on which the unifstat command is issued is assumed.

Options

None.

Files

$CAIGLBL0000/bin/unifstat

Script file for unifstat command.

$CAIGLBL0000/scripts/unifstat.awk

The awk program source code.