User exit

From HandWiki
Short description: Software extension that executes after a predefined event

A user exit is a subroutine invoked by a software package for a predefined event in the execution of the package. In some cases the exit is specified by the installation when configuring the package while in other cases the users of the package can substitute their own subroutines in place of the default ones provided by the package vendor to provide customized functionality. In some cases security controls restrict exits to authorized users, e.g., EXCP appendages in MVS.

The earliest use of this term involved operating systems to let customized code temporarily take control when a pre-designated event occurred.[1][2]

A more typical use is replacing the user exits provided by a sort/merge package,[3][4][5] whereby the user program provides its own subroutines for comparing records. The procedures provided by the user take the place of the default routines (usually stubs that do nothing but return to their caller) provided by the package vendor.

Procedures provided as user exits are typically compiled into a static library and linked directly with the package to produce an executable program. Another approach employs dynamic libraries to accomplish the same thing. Finally, user exits may be external programs executed at specific points in the execution of a host package.[6]

History

Historically, this term is commonly used in IBM mainframe vernacular.[1][2]

  • Title: z/OS V1R10 DFSMS Installation Exits Document Number: SC26-7396-11
  • Title: z/OS V1R10.0 JES2 Installation Exits Document Number: SA22-7534-10
  • Title: z/OS V1R10.0 MVS Installation Exits Document Number: SA22-7593-14

Restrictions

If the user site specific code is substituted for the software vendor provided default exit it must interface to the software package using the defined parameters as documented for the default exit. User exits are important because while they enable site specific customization they isolate such installation specific customization to defined and supported points enabling the site to upgrade to follow-on releases of the software package without adverse impact to preexisting customized functionality. Some references to IBM user exit manuals are given below. Other vendors such as SAP, Oracle, IFS, HP, Macro4, Compuware, CA all employ user exits in some of their software products.

Example

In SAP, A 'COMMIT WORK' must never be used inside a User Exit, as it may affect the program processing. Furthermore, error messages may not be issued from inside an exit, as they halt the processing of the code that follows the message.

Enforcing standards

If files containing user-created content are meant to follow a standard, the (file) Open command of a word-processing document can invoke a user exit that does validation and, if necessary, returns an error code.[7]

Applications

Some applications that provide user exits:

  • Apache Subversion allows "hooks", which are "scripts that run when an action is performed"
  • IBM CICS
  • IBM CMVC user exits in the form of Kornshell scripts
  • IBM JES 2 and 3
  • IBM MVS, SMS, z/OS and dozens of sub-components such as RACF, SMF, etc.
  • IBM sort/merge package
  • Oracle CC&B
  • SAP R3

See also

References

  1. 1.0 1.1 IBM term: OS/MFT, MVT "OS User Exits". Computerworld: 25. April 11, 1977. https://books.google.com/books?id=ql57Hehq6q0C. "... so that execution ... under OS/MFT or MVT. ... ease of use for applications with ... user exits". 
  2. 2.0 2.1 "Platform Server for z/OS Installation and Operations Guide". https://docs.tibco.com/pub/managed-file-transfer-platform-server-for-zos/7.2.0/doc/pdf/MFT%2520Platform%2520Server%25207.2.0%2520for%2520zOS%2520Installation%2520And%2520Operations%2520Guide.pdf. "Using MFT Platform Server Exits describes the User Exits that ..." 
  3. "COBOL E15 user exit: passing or changing records for sort". https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.1.0/com.ibm.zos.v2r1.icea100/cober15.htm. "If both E15 and E35 user exits are used ... SORTIN DD statement" 
  4. "Sorting Using the User Exit". https://help.sap.com/erp2005_ehp_07/helpdata/en/81/80b6535fe6b74ce10000000a174cb4/content.htm. 
  5. "Unicenter CA-Sort for VSE". https://support.ca.com/cadocs/0/k010181e.pdf. "If Unicenter CA-Sort overlays the user exit storage with ..." 
  6. "Did You Say CMVC?". http://www.redbooks.ibm.com/abstracts/gg244178.html. 
  7. Sample: Opinion.AnalystID.StockSymbol.DateTime - Opinion.Q347.IBM.201907031321 - alternatively, the date/time portion may be filled in by the user exit.