Collect troubleshooting data in WebSphere Process Server for z/OS
You are having a problem in WebSphere Process Server for z/OS. You would like to know what documentation you must collect (MustGather) so that the WebSphere Process Server for z/OS Support team can diagnose your problem. If you gather this documentation before contacting support, it will expedite the troubleshooting process, and save you time.
Diagnosing the problem
Gather the following information and files:
General Diagnostic Info
- Problem description
- Environment description
- All files from profile_root/profile_name/logs/server_name
- All files from profile_root/profile_name/ffdc
- Project Interchange(PI) or EAR file from the involved applications
z/OS Specific Info
- Install and Update logs
- ABEND / crash, send first MVS SVC Dump
- Versions list from SMP/e
The versionInfo.sh script is helpful, but it reports only basic information. Print the ++APAR list from the TSO panels SMP/e or run an edited versionJCL. Include any manual interim fixes that are not listed and have been applied with Java™ archive (JAR) files. The ++APAR list is required for building new fixes and problem determination.
Print the ++APAR list from the TSO panels SMP/e or run an edited WPSzVersion JCL.
- Output from /D OMVS,L and /D OMVS,O
Instructions for collecting the diagnostic information
To collect the general diagnostic information, see the "Manually collect troubleshooting information" section in Collect troubleshooting data for WebSphere Process Server document.
For issues dealing with any of the following install or update commands, gather the corresponding log files.
Run the following command from an OMVS shell.
Run the commands
jar -cf /tmp/pmrno.jar `find . -name '*.xm*' -o -name '*.props' -o -name '*.txt' -o -name '*.log`
All xml, props, logs and .txt files
The pmrno.jar file can be large but terse is not needed since this is a compressed file, send as a binary file.
- Collect the job log files for each of the WebSphere Application Server regions. These files can be shown with the Display Active (DA) command from the Time Sharing Option (TSO) in the System Display and Search Facility (SDSF).
To find the job name, check the administrative console under: Application servers > server_name.
The job name is in the 'Short Name' field.
When the administrative console is not available, you can find the JOBNAME using UNIX System Services (USS). For example:
# cd $WAS_HOME/profiles/default/config/cells/G02CellBase/nodes/Node1MVSP1/servers/server1
# iconv -f ISO8859-1 -t IBM-1047 server.xml |grep JOBNAME <startCommandArgs>JOBNAME=WZG02Z1,ENV=G02CELL.NODE1.WZG02Z1,REUSASID=YES</startCommandArgs>
- Enter the job name prefix at the COMMAND INPUT ===> prompt. Example: W%G02Z1* :
If jobs are not listed, check the filters. If a job is not running, enter h at the COMMAND INPUT ===> prompt to display the "held" jobs.
- For each job, save the log files. In the NP column, enter XDC: (X - output, D - dataset, C - close).
- Enter a data set name to save the log.
Log files might also be redirected to HFS files. Inspect the job logs for log file redirection. See the "Directing SYSPRINT Output to an HFS File in WebSphere for z/OS" document for more details.
An alternate method may be to copy a joblog into a dataset with the commands
TSO OUTPUT jobname(jobnumber) PRINT(TEST.DATASET) KEEP
What to do next
- Review the logs and traces at the time of the problem to try to determine the source of the problem.
- Use IBM Support Assistant to search for known problems in the information center, forums, and technotes.
If you cannot find related problems or cannot solve the problem, send the information that you have collected to IBM by following the instructions in Exchanging Information with IBM Technical Support.
For a listing of all technotes, downloads, and educational materials specific to WebSphere Process Server , search the WebSphere Process Server support page.
MustGather: Read first for WebSphere Application Server
Exchanging diagnostic information
Java 5 Diagnostics
Browse Component: WebSphere Application Server for z/OS
WebSphere Process Server Must Gather
Troubleshooting Guide for WebSphere Process Server
MustGather: Administrative console problems
WebSphere Application Server for z/OS
WebSphere Process Server detailed system requirements
Log files in action: Convert z/OS logs in a snap
MustGather: Read first for - Runtimes for Java Technolo
Troubleshooting and support
Service Aids For System z
Directing SYSPRINT Output to an HFS File in WebSphere f
z/OS problem determination
Managing operator message routing
IBM Problem Determination Tools for z/OS
ISA on z/OS techdoc
MVS SVC Dump
Software Support Handbook
DB2 PD Upload Utility
Batch upload files to support
APAR and PTF Tables WPS
Diagnostic tools and framework for Java dumps