listagent Command—Display Status Information for Agents

You can view the agent status information by issuing the LISTAGENT command. You can filter the status information by agent name or by status (active, inactive, quiesced) and view detailed status information.

This command the following format:

listagent agent("agent") [status("status")] [type("type")] [verbose(true|false)]

agent("agent")

Specifies the name of the agent to list.

Default: All agents are listed.

Note: You can include a wildcard for a partial name. For example, AG* displays all the agents whose names start with AG. * represents any string of zero or more characters. ? represents any single character.

status("status")

(Optional) Lists agents by status. Options are active, inactive, and quiesced.

type("type")

(Optional) Lists agents by type. Options are the following:

appserv—Application Services
db—Database
informatica—Informatica
microfocus—Micro Focus
mssqlserver—Microsoft SQL Server
oracle—Oracle E-Business Suite
os400— i5/OS
peoplesoft—PeopleSoft
remoteexecution—Remote Execution
sapr3—SAP-R/3
tandem—Tandem (virtual)
unix—UNIX
virtual—Virtual
vms—Open-VMS (virtual)
winnt—Windows
ws—Web Services
zos—z/OS

verbose(true|false)

(Optional) Indicates whether to display detailed status information. Options are the following:

true: Displays detailed status information
false: Does not display detailed status information

Default: verbose(false)

Examples: Display Status Information for Agents

The following example displays the status of an agent:
```
listagent agent("agent")
AGENT
Status: Inactive
```

The following example displays detailed status information for an agent:

listagent agent("agent") verbose(true) 
AGENT
Status: Inactive
Quiesced: No
Address: EManero1
Port: 7520
Type: Windows-NT/2000
Version: Release 7
Operating System: Windows
Character Code: ASCII
SNMP Enabled: No
Heartbeat Frequency: 2
Strong Encryption Enabled: No

The following example displays detailed status information for all the agents:

listagent agent("*") verbose(true)
WFOX24
Status: Active
Quiesced: No
Address: chiki03-test
Port: 8484
Type: Windows
Version: Release 11.3
Operating System: Windows
Character Code: ASCII
SNMP Enabled: No
Heartbeat Frequency: 5
Encryption Method: DES

WFOX25
Status: Active
Quiesced: No
Address: wade01
Port: 8484
Type: Windows
Version: Release 11.3
Operating System: Windows
Character Code: ASCII
SNMP Enabled: No
Heartbeat Frequency: 5
Encryption Method: DES

SFOX24G
Status: Inactive
Quiesced: No
Address: HOSTNAME
Port: 7520
Type: Windows-NT/2000
Version: Release 11.3
Operating System: Windows
Character Code: ASCII
SNMP Enabled: No
Heartbeat Frequency: 5
Encryption Method: DES