Skip to main content

Influencing RESUME Requests - Exit PSNCUX03

A Bravura Security Fabric server can request Mainframe Connector to resume/enable a userid. By default, Mainframe Connector ships installation exit PSNCUX03 that will permit the resume/enable operation to continue as requested.

If this default action is not appropriate, the site can provide a customized PSNCUX03 exit. A return code of 4 from PSNCUX03 indicates that the specified userid should not be resumed/enabled and that its current system access status should remain unchanged.

A sample PSNCUX03 exit is provided in member UX03SAMP of the Mainframe Connector installation library.

Following are the characteristics of the PSNCUX03 user exit:

  • Its name must be PSNCUX03 and it must reside in either the STEPLIB used for the Mainframe Connector started task or the system linklist

  • It should run AMODE(31) RMODE(24)

  • The exit is entered problem state key 8 and should return in this same state otherwise results are unpredictable

  • The exit must be reentrant

  • On entry to the exit, R1 points to the following parameter list:

    UX03UID  DS    CL8       USERID FOR ENABLE/RESUME REQUEST 
UX03MSGB DS    F         ADDRESS OF 128-BYTE RETURN MESSAGE BUFFER THAT 
*                        CAN BE USED TO APPEND TO THE DEFAULT MESSAGE 
*                        THAT IS RETURNED TO THE PWD (OR ID) MANAGER 
*                        SERVER WHEN AN ENABLE/RESUME EVENT IS REJECTED 
*                        BY THE M/F CONNECTOR PSNCUX03 EXIT.  THE 
*                        FORMAT OF THIS MESSAGE AREA IS AS FOLLOWS: 
*                        +0 - TWO BYTE LENGTH OF MESSAGE BEING 
*                             RETURNED (MAX OF 126) 
*                        +2 - 126-BYTE MESSAGE BUFFER

    Member PUX03PRM in the INSTLIB dataset contains the DSECT mapping macro for the above parameter list.

  • on return, R15 should contain one of the following return codes

     R15=0    the specified userid should be resumed/enabled by the 
          Mainframe Connector resume module. 
 R15=4    the system access status for the specified userid 
          should remain unchanged.
In this section: