End Performance Collection (ENDPFRCOL)

The End Performance Collection (ENDPFRCOL) command stops the system-level collection. If there are no other client applications using Collection Services, the Collection Services server job (QYPSPFRCOL) will also end.

If client applications are using Collection Services, the server job will continue to run unless you also specify the Force end parameter. Forcing the server job to end when it is being used by client applications (for example, IBM System i Navigator monitors or Performance Collector APIs) will cause those clients to experience data collection failure.

Other system functions are capable of starting Collection Services. Even though this command ends the current instance of the server job, it does not prevent the server job from being restarted. Functions which can start the server job include PM Agent, the Management Central server, and the Performance Collector APIs.

Parameters

Force end (FRCCOLEND)

Determines whether the Collection Services server job (QYPSPFRCOL) should be forced to end.

*NO

The QYPSPFRCOL job will be ended only if it is not being used by a client application.

*YES

The QYPSPFRCOL job will be forced to end immediately.

Examples

Example 1: Ending the Performance Collection

ENDPFRCOL

This command will end the system-level collection of performance data. If no client applications are using Collection Services, this command will also end the Collection Services server job (QYPSPFRCOL). If client applications are using Collection Services, the QYPSPFRCOL job will continue to run.

Example 2: Forcing the Performance Collection to End

ENDPFRCOL FRCCOLEND(*YES)

This command will force the Collection Services server job (QYPSPFRCOL) to end, even if it is being used by client applications.

Error messages

*ESCAPE Messages

CPF3CF2

Error(s) occurred during running of &1 API.

CPFB94A

Collector communications error. Reason code &1.