The CA Top Secret TSSRSVC1 module provides Resource Name List support. This support allows authorized programs to call CA Top Secret to retrieve the names of resources within a class that a given ACID can access at READ level or higher.
TSSRSVC1 searches the RDT for the class name. If the class is found, TSSRSVC1 checks all permissions and determines if the specified ACID is authorized to access the resource at READ level or higher. When TSSRSVC1 finds a match, it places the resource name into the input work area. CA Top Secret supports any general resource or PIE resource (resource classes that support masking) in the RDT.
CA Top Secret searches the USER, PROFILE, and ALL records, but may stop if the size of the output list exceeds the work area.
CA Top Secret loads the address of TSSRSVC1 into RCVTPNL0 during initialization. The caller of the module must use the address in RCVTPNL0 in the RCVT. The RCVT is mapped by the IBM ICHPRCVT macro.
Note the following:
When you invoke TSSRSVC1 support, your program must use the CALL command to pass the parameters:
A name from which CA Top Secret derives the resource names to which the ACID has authorization.
Length: 8 characters
A full word that contains the length of the area in which TSSRSVC1 is going to build the Resource Name List.
A full word pointer that contains the address of the workarea where TSSRSVC1 is going to build the Resource Name List.
A full word pointer that contains the address of the ACEE for the ACID for whom resource authorization is being determined.
A fixed (31) count field that precedes the Resource Name List contains the total count of resource names returned by TSSRSVC1. The format of the list when it is placed in the work area is:
The two byte length of the resource name.
A one byte flag field (only the first bit is used). The first bit of the flag field byte is on if the resource is a generic resource.
A variable length resource name.
TSSRSVC1 returns 0 to indicate a successful search.
The following return codes are returned in register 15:
The Resource Name List function completed successfully.
No resources found for which the ACID had at least READ access.
No resource entries found for that class; indicates that no resources existed for the input class.
The work area was not large enough to hold all the resource names.
Resource Name List parameter error.
The following reason codes are returned in register 0:
No ACEE available.
Work Area too small to contain a single resource.
Input Class name not valid.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|