Reporting a PL/I Problem

Collecting Basic Information

A set of minimal information is required to report any problem. This provides a base from which to start investigating for a solution.

Micro Focus Support Scan Utility

Micro Focus provides the Support Scan utility to assist you in collecting basic information. This tool produces a log file that you provide to Customer Care. For complete instructions on using this tool, see Micro Focus Support Scan Utility.

Additional items

In addition to the information collected by the Support Scan utility, take note of each of the following that apply:

• Banner info from MFPLX -v
• Name of your enterprise server region
• Enterprise Server product release and build dates
• If using RDBMS software, name of software and version
• If using ODBC driver software, name of software and version
• On Liinux/UNIX, the COBMAINSTACK environment variable setting
• On Linux/UNIX, output from ulimit -a
• Whether or not you are using Fileshare
• If you are using Fileshare, the FS server name

Data Capture Checklist - Pre Failure

Before contacting Customer Care, be sure you have a copy of each of the following pre-failure items to attach to your support case:

• The MSSupportInfo.log file generated by the Micro Focus Support Scan utility
• Your list of notes from the Additional items section above
• Failing JCL files and any PROCs used by the JCL
• SYSIN control cards used by the JCL
• The PL/I source code and include files required to reproduce the problem
• The compiler listings for your PL/I program(s)
• The complier command line used to build your PL/I program(s), including all parameters and values

Before contacting Customer Care, be sure you have a copy of each of the following post-failure items to attach to your support case:

• All of the standard data capture items produced as you worked through step 2 in the Open PL/I Problem Determination topic
• All of the standard data capture items produced as you worked through step 3 in the Open PL/I Problem Determination topic
• The job log for the failing job
• The console.log for the enterprise server region running the failing job
• An export of the enterprise server region
• For jobs executing programs under the control of IKJEFT01, a capture of the SYSTSPRT SYSOUT as well as the the SYSTSIN input if it is not inline in the JCL