IBM Support

MustGather: Collection Services Collector Trace Instructions

Troubleshooting


Problem

This document includes information on how to gather a Collection Services Collector trace.

Resolving The Problem

Step 1: Start a Collection Services Collector trace.


1. On the operating system command line, type the following:
ENDPFRCOL FRCCOLEND(*YES)

Press the Enter key.

2. Rename the trace file if it exists: QUSRSYS/QPFRCOLTRC. This will clean up any previously collected trace data
and reduce the size of the new trace sent in. Let the service rep know whether the trace file already exists.
RNMOBJ OBJ(QUSRSYS/QPFRCOLTRC) OBJTYPE(*FILE) NEWOBJ(QPFRCOLTRX)

Press the Enter key.

3. Turn the trace on by issuing the following command:
CALL QSYS/QYPSCONFIG PARM('QYPS_TRACE' '1')

Press the Enter key.

4. Restart the collector job, QYPSPFRCOL. This will generate a new member in the file QPFRCOLTRC in QUSRSYS. The
trace can be allowed to run indefinitely until the problem occurs.
STRPFRCOL CYCCOL(*YES)

Press the Enter key.
 

Step 2: Ending and saving the Collector trace once the problem has been re-created.


1. On the operating system command line, type the following:
CALL QSYS/QYPSCONFIG PARM('QYPS_TRACE' '-1')

Press the Enter key.

2. End and restart the collector job, QYPSPFRCOL.
ENDPFRCOL FRCCOLEND(*YES)

Press the Enter key.
STRPFRCOL CYCCOL(*YES)

Press the Enter key.

3. Save the file QPFRCOLTRC in QUSRSYS to a save file. The save file should be small enough to send back in an e-mail.
CRTLIB LIB(TSXXXXXXX)
where XXXXXXX = Case number.

Press the Enter key.
CRTSAVF FILE(TSXXXXXXX/TSXXXXXXX)

Press the Enter key.
SAVOBJ OBJ(QPFRCOLTRC) LIB(QUSRSYS) DEV(*SAVF)SAVF(TSXXXXXXX/TSXXXXXXX) TGTRLS(*CURRENT) DTACPR(*YES)

Press the Enter key.

4. Also, send the QYPSPFRCOL job log that was running during the trace and the corresponding CRTPFRDTA job log.

Step 3:  Instructions for Sending Data to IBM i Support
http://www-01.ibm.com/support/docview.wss?uid=nas8N1019224

The preferred data upload method is QMGTOOLS: FTP Data to IBM
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010370

Step 4: Send in a system snapshot by using QMGTOOLS
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010353

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Historical Number

592151522

Document Information

Modified date:
27 April 2021

UID

nas8N1011669