Previous Topic: Customization IdeasNext Topic: TSSINSTX Characteristics


Mechanics

Entry point TSSINSTX is called by CA Top Secret at various points during security processing. A function code indicates the type of event being processed and the purpose of the exit call. This code is contained in the passed parameter list called the TXIPL (mapped by the #INSTXPL macro). The TXIPL also provides additional fields to describe the event, many of which can be modified or overridden by the exit if desired.

Prior to CA Top Secret's request processing, the data is examined by the Installation Exit. Upon completion, the Installation exit supplies a return code to CA Top Secret. The return code determines the next course of action.

All of the return codes are documented in TSSINSV1. Those common to all exit functions are:

Return Code

Action

0

Allows CA Top Secret to perform the normal security request authorization.

4

The request is failed immediately by the Installation Exit code.
CA Top Secret does NOT process the request.

8

The Installation Exit authorizes the request. CA Top Secret's equest validation will be superceded (ignored).