Troubleshooting
Problem
This document provides information on the steps to ensure a 'clean slate' within the Collection Services environment.
Resolving The Problem
The following steps ensure a 'clean slate' within the Collection Services environment
In some cases, it may not be necessary to perform Steps 3 and 4. These steps are typically required if your system has been recently upgraded and the files contained in the library are back level. If not sure, perform those steps. Pre-existing data will be preserved.
In some cases, it may not be necessary to perform Steps 3 and 4. These steps are typically required if your system has been recently upgraded and the files contained in the library are back level. If not sure, perform those steps. Pre-existing data will be preserved.
| 1. | To end the Management Central TCP server used by Operations Navigator or iSeries Navigator, from the operating system command line, run the following command: ENDTCPSVR SERVER(*MGTC) |
| 2. | To end Collection Services on the IBM System i system, from the operating system command line, run the following command: ENDPFRCOL FRCCOLEND(*YES) |
| 3. |
To rename the library used by Collection Services to store performance data, from the operating system command line, run the following command:
for v6R1M0 and later:
RNMOBJ OBJ(QPFRDATA) OBJTYPE(*LIB) NEWOBJ(QPFRDATAX)
for V5R3M0 and V5R4M0:
RNMOBJ OBJ(QMPGDATA) OBJTYPE(*LIB) NEWOBJ(QMPGDATAX) |
| 4. |
To create a new library to be used by Collection Services, from the operating system command line, run the following command:
for v6R1M0 and later:
CRTLIB LIB(QPFRDATA)
for V5R3M0 and V5R4M0
CRTLIB LIB(QMPGDATA) QMPGDATA is the system's default library for Collection Services for V5R3M0 and V5R4M0, QPFRDATA for V6R1M0 and later. If you are using a different library to store performance data then steps 3 and 4 should reference that library. |
| 5. | To identify the objects used to hold Collection services runtime parameters, from the operating system command line run, the following command: WRKOBJ OBJ(*ALL/QPFRCOL*) OBJTYPE(*ALL) |
| 6. | To rename the user space containing Collection Services runtime parameters, from the operating system command line, run the following command: RNMOBJ OBJ(QUSRSYS/QPFRCOLDTA) OBJTYPE(*USRSPC) NEWOBJ(QPFRCOLDTX) |
| 7. | To rename the user space containing Collection Services runtime parameters, from the operating system command line, run the following command: RNMOBJ OBJ(QUSRSYS/QPFRCOLREG) OBJTYPE(*USRSPC) NEWOBJ(QPFRCOLREX) |
| 8. | This object may or may not exist at this time. This object is created when the QYPSPFRCOL job starts and should not be present after it ends. From the operating system command line, run the following command: RNMOBJ OBJ(QUSRSYS/QPFRCOLDTA) OBJTYPE(*DTAQ) NEWOBJ(QPFRCOLDTX) |
| 9. | From the operating system command line, run the following command: WRKSBSJOB SBS(QSYSWRK) Verify that all CRTPFRDTA jobs and all QYPS* jobs in the QSYSWRK subsystem are no longer active. If they are, end them immediately with the 'Delete spooled files' parameter set to *YES. |
| 10. | To create new user spaces with a set of default runtime parameters, from the operating system command line, run the following command: CALL QYPSCOLDTA |
| 11. | Verify that new QPFRCOLDTA and QPFRCOLREG *USRSPC objects are created. Repeat Step 5. Then, delete the objects that were renamed earlier, QPFRCOLDTX and QPFRCOLREX *USRSPC objects and the QPFRCOLDTX *DTAQ object if it was present. |
| 12. |
To properly set the Collection Services runtime parameters stored in the new QPFRCOLDTA user space, on the operating system command line, run the following:
CFGPFRCOL INTERVAL(15.00) LIB(QPFRDATA) DFTCOLPRF(*STANDARDP) CYCTIME(000000) CYCITV(24) RETPERIOD(00072 *HOURS) CRTDBF(*YES)
|
| 13 |
Check to see if *DG1 licensed program is install on the system.
go licpgm --> take option 10
Example at V7R3:
Display Installed Licensed Programs
Licensed Installed Program Status Description 5770DG1 *COMPATIBLE IBM HTTP Server for i
If *DG1 is installed run the following command:
CALL PGM(QHTTPSVR/QZSRINEX) PARM(X'00000000' X'00000001') |
| 14. | To start Collection Services, on the operating system command line, run the following command: STRPFRCOL COLPRF(*CFG) CYCCOL(*YES) There may be a delay depending on the interval time collected before data will be seen in the new Collection Services collection. |
| 15. | It may be necessary to run the CRTPFRDTA command against the collection that failed. This object will be found in the Collection Services collection library, system default QMPGDATA for V5R3M0 and V5R4M0 or QPFRDATA at V6R1M0 and later, with an object type of *MGTCOL with a creation date of when the failure occurred. |
[{"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":"a8m0z0000000CKnAAM","label":"Performance-\u003ETools"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Historical Number
489669886
Was this topic helpful?
Document Information
Modified date:
10 October 2024
UID
nas8N1013618