2.6.18 list-prfs
The list-prfs subcommand lists the PRF servers.
Synopsis
asadmin [asadmin_options] list-prfs [--long={false|true} |
--nostatus={false|true}] [target]
Storage location
Application Server installation directory/javaee/glassfish/bin
Function
The list-prfs subcommand lists the PRF (Performance Tracer) servers that have been set up in the domain. You can use this command to check the PRF server configuration information and operation status.
This subcommand is supported only in the remote mode.
Execution permission
General user
Arguments
- --long={false|true}
-
Specifies whether to display the detailed information, in a list, about the PRF server.
Type: Boolean
You can specify the following values:
-
true
Displays the PRF server name and its detailed information (host name, process ID, and status). The header information is also displayed.
-
false
Displays only the PRF name and its status. The header information is not displayed.
Default value: false
-
- --nostatus={false|true}
-
Specifies whether to display the status of a PRF server.
Type: Boolean
You can specify the following values:
-
true
Does not display the status.
-
false
Displays the status.
Default value: false
-
- target
-
Specifies the name of the object for which information is displayed. Based on the specified name, the PRF servers are filtered and displayed.
Type: String
You can specify the following values:
-
domain
Displays information about all the PRF servers in a domain.
-
PRF_server_name
Displays information about the specified PRF server.
-
node_name
Displays information about the PRF servers that belong to the specified node.
Default value: domain
-
Output Format
The first line is the header of the output information and displays a fixed character string, which indicates the output format.
Between columns, the longest character string within a column is separated from the beginning of the next column by two spaces.
The status is displayed with one space at the beginning of the word.
NAME HOST PID STATE PRF_server_name host_name process_ID status
PRF_server_name: Displays the name of the PRF server.
host_name: Displays the name of the host on which the PRF server is created.
process_ID: Displays the process ID of a PRF server that is running. This column displays -- if the PRF server is not running.
status: Displays the status of the PRF server. This column displays the following values:
-
not running (Stopped)
-
running (Running)
Examples
The following example displays the names and statuses of PRF servers:
asadmin list-prfs
Example of output:
PRF1 running PRF2 not running PRF4 running PRF3 not running
The following example displays the complete information about a PRF server:
asadmin list-prfs --long true
Example of output:
NAME HOST PID STATE PRF1 localhost 258 running PRF2 localhost -- not running PRF4 WINHOST1 547 running PRF3 WINHOST1 -- not running
The following example does not display the PRF status:
asadmin list-prfs --nostatus true
Example of output:
PRF1 PRF2 PRF4 PRF3
The following example displays information corresponding to the PRF server PRF1:
asadmin list-prfs PRF1
Example of output:
PRF1 running
The following example displays information about the PRF servers that belong to the node winhost1-domain2 (host WINHOST1):
asadmin list-prfs --long true winhost1-domain2
Example of output:
NAME HOST PID STATE PRF4 WINHOST1 547 running PRF3 WINHOST1 -- not running
Exit Status
|
Exit Status |
Explanation |
|---|---|
|
0 |
Normal termination. |
|
1 |
Abnormal termination. |