DFSMSdfp: Obtain descriptive text in messages for Open/Close/End of Volume ABENDs

Description

z/OS V1R13 DFSMSdfp introduced a new function that displays descriptive text for certain IECxxxx messages for OPEN, CLOSE, and end of volume determinant ABENDs. You can enable this function by specifying it in the MPFLSTxx PARMLIB member: .MSGOPTION VERBOSE(x), where x is either Y or N, with N as the default. If you were using OCE_ABEND_DESCRIP in DEVSUPxx to obtain this descriptive text before OA37505 was installed, you need to convert to using MPFLSTxx after OA37505 is installed.

Note: Beginning in z/OS V2R1, or after applying the PTF for APAR OA37505 in z/OS V1R13, the VERBOSE message is displayed only in the JOBLOG.

In addition, all OPEN, CLOSE and end-of-volume ABEND messages are issued using a Message Buffer Manager service, whether or not the new VERBOSE message function is enabled. One change this introduces is that the IECxxxx portion of the message always appears as a multi-line WTO message. Automated operation services that parse these messages may be affected.

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature:	DFSMSdfp
When change was introduced:	z/OS V2R1. z/OS V1R13 with PTF for APAR OA37505 applied.
Applies to migration from:	z/OS V1R13 without PTF for APAR OA37505 applied.
Timing:	Before installing z/OS V2R2.
Is the migration action required?	Yes, if any of these conditions are true: You have z/OS V1R13 without APAR OA37505 installed, and are using the OCE_ABEND_DESCRIP function in DEVSUPxx for verbose messages. If you have automation or programs that depend upon the type (single-line WTO as opposed to multi-line WTO) of the IECxxxx message for OPEN, CLOSE, end-of-Volume determinant ABENDs.
Target system hardware requirements:	None.
Target system software requirements:	None.
Other system (coexistence or fallback) requirements:	None.
Restrictions:	None.
System impacts:	Remove OCE_ABEND_DESCRIP from DEVSUPxx parmlib member; otherwise you receive the following informational message at IPL time: `IEA253I DEVSUP OCE_ABEND_DESCRIP NO LONGER HAS AFFECT. USE MPFLSTXX MEMBER`
Related IBM Health Checker for z/OS check:	None.

Steps to take

If you were using DEVSUPxx to obtain the ABEND descriptive text before OA37505 was installed, then you need to convert to using MPFLSTxx to obtain this information after OA37505 is installed. In the MPFLSTxx PARMLIB member, specify .MSGOPTION VERBOSE(Y) to enable display of the descriptive text.

Because OPEN, CLOSE and end-of-volume ABEND messages now include the IECxxxx portion of the message as a multi-line WTO message, any automated operation services that parse these messages might need to be adjusted. Examine such automated operation services and adjust them to handle the new format as needed.

Here is an example of the output message you receive after you install APAR OA37505:

JOB00608 00000090 IEC141I 013-18,IGG0191B,IBMUSER9,S01,SYSUT1,5901,ZR1DT1, 651
651      00000090 SYS1.SAMPLIB(ZZZZZZZZ)

Reference information

For more information about using the VERBOSE option in MPFLSTxx, see z/OS MVS Initialization and Tuning Reference.