5.2.3 cprfstop

Synopsis

cprfstop [-PRFID PRF-identifier] [-Force] [-h]

Storage location

Application Server installation directory\common\PRF\bin\

Function

This command stops the PRF daemon (cprfd). You should stop the PRF daemon only after all other processes have been stopped.

Execution permission

• Either a user that belongs to the Administrator group or the local system account

• You need administrator privileges to execute the command.

• A user who executes the cprfstart command must execute the commands used with the performance analysis trace.

Precondition

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.

• 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"

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

-Force

Forcibly stops the PRF daemon.

-h

Displays the command's usage.

Exit Status

Exit Status	Explanation
0	The PRF daemon stopped 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.
3	A timeout occurred.
Other than the above	An error occurred during command processing. Take the corrective actions 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.

Notes

• If the command times out and the PRF daemon does not terminate normally, specify the -Force option to force the PRF daemon to stop.

• If a big value is specified in -PrfTraceCount or -PrfTraceFileSize of the cprfstart command, the normal termination of PRF daemon might take time.