IBM Support

MustGather: (Collecting/Sending in) Collection Services Performance Data for General System Performance Issues from an active collection

Troubleshooting


Problem

This document covers starting, configuring, and sending Collection Services performance data to the IBM i Global Support Center for general system performance issues with the IBM i. These steps are for sending in data for the current days collection.

Resolving The Problem

System Performance Issues: Gathering Collection Services performance data.
Step 1: Checking, Configuring, and Starting Collection Services

1. Issue command CHKPFRCOL to obtain the status of Collection Services. One of the following two messages will be posted when this command is run:

o Message CPI0A16 - Collection Services active will be displayed at the bottom of the screen and in the job log.
o Message CPI0AA5 - Collection Services not active will be displayed at the bottom of the screen and in the job log.
2. If Collection Services is active, skip to Step 2: Saving Collection Services Data to a Save File.

If Collection Services is not active, the configuration can be reviewed and the collector job started.

Issue command CFGPFRCOL and press F4. The suggested settings are as follows:

Default interval . . . . . . . . > 5.00      
Collection library . . . . . . .   QPFRDATA   
Default collection profile . . .   *STANDARDP
Cycle time . . . . . . . . . . .   000000    
Cycle interval . . . . . . . . .   24        
Collection retention period:                  
    Number of units  . . . . . . .  00048      
    Unit of time . . . . . . . . .  *HOURS    
Create database files  . . . . .   *YES      
Change PM iSeries library  . . .   *NO
3. Issue command STRPFRCOL CYCCOL(*YES). This will start the QYPSPFRCOL collector job in QSYSWRK and will use the configuration from the CFGPFRCOL command.


Step 2: Saving Collection Services Data to a Save File

  • Follow these steps to save the performance data:
    1. Issue command CRTLIB LIB(TSXXXXXXX)

    where TSXXXXXXX = Last 6 digits of Case number.
    2. Issue command CRTSAVF FILE(TSXXXXXXX/TSXXXXXXX)
    3. Issue command CHKPFRCOL again and document the collection object and library in the message CPI0A16. When the message Collection Services active is at the bottom of the screen, you should place the cursor on the message text and press F1. Note the library and collection object in the Cause description.

    Issue command CHKPFRCOL and press Enter.

    Message . . . . : Collection Services active.                              
    Cause . . . . . : The current collection object is QPFRDATA/Q167003003. The current collection profile is *STANDARDP.
    4. Use the CRTPFRDTA command to create data in the newly created library.

    Issue command CRTPFRDTA and press F4. Replace the 'From collection', 'Library', and 'To library' fields.

    From collection  . . . . . . . .   Q167003003 
      Library  . . . . . . . . . . .   QPFRDATA
    To member  . . . . . . . . . . .   *FROMMGTCOL
    To library . . . . . . . . . . .   TSXXXXXXX
    Text 'description' . . . . . . .   *SAME      
                                               
    Categories to process  . . . . .   *FROMMGTCOL
       + for more values            
    Time interval (in minutes) . . .   *FROMMGTCOL
    Starting date and time:                      
    Starting date  . . . . . . . . *FROMMGTCOL
    Starting time  . . . . . . . .              
    Ending date and time:                        
    Ending date  . . . . . . . . . *FROMMGTCOL
    Ending time  . . . . . . . . .            
    5. Use the SAVLIB command to save the newly created library to the newly created save file.

    Issue command     SAVLIB LIB(TSXXXXXXX) DEV(*SAVF) SAVF(TSXXXXXXX/TSXXXXXXX) TGTRLS(*CURRENT) DTACPR(*MEDIUM)
    This command saves the newly created library to the newly created save file with data compression.

The preferred data upload method is QMGTOOLS: FTP Data to IBM
 
Step 4: Send in a system snapshot by using QMGTOOLS
 

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CI9AAM","label":"Performance-\u003EMustGather"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0;and future releases"}]

Historical Number

564092798

Document Information

Modified date:
24 October 2024

UID

nas8N1012204

Page Feedback