5.2.1 cprfgetpid

Synopsis

cprfgetpid [-PRFID prf-identifier] [-h]

Storage location

Application Server installation directory/common/PRF/bin/

Function

This command acquires the process ID of the specified PRF daemon. It also displays whether or not the PRF daemon has started.

Execution permission

A user who has the following permission:

• Either the same user for the processes that obtain PRF or the superuser

• In an environment that uses the same PRFSPOOL environment variable, the superuser and other users coexist and the PRF commands cannot be executed. The PRF commands must always be executed by the same user.

PreCondition

• The same PRFSPOOL environment variable as the one assumed by the request destination PRF daemon must be set.

• If the PRF daemon has not been started at all or if this command is executed after the PRF daemon terminated normally, an error results.

Environment variable

• PATH

  Add Application Server installation directory/common/PRF/bin and /bin.

• LD_LIBRARY_PATH(Linux)

  Specify Application Server installation directory/common/PRF/lib.

• PRFSPOOL

  Specifies the execution environment directory of the performance tracer (PRF daemon).

  The PRFSPOOL environment variable is set by the domain administration server when the domain administration server starts a JAVA EE server or a cluster. If a PRF association whose association source is the Java EE server exists, the PRFSPOOL environment variable is set in the following format based on the PRF name of the association destination:

  "Java-EE-Server-log-output-destination-directory-for-the-node-in-which-the-JAVA-EE-server-is-built/nodes/node-name/PRF-name"

• TZ(UNIX)

  Specifies the time zone.

Arguments

-PRFID prf-identifier

For the PRF identifier, specify the PRF server name that is given when the PRF is created by using the create-prf subcommand of asadmin.

Specifies a PRF daemon identifier, as 1 to 31 alphanumeric characters and the underscore (_). Do not specify a character string that begins with TSC or tsc or with CTM or ctm.

Default value: PRF_ID

-h

Displays the command's usage.

Exit Status

Exit Status	Explanation
0	The command terminated normally. Processing might not have started.
1	Processing has not started.
2	The PRFSPOOL environment variable has not been set up.
Other than the above	An error occurred during command processing. Take the corrective action indicated in the output message, and then re-execute the command. The error message is output to the standard error output and a log file.