Troubleshooting
Problem
The GETHTTPINF (Get HTTP Server Info) utility in QMGTOOLS allows the user to display the live thread statistics either with a snapshot or capture for period of time. The tool has the ability to trigger a data collection that includes Job Watcher, TRCCNN, TRCTCPAPP when the active thread percentage is exceeded.
Resolving The Problem
1. If the QMGTOOLS toolkit has not yet been installed, you should refer to the following document for information on how to download and install the QMGTOOLS toolkit on your IBM i server. The following URL contains additional information: http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297
Note: If you just downloaded the tool, this can be ignored. GO QMGTOOLS/MG and take option 12. Please make sure the build date is 05/06/2020 or later. If older than 05/06/2020, download the current version of QMGTOOLS by following the steps in : http://www.ibm.com/support/docview.wss?uid=nas8N1020468
2. The GETHTTPINF command can be found taking the following menu options, or can be prompted with QMGTOOLS/GETHTTPINF.
GO QMGTOOLS/MG
Take option 7 for CTA/EWS (EWS)
Take option 7 for HTTP Menu (HTTPMNU)
Take option 9 for "DISPLAY HTTP THREAD INFO"
| Parameter | Description |
| HTTP Instance Name (HTTP_INST) | The name of the HTTP Server |
| Snapshot? (SNAPSHOT) | Y - Yes N-No If snapshot is selected, it will capture a single point in time for the selected server. |
| Enable Trigger? (TRIG_ON) | If this command is used in a trigger situation. This is used in conjunction with the TRIG_PCT (Active thread percentage) |
| Active Thread Trigger % (TRIG_PCT) | The active thread % threshold. This is the % of total threads that are currently active. Once the TRIG_PCT is hit, it will capture the JW and TRCTCPAPP data as well as call the optional trigger program. |
| Optional Trigger Program (TRIG_PGM) | Optional program to call when trigger value is hit. *NONE is default. The trigger program can be any custom program a user may want to call when the trigger criteria is met. |
| Trigger Program Library (TRIG_LIB) | Library for trigger program. |
| Monitor Duration (NBR_MIN) | Number of minutes to monitor HTTP server for trigger condition. |
| IFS File for Monitor Data (OUT_FILE) | Tee path and text file that shows interval by interval for HTTP server activity. |
| Library for data collection (DATA_LIB) | The library in which Job Watcher data is gathered into when trigger criteria is hit. |
| IFS Directory to store data (IFS_DIR) | The IFS directory to store data (TRCCNN, TRCTCPAPP) output files. |
| TRCTCPAPP, JW Time (NBRSECS) | The number of seconds to collect TRCTCPAPP and Job Watcher data. |
Scenarios:
SNAPSHOT
QMGTOOLS/GETHTTPINF HTTP_INST(ADMIN) SNAPSHOT(Y)
Basic Data Collection
QMGTOOLS/GETHTTPINF HTTP_INST(ADMIN) SNAPSHOT(N) NBR_MIN(1)
This produces output (default) in /tmp/QMG_HTTP/HTTP_Info.txt. This screenshot shows the idle, active and active thread% for each 10 second interval.
Data collection with Trigger
QMGTOOLS/GETHTTPINF HTTP_INST(ADMIN) SNAPSHOT(N) TRIG_ON(Y) TRIG_PCT(50) TRIG_PGM(MYCOLPGM) +
TRIG_LIB(MYLIB) NBR_MIN(60) OUT_FILE('/tmp/QMG_HTTP/ADMIN_HTTP_Info.txt') DATA_LIB(MYDATALIB) +
IFS_DIR('/tmp/QMG_HTTP/ADMIN_HTTP') NBRSECS(180)
The above command will monitor HTTP server "ADMIN" for 60 minutes. If within that 60 minutes, the ACTIVE thread % of the total threads meets or exceeds 50%, it will call an optional trigger program (user created) MYLIB/MYCOLPGM along with capturing
TRCTCPAPP and JW collection for 180 seconds. The data will be in library MYDATALIB along with directory /tmp/QMG_HTTP/ADMIN_HTTP.
Document Location
Worldwide
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CGqAAM","label":"IBM i HTTP Server"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2;7.3;7.4","Line of Business":{"code":"LOB57","label":"Power"}}]
Was this topic helpful?
Document Information
Modified date:
10 June 2020
UID
ibm16206619