• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• OPERANDS
• EXAMPLES
• EXIT STATUS
• SEE ALSO

NAME

 list-node-agents - lists the node agents along with their status

SYNOPSIS

 list-node-agents user user passwordfile filename [host localhost] [port port_number] [secure=false] [terse=false] [echo=false] [interactive=true] [target]

DESCRIPTION

The list-node-agents command displays the node agents along with their status (as an example, running or stopped). If the target is omitted, all node agents are listed.

OPTIONS

u user

The authorized domain application server administrative username.

password

The password option is deprecated. Use passwordfile instead.

W passwordfile

The name of the file containing the domain application server password. The syntax for passwordfile is as follows: AS_ADMIN_PASSWORD=password. If this option is not called directly, the user will be prompted for it before the requested action is completed.

H host

The machine name where the domain application server is running.

p port

The port number of the domain application server listening for administration requests. The default port number for Platform Edition is 4848. The default port number for Enterprise Edition is 4949.

s secure

If set to true, this command uses SSL/TLS to communicate with the domain application server. The default is false.

t terse

Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. The default is false.

e echo

Setting this option to true will echo the command line statement on the standard output. The default is false.

I interactive

If this option is set to true (default), the user will be prompted for the required password options.

OPERANDS

target

This operand specifies which node agents are to be listed. The options are:

• domain This is the default. Domain lists all of the node agents in the domain.

• <cluster-name> This lists all of the node agents associated with the named cluster.

• <instance-name> This lists all of the node agents associated with the named server instance.

• <agent-name> This lists the named node agent.

EXAMPLES

Example 1. Using list-node-agents

This is a basic example of how the command is used.

%asadmin>list-node-agents --user admin1 --passwordfile filename
agent1 not running
Command list-node-agents executed successfully.

Where: % is the command prompt and agent1 is the only node agent in the domain.

EXIT STATUS

0

command executed successfully

1

error in executing the command

SEE ALSO

create-node-agent(1), delete-node-agent(1), start-node-agent(1), stop-node-agent(1)