Previous Topic: Register UsageNext Topic: TLMSXTRS - Tape Retention System Exit


Parameter List

The security parameter list passed to this exit is mapped by macro TLMWSECP, and is addressed by SECUPARM in the supplied sample exit. This parameter list is complete and is ready to be parsed and passed to the system security component on return from this exit call. This exit can view all the values in this list, and some can be altered to provide flexibility with different system security packages. For example, the SECOPN system option (check data set access at OPEN) is set to YES, and the security call is at data set creation. The access type byte (SCPACC) will have a value of X'20', indicating create access. This may, in fact, not work for the data set rules that have been coded for the installed security system, and may have to be altered to X'08' (SCPAUPD) for update.

User Exit Parameter Fields

SCPGLOBL

Global security flags can be viewed or altered by the exit.

SCPGLOG

X'40' - suppress event logging

SCPGMSG

X'20' - process security messages

SCPGABN

X'10' - abend, security violation

SCPFUNC

Security call function request

SCPACC

Access requested (default access is always READ), function request 3 only.

SCPRESLN

Resource length, function request 3 only.

SCPUSRID

Address of requesting user ID.

SCPPSWD

Address of user password

SCPNPSWD

Address of new user password

SCPTRMID

Address of terminal ID. This may or may not be available at user exit call time. Test for zeros before using contents as an address.

SCPACEE

ACEE/ACMCB. This may or may not be available at user exit call time. Test for zeros before using contents as an address.

SCPRESOR

Address of resource name if function call is 3.

SCPCLASS

Address of resource class name if function call is 3.

SCPPROGM

Address of program name if function call is 3.

SCPVTRM

Address of virtual terminal name if function call is 1. This may or may not be available at user exit call. Check for valid address.

SCPVPSWD

Address of re-verify password if function call is 7.

SCPVOLSR

Address of volume serial number if function call is 3 and resource is DSN.

SCPCALID

Calling routine ID as one of the following: OPEN, CLSE, TLTP, CMND, BTCH (batch).

The above fields or addresses may be viewed, if present, and will depend on the type of security call in progress. Address pointers should be checked for zeros, in which case no value was supplied and there is no default. Although it is recommended that none of these values be altered, changes to some may be desirable (for example, resource class name). Contact CA TLMS Technical Support when considering these types of changes.

This user exit should be assembled and linked through SMP USERMOD. An example of the JCL is located in CAI.CTAPJCL (TLMJU015).

This exit is activated by specifying YES for the SECEXIT system option.