Important This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent for BMC Helix Operations Management 23.4.

%DUMP APP_INSTS--List Instances


List application instances from the object namespace with their properties

Syntax

 %DUMP APP_INSTS

Parameters

This command has no parameters.

Description

For each application instance in the PATROL Agent’s object namespace, information is listed in the following format:

Instance ID: instance_id Appl Type: appl_type Object ID:
object_id Active: active
Version: version Home: home
Appl Username: appl_username Password: password
O/S Username: os_username
State: state Rule State: rule_state Worst Param State:
worst_param Worst Inst State: worst_state
Transition Timer: trans_timer
Parameters: params
Process info: process_info

Field

Definition

instance_id

SID for the instance

appl_type

application class

object_id

numeric object ID of the instance

active

true if instance is active, false if instance is not active. The comment (blacked out) is appended if the instance is in a blackout state

version

instance version (monitored software)

home

home directory for instance

appl_username

one of these values:

  • user name from definition of application class
  • inherit when the value is inherited from the object hierarchy
  • none when no application user name is defined

password

one of these values:

  • restricted info when a password is defined
  • inherit if the value is inherited through the object hierarchy
  • none if no password is defined

os_username

displays one of these values:

  • user name defined for this instance by value in the PATROL Agent’s configuration database
  • inherit if the value is inherited through the object hierarchy

state

overall state of the instance, including states determined from its parameters

rule_state

status of the instance based on discovery information only, without considering the state of its parameters

worst_param

status of “worst” parameter on this instance, with the name of the parameter

worst_inst

status of “worst” child instance for this instance

trans_timer

timeout of transition timer used by PSL function in_transition()

params

reports one of the following status types for parameter execution:

  • Global params suspended
  • All params suspended
  • All params active

process_info

For instances created by simple discovery, this value displays the process ID and name of the process being monitored.
For standard discovery by scripts or commands, the value is displayed as none.

Note

 The %DUMP APP_INSTS command is one of a series of dump commands available from the command line. Use the %DUMP command (no argument) to obtain a list of items that can be dumped.

 

Where to go from here

PSL-External-Commands 

 

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