Skip to main content

Userid Delete Installation Exit - Exit ISNCUX02

An Bravura Identity server can request Mainframe Connector delete an existing userid. By default, Mainframe Connector ships installation exit ISNCUX02 that performs no additional processing with respect to a userid delete operation.

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

Specific to sites using Mainframe Connector in a RACF environment, an option to automatically execute suggested cleanup commands such as PERMIT, DELETE, RALTER, and RDELETE upon return from ISNCUX02 is provided. The suggested commands are passed in buffers which may be examined, and for which automatic command execution may be requested via return codes and bit flag settings. This has no impact or effect on Mainframe Connector operation in ACF2 or TopSecret environments.

A sample ISNCUX02 exit is provided in member UX2ISAMP of the Mainframe Connector installation library.

Following are the characteristics of the ISNCUX02 user exit:

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

     UX2IREQ  DS    CL8   SPECIFIES OPERATION TYPE 'DELETE' 
 UX2IUID  DS    CL8   USERID THAT HAS BEEN DELETED 
 UX2IFCBA DS    A     FIRST CMD BUFF ADDR OR 0 IF NO CMD BUFFS PRESENT

    Member PUX2IPRM in the INSTLIB dataset contains the DSECT mapping macro for the above parameter list. Member PUX2ICMB in the INSTLIB dataset contains the DSECT mapping macro for the command buffer contents.

  • the following R15 return codes have the associated meaning upon exit from ISNCUX02

    • 0: Do not automatically execute any commands.

    • 4: Automatically execute only those commands for which the UX2ICA bit flag has been set in the command buffer.

    • 8: Automatically execute all commands. All UX2ICA bit flags are ignored and need not be set.

In this section: