Troubleshooting
Problem
This document includes CL programs to automate the performance data collection of JobWatcher and Collection Services while performing a save in restricted state.
Resolving The Problem
|
Caution: This tool is provided on an as is basis and is not supported by IBM. |
Collecting JobWatcher (JW) and Collection Service (CS) data is not possible while the system is in restricted state. The following CL programs can be used to start minimal services to allow the collections to run while leaving the system in a semi-restricted condition.
Important note: Verify the required Job Watcher PTFs are applied: http://public.dhe.ibm.com/services/us/igsc/idoctor/html/ptfs.html
Below lists the CL programs provided with descriptions of each:
STRJWCSEXT - Starts JW and CS collection in restricted state
STRJWCSEXT - Starts JW and CS collection in restricted state
This program sequentially performs the following:
| 1. | Creates JW collection library called JWxxxxxx where xxxxxx is the unique job number associated with the save job. |
| 2. | Starts QSYSWRK which is required for CS data and also utilized in this program to collect JW data. |
| 3. | Ends other unnecessary services which get auto started with QSYSWRK: o BRMS subsystem (if applicable) o TCP/IP |
| 4. | Creates JW definition named DFNxxxxxx with a collection interval of 5 seconds. |
| 5. | Submits job named JOBWATCHER to QSYS/QSYSNOMAX which starts a JW collection called IBMCOLLECT Note: JW collection is hardcoded to run a maximum of 2 hours or use 10GB DASD; whichever condition is met first. |
| 6. | Starts CS collection and specifies the collection be cycled (starts new collection object). |
ENDJWCSEXT - Ends JW and CS collection in restricted state
ENDJWCSEXT - Ends JW and CS collection in restricted state
This program sequentially performs the following:
| 1. | If JW collection IBMCOLLECT is still active, it is ended. |
| 2. | Creates CS collection library called CSxxxxxx where xxxxxx is the unique job number associated with the save job. |
| 3. | Identifies currently active CS collection and moves collection from default Collection library, seen from CFGPFRCOL, to CSxxxxxx. |
| 4. | If no active CS collection was found, library CSxxxxxx is deleted and program ends here. |
| 5. | Forces CS collection to be ended immediately. |
Instructions on how to restore IBM provided CL programs to system-requiring performance collection
Instructions on how to restore IBM provided CL programs to system-requiring performance collection
1. CRTSAVF FILE(QGPL/JWCSEXTPGM)
2. FTP the attached save file in binary mode to your system
jwcsextpgm3. RSTOBJ OBJ(*ALL) SAVLIB(QGPL) DEV(*SAVF) SAVF(JWCSEXTPGM)
Example: CL implementation seen from the Backup Control Group Entries screen in BRMS:
Backup
Seq Items Exit command
10 *SAVSYS
20 *EXIT CALL QGPL/STRJWCSEXT
30 *LINK
40 *EXIT CALL QGPL/ENDJWCSEXT
50 *EXIT Note: If saving *ALLUSR libraries (or any set of libraries that may include libraries JW* and/or QPFRDATA) libraries JW* and/or QPFRDATA (or whatever library is used for collection services) should be omitted from the backup to prevent object lock contention.
Instructions on how to prepare performance data output and send to IBM for review
Instructions on how to prepare performance data output and send to IBM for review
1. Create two save files
2. SAVLIB LIB(CS* JW*) DEV(*SAVF) SAVF(SAVF_Library/SAVF) <== Two separate commands. Only one library can be saved into a SAVF.
3. Available options to upload data to IBM described in MustGather: Instructions for Sending Data to IBM i Support
Note: You should provide the save joblog along with above performance data.
[{"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":"a8m0z0000000CNIAA2","label":"Backup Recovery Install Migration-\u003EPerformance"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Historical Number
613147639
Was this topic helpful?
Document Information
Modified date:
26 June 2025
UID
nas8N1011319