Displaying RACF sign-on messages

In IMS 15, after APAR PI85328 (PTFs UI57463 and UI57462) is installed, you can configure IMS to pass RACF® sign-on messages to the Greeting Message exit routine (DFSGMSG0) when sign-on is successful. You can code the DFSGMSG0 user exit routine to display or process the RACF messages to improve security and password management.

To configure IMS to pass RACF sign-on messages, such as ICH70001 and ICH70002, to the DFSGMSG0 exit routine when sign-on is successful, specify RACFMSG=Y in the DFSDCxxx PROCLIB member. When a user successfully signs on, IMS passes the storage address of the messages in the parameter list of the exit routine.

The messages are returned by IMS in the WTO format.

For more information about these RACF messages, see z/OS: RACF miscellaneous messages.

Requirements

This support requires the installation of IMS APAR PI85328 (PTFs UI57463 and UI57462).

Changes to installing and defining IMS

During IMS system definition, you can now specify RACFMSG=Y in the DFSDCxxx PROCLIB member to direct IMS to pass the RACF sign-on messages to the DFSGMSG0 user exit routine.

Changes to exit routines

The parameter list for the Greeting Message exit routine (DFSGMSG0) is updated to include the storage address of the RACF sign-on messages, if any. You can then add code to your DFSGMSG0 exit routine to process the messages as appropriate.

The following example code is from the sample DFSGMSG0 user exit routine. The code, which is shipped disabled, checks for RACF messages and sends them to the system console as WTO messages.
CHKTYPE  DS    0H                                             
         J     RACFDONE                                       
         ICM   3,15,GMSGRMSG       IS THERE A RACF MSG        
         BZ    SKIPMSGS            NO, SKIP MESSAGES          
         AHI   3,8                 SKIP LENGTH AND PTR TO NEXT
         WTO   MF=(E,(3))          SEND MSG                   
         J     RACFDONE                                       
SKIPMSGS DS    0H                                             
         WTO   'DFSGMSG0 NO RACF MSGS'                        
RACFDONE DS    0H

Documentation changes

The following table lists the publications that contain new or changed topics for the New function name enhancement. Publications that are not impacted by this enhancement are not included in the table.

Table 1. Links to topics that have new or changed content for this enhancement
Publication Links to topics
Release planning
System definition
System administration
Exit routines