Audit Version Delete User Exit routine requirements

If you specify a user exit option parameter, SCLM passes it to the user exit routine, followed by a string of up to eleven parameters separated by commas. The parameter list can include one list of user-specified options followed by up to ten SCLM parameters (see Table 1). The address of this input data is contained at the address stored in register 1. The first halfword of the input data is the number of characters comprising the input data string. Immediately following this halfword length is the input parameter string itself.

The user exit routine must pass back a return code value to SCLM in register 15. A return code of zero is considered to be successful and processing continues. A nonzero return code from the first audit version delete exit verify routine (AVDVFY) causes processing to end and the requested audit and version information is not deleted. The second audit version delete notify user exit routine (AVDNTF) can pass back any value in register 15 and processing continues because the delete has already been performed.

Table 1 explains the format and description of the parameters passed from SCLM to all audit version delete user exits.

Table 1. User Exit Parameters
Parameter	Description
OPTION LIST	Up to 255 characters, including delimiters (blank padding is not performed for this parameter). Parameter is specified in the FLMCNTRL macro using macro parameters AVDVFYOP and AVDNTFOP. Delimit this string so that the SCLM parameters that follow can be identified by the user exit routine.
‘xxxxxxxx’	An 8-character literal value indicating the exit type (capitalized, left-aligned, blank-padded). Valid types are: ADVERIFY Audit Version Delete Verify ADNOTIFY Audit Version Delete Notify
PROJECT	The 8-character name of the project (capitalized, left-aligned, blank-padded).
LIBDEF	The 8-character name of the project definition (capitalized, left-aligned, blank-padded).
USERID	The 8-character value of the user's logon ID (capitalized, left-aligned, blank-padded).
GROUP	The 8-character name of the group (capitalized, left-aligned, blank-padded) for the audit record or audit record and version.
TYPE	The 8-character name of the type (capitalized, left-aligned, blank-padded) for the audit record or audit record and version.
MEMBER	The 8-character name of the member (capitalized, left-aligned, blank-padded)for the audit record or audit record and version.
DATE	The 10-character, multicultural support, formatted date with 4-character year for the audit record or audit record and version.
TIME	The 11-character time for the audit record or audit record and version. The format for the time is HH:MM:SS.hh or HH:MM:SS,hh. In the format, HH is the hour from a 24-hour clock, MM is the minutes, SS is the seconds, and hh is the hundredths of a second.
VERSION MEMBER NAME	The 8-character version member name (capitalized, left-aligned, blank-padded) indicates whether the requested audit record has an associated version. When an associated version exists, this value is the same as the member name. This value is blank when the requested audit record does not have an associated version.