Handling CA Dataquery Messages and Codes

Handling CA Dataquery Messages and Codes

Responding to error messages and return codes

Error messages and return codes are generated by CA products to help you identify problems and determine the actions required to rectify them. When you encounter a problem associated with an error message or return code, use the following guidelines to solve it.

1. Record the following for later reference:
   • Message ID and message text or return code
   • Where the message was produced (for example, on a console, on a terminal, in a dump, in a report)
2. If practical, repeat the activity which preceded the generation of the message. If the message does not recur, it was probably due to a simple, inadvertent mistake in usage. If the message recurs, continue with the next step.
3. Determine whether the message or return code was produced by CA Dataquery., another CA product, or a non-CA product as follows:
   • Some unnumbered messages are issued by batch CA Dataquery. or CA Dataquery utilities. They are documented in Batch Unnumbered Messages in this manual.
   • All numbered CA Dataquery messages are preceded by a six-character message ID beginning with DQ.
   • Most other CA Datacom messages are preceded by a message ID beginning with the following product codes:

     DB CA Datacom/DB

     DC CA Datacom CICS Services

     DD Datadictionary

     DR CA Datacom/DB Reporting Facility

     DV CA Datacom VSAM Transparency

   • For unnumbered messages or messages prefixed in other ways, determine the source by examining Messages and Codes manuals for the products you have installed, including CA CA IPC.
4. All CA Dataquery. messages are listed in message number sequence with the following information:

   Product Code

   DQ

   Message Number

   Three digits identify the message.

   Message Type Code

   Indicates the type of message:

   E Indicates that this message was caused by an error condition.

   I Indicates that this message is informative.

   Explanation

   Lists the reason and explanation for the displayed message.

   User Response

   Lists the recommended action, or actions, for you to follow in response to the message.

5. Message numbers DQ990-DQ999 are reserved for site-defined error messages used by site-written exit routines and are not documented in this manual. See your CA Dataquery Administrator for more information about these particular messages.
6. For messages and codes generated by another CA product, see the Messages and Codes manual for that product.
7. For messages and codes for a non-CA product, handle according to site procedures.
8. Look up the documentation for the error message or return code in the appropriate manual. Numbered messages are documented in ascending order by message ID; return codes are documented in ascending order; unnumbered messages are listed alphabetically by message text.
9. The messages and codes issued by CA Datacom products are documented with the reason the product generated the message or code and the action CA recommends you take in response to the message, if any.
   • Examine the Reason section to identify the cause of the problem. Sometimes a number of possibilities are suggested.
   • Examine the Action section to determine the course of action recommended for solving the problem or correcting the error and follow the recommended procedure.
10. Recreate the situation in which the problem initially occurred to determine whether the solution you applied solved the problem or corrected the error. If the same error message or return code is produced, ask your CA Dataquery Administrator to proceed with the steps suggested in the Problem Resolution section of the Troubleshooting chapter.