Introducing User Exits

Reference Guide › User Exit Reference › Introducing User Exits

Introducing User Exits

The table in this section summarizes the action each user exit performs. Unless otherwise noted, prototypes listed are supplied in both REXX (filetype XEXEC) and Assembler (filetype XASSEMBL). All prototypes reside on the minidisk or SFS directory identified as the LOCALSAM samples disk in the VMSES/E installation materials search order.

Note: CA VM:Secure requires the NEWUSER user exit in order to generate the CA VM:Secure directory database using the VMXGNR utility. The NEWUSER user exit is optional but recommended for normal CA VM:Secure operation. The other user exits are optional.

User Exit	Action	Prototype
ACCOUNT	Accepts or rejects new account numbers	VMXEXIT4
AUDIT	Accepts or rejects audit records that are being written to the audit file on the AUDT minidisk	VMXEXITG XASSEMBL
CHKPASS	Allows your site to perform its own logon password verification when a logon password is required to execute CA VM:Secure commands	VMXEXIT9
COMMAND	Examines commands before they are interpreted by CA VM:Secure and optionally modifies or rejects them	VMXEXIT3
DISKCOPY	Allows minidisk copying and formatting with the application of your choice	VMXEXITL
DISTCODE	Accepts or rejects new distribution codes	VMXEXIT6
FORMAT	Allows minidisk formatting with the application of your choice	VMXEXITK
GROUP	Assigns an ACIGROUP record to a user directory entry based on user ID, directory manager, or account number	VMXEXITC
LINK	Accepts or rejects directory links	VMXEXIT8
MDISK	Accepts or rejects changes to minidisk link modes and passwords The MINIDISK user exit supersedes the MDISK user exit; the MDISK user exit will still run with older releases for compatibility.	VMXEXIT7
MINIDISK	Accepts or rejects changes to minidisk link modes and passwords The virtual address of the minidisk is provided to the exit. The MINIDISK user exit supersedes the MDISK user exit.	VMXEXITM
NEWUSER	Determines the directory manager for each user ID in the directory; required by the database generation utility, VMXGNR	VMXEXIT1
PASSCHNG	Provides notification of a change to a user ID’s logon password	VMXEXITJ
PASSWORD	Accepts or rejects new logon passwords	VMXEXIT2
POSTMOVE	Manipulates data that has been moved from minidisks to SFS	VMXEXITH XEXEC
POSTRULE	Accepts or rejects CA VM:Secure rules evaluation or performs additional processing during rules evaluation	VMXEXITF XASSEMBL
PREMOVE	Provides a destination directory name for data moved from minidisk to SFS	VMXEXITI
RULEUPDT	Accepts or rejects rules file changes	VMXEXITE
SCRATCH	Accepts or rejects requests to scratch minidisks or remove user IDs and can prevent moving a minidisk that should not be moved, such as the CMS S‑disk	VMXEXIT5
SECURITY REPORTS	Controls which data appears in audit reports	VMXEXITD
TERMPASS	Determines the action taken when a terminal exceeds the limit for invalid passwords	VMXEXITB
USERPASS	Determines the action taken when a user exceeds the limit for invalid logon passwords	VMXEXITA