5.3.2 cprfflush

Synopsis

cprfflush [-PRFID prf-identifier] [-h]

Storage location

Application Server installation directory/common/PRF/bin/

Function

This command requests the PRF daemon to output the trace information stored in the buffer.

The output range begins with the trace following the last trace that was output during the previous file output operation to the most recently collected trace.

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 cprfflush command cannot be executed while another instance of the cprfflush command is executing.

• The same PRFSPOOL environment variable as the one assumed by the request destination PRF daemon must be set. Otherwise, the command returns an error.

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.
1	The PRF daemon is not active. Either the PRFSPOOL environment variable is different from the one assumed for the PRF daemon or the value of -PRFID is invalid.
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.