The CA Top Secret Application Interface provides a mechanism by which application programs may invoke the services of the CA Top Secret VM server machine. These services include resource validation, dynamic extract and update of Security Record installation data, password extraction, logging of user data, and establishing a security environment.
The Application Interface is invoked using the security diagnose (X'A0') with the Rx register containing the address of the 572-byte application interface parameter list (AIPL) and the Ry register containing a subcode of 3. The AIPL must be aligned on a doubleword boundary, and the first 16 bytes of the AIPL must be contained within the same 4K page of storage or a specification exception results. A condition code of 0 from the diagnose indicates that the request was processed by the server machine. The function code (AIFUNC), return code (AIRC), detail reason code (AIDRC), and messages (AI#MSG for message count, AIMSG for message text) are returned in the AIPL. A condition code of 1 indicates that the server machine was unavailable for the request. In some cases, a valid return code is still provided. (See the individual function descriptions below.) The AIPL field requirements and restrictions are as follows:
|
Copyright © 2008 CA.
All rights reserved.
|
|