Troubleshooting checklist

The following checklist can help you to identify the source of the problem that is occurring in the runtime environment.

1. Do you have the latest APARs applied?
   IBM® might have already published a fix for your problem. See About fixes and updates for details on how to check for the latest available fixes.
2. Does the problem occur when you are applying an APAR?
   1. Ensure that you are following the correct process to apply the APAR.
      This is described in Applying APARs.
   2. If you are following the correct process and still have difficulties, contact IBM Software Support.
3. Are you having problems when running the postinstallation jobs?
   For example, you receive a return code other than 0 when a job completes.
   For information on diagnosing errors with the post-installation jobs, read Troubleshooting postinstallation errors.
4. Does the problem occur when you are deploying a service flow?
   For example, the service flow installs in an unusable state.
   1. Check that the PROCESSTYPE resource for the service flow is installed in the CICS region.
      The name of the resource is the same as the request name of the service flow.
   2. If the PROCESSTYPE resource has been discarded, reinstall it.
   3. Try to install the service flow again using the CMAN transaction.
5. Does the problem occur when a service requester invokes a deployed service flow?
   When a problem occurs in the runtime environment, errors are written to the CMAC transient data queue. The message contains the details of the error.
   1. Analyze the message to determine if a server adapter is causing the problem.
      The Error field contains the message ID. Read the Messages and codes to find the type of error that has occurred. Also take note of the Program field, because it indicates the program in which the error occurred which might be the name of a server adapter.
   2. If you receive a DFHMA06021E message, check the request name to ensure that it is the name of deployed service flow.
      Also check that the service flow properties file for the service flow is in the deployment directory.
   • Is the problem related to a Link3270 adapter? See Troubleshooting Link3270 server adapters.
   • Is the problem related to the Web services server adapter? See Troubleshooting the web service server adapter.
   • Is the problem related to a FEPI server adapter? See Troubleshooting FEPI server adapters.
6. Optional: Dump and analyze the CICS® BTS audit trail if you have configured it for use.
   See Using a BTS audit trail for problem determination for more information.
7. Debug your applications.
   See Debugging your application for more information.
8. Dump and analyze any CICS trace and dump information available.
   See Using CICS trace for problem determination and CICS dump and traces for more information.
9. Use additional CICS-supplied transactions.
   See Using CBAM for problem determination for more information.