The console message handling facility is an optional feature of the CICS® subsystem that can affect the appearance of CICS messages displayed on an MVS™ console. It is effective when you specify FORMATMSG=YES as an initialization parameter for the CICS subsystem. The subsystem reformatting is enabled when at least one of the following is executing in the MVS image where the subsystem is defined:
When this facility is used, it affects the messages that are displayed on MVS system consoles in the following ways:
+DFHnnnn APPLID MESSAGE-TEXT
In
this message:
You can specify message-formatting initialization parameters for the CICS subsystem in a member DFHSSIyy of the SYS1.PARMLIB library, where yy is the suffix that identifies the SYS1.PARMLIB member used to define the CICS subsystem. These parameters, described in this section, are FORMATMSG, HIDEPASSWORD, and ROUTECODES. Code the parameters in columns 1 through 71 of the DFHSSIyy member, for example:
FORMATMSG=YES,HIDEPASSWORD=YES,ROUTECODES=(1,2)
or
FORMATMSG=YES
HIDEPASSWORD=YES
ROUTECODES=(1,2,
3,4,
5,6)
For more information about these routing codes, see the z/OS MVS Initialization and Tuning Reference manual for your version of MVS.
You can define message-formatting initialization parameters for the CICS subsystem in a member DFHSSIyy of the SYS1.PARMLIB library.
To use parameters defined in a DFHSSIyy member other than the DFHSSI00 member, you must specify DFHSSIyy on the IEFSSNaa member in the SYS1.PARMLIB library used to define CICS as an MVS subsystem. If you do not specify DFHSSIyy, the DFHSSIN routine tries to use the parameters that are defined in the DFHSSI00 member. If the DFHSSI00 member does not exist, it uses the default parameters that are defined in the DFHSSIN routine.
If you specify DFHSSIyy but it does not exist, the DFHSSIN routine uses the default message-formatting initialization parameters that are defined in the DFHSSIN routine
The default message-formatting initialization parameters defined in the DFHSSIN routine are:
FORMATMSG=YES,HIDEPASSWORD=YES
(generic routecodes are not added to messages)
The default facilities:
If the original message is a long one, inserting the CICS applid might cause the message to exceed the maximum length for an MVS console message. In this case, the original message is suppressed (that is, does not appear on the console), and the reformatted message is issued using the MVS multiple-line console message service to split the message text over several lines. Both the original message and perhaps several instances of the reformatted multiple-line message appear in the job log, but only one copy of the reformatted message is displayed on the console.
If you do not specify DFHSSIN in the IEFSSNaa entry that defines CICS, the message handling facilities are not enabled. Also, if you run CICS as a started task, you cannot use the name "CICS" for the procedure name.
After you have defined CICS as an MVS subsystem with support for the console message-handling facility (and have specified the message-formatting parameters in the DFHSSIyy member of the SYS1.PARMLIB library), the message-handling facility is activated by the next MVS subsystem to invoke the subsystem console message broadcasting service of MVS console support. This occurs when you start up a supported CICS region (see The console message-handling facility for a list) or if an automated-operation program, such as NetView, is active in the MVS image.
A newly-started CICS region determines its own applid during initialization. Until the applid is known, the message-formatting facility cannot operate. Therefore, messages issued very early in CICS initialization are not formatted.
To use the console message-handling facilities that are provided by the MVS subsystem functions of CICS, the following CICS modules must be available at MVS IPL time:
These modules must reside in the LPA or in an APF-authorized library in the MVS linklist, as follows:
The current versions of these modules are compatible with earlier CICS releases that support console message handling.
For information about adding modules that are installed in the hlq.SDFHLINK library to the MVS linklist, see Installing CICS-required modules in the MVS linklist.
For information about adding modules installed in the hlq.SDFHLPA library to the LPA, see Installing CICS modules in the MVS link pack area.
To use the message-handling facilities for CICS, you should note the following coexistence considerations:
If your automation system needs to see the console messages before they are reformatted by CICS, its subsystem definition should be placed in IEFSSNXX before the definition for CICS. But if your automation system needs to see the reformatted messages, its definition must come after that of CICS. Consult the documentation of your automation package to determine which applies to you.
If the message-handling facility has been defined to MVS (by the CICS entry in the IEFSSNaa member of the SYS1.PARMLIB library), CICS regions running earlier releases of CICS in the same MVS image have the full benefit of the message handling that has been defined if either of the following is true: