Dealing with messages from DBCTL and CICS

Messages from DBCTL (in the form DFSnnnn) are sent to console(s) as specified in the MCS= parameter of the IMSCTRL macro in the IMS™ generation. These messages include notification of change in status and of abnormal events.

There are many additional messages in the DBCTL environment. You can direct them to the console from which DBCTL commands will be entered. However, if you find that the volume of messages means it is impractical to view them "live" at the console, you may prefer to direct them to the console log and process them with whatever tool your installation uses to review console output.

The DFS554 message is a notification of the abnormal termination of a BMP region or a thread from a CICS® transaction. If it has been caused by an abnormal termination of a thread that originated from CICS, the message text contains the CICS job name or CICS started procedure name. It also contains the abend code in the form SSS, UUU where SSS is a system abend code and UUU is an IMS user abend code. (See Return codes in DBCTL for more information on these codes.) The message may contain the characters "PSB." If it does, the PSB contained in the message has been stopped. All attempts to schedule that PSB will fail until a /START PROGRAM command is issued for that PSB. See the IMS Messages and Codes manual manual for guidance on interpreting DFSnnnn messages.

Messages from CICS that relate to DBCTL begin with DFHDB, and messages that relate to DBCTL in an XRF environment begin with DFHDX.

Messages from CICS that relate to DBCTL (for example, those relating to the CDBC transaction) are sent to the transient data destination CDBC so that they are located in one place. You can reroute these messages from CDBC, as you can with CSMT.

You can suppress or reroute messages sent to transient data queues such as CDBC. You can reroute from CDBC to a list of consoles, from CDBC to a different transient data queue, or reroute console messages from their transient data queues to CDBC. For programming information about coding the CICS-supplied user exit used to re-route messages and on the example user exit provided to help you do so, see CICS Customization Guide.

Messages DFHDB8103 and DFHDB8104 are issued if there is a failure to connect to DBCTL. They contain the DBCTL reason codes for the connection failure.

Message DFHDB8109 is issued when:

Message DFHDB8109 is not issued when an error type status code is returned to the application program.

DFHDB8109 enables you to identify the IMS reason for which this CICS transaction has failed. The IMS Messages and Codes manual manual contains guidance on interpreting the IMS abend and reason codes referred to above. See the CICS Messages and Codes manual for help on interpreting messages beginning with DFH.

Related concepts
Operations with DBCTL
Connecting to DBCTL: overview
Operator communication with DBCTL -- overview
Dealing with messages from DBCTL and CICS
[[ Contents Previous Page | Next Page Index ]]