Skip to main content

Userid Create Installation Exit - Exit ISNCUX01

An Bravura Identity server can request Mainframe Connector create a new userid. By default, Mainframe Connector ships installation exit ISNCUX01 that performs no additional processing with respect to a userid create operation.

If this default function is insufficient, the site can provide a customized ISNCUX01 exit. This exit can be used to provide any additional operations that a site may require that extend beyond the specific creation of the userid. An example of this might be the creation of a master catalog userid alias.

A sample ISNCUX01 exit is provided in member UX1ISAMP of the Mainframe Connector installation library.

Following are the characteristics of the ISNCUX01 user exit:

  • Its name must be ISNCUX01 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:

     UX1IREQ  DS    CL8       SPECIFIES OPERATION TYPE 'CREATE' 
     UX1IUID  DS    CL8       USERID THAT HAS BEEN CREATED 
     UX1IMDL  DS    CL8       USERID USED AS MODEL USERID 
     UX1IUNM  DS    CL20      USER NAME OF CREATE USERID 
     UX1UAVA  DS    F         ADDRESS OF ATTRIBUTE VECTOR 
     UX1UAVC  DS    F         ADDRESS OF ATTRIBUTE VECTOR COUNT ADDRESS

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

  • A return code value in R15 is not currently examined on return to the userid create module