Previous Topic: Application Interface ChecksNext Topic: Data Set and Volume Checking


General Resource Checking

The interface allows an application program to check resources. To perform a resource check for resources other than data sets or volumes, the following Request Record fields must be supplied by the application program:

TSSHEAD

See Request Record Data Fields for details.

TSSCLASS

For a standard resource check, specifies the resource class (RDT RESCLASS).

TSSRNAME

For a standard resource check, specifies the name of the resource within TSSCLASS.

TSSPPGM

For a standard resource check, specifies a program name through which the resource is being accessed.

TSSACC

For a standard resource class whose RDT definition includes explicit access levels, this field must correspond to one of the defined access levels (left justified and space filled); however, if specified with hex-zeroes, the RDT DEFACC value will be substituted. This field is ignored for resources whose associated RDT has no defined access levels.

TSSCACEE

For all general resources, this field represents the address of an ACEE for whom the resource or special check is being performed. (This address would have to be supplied programmatically using an appropriate RACROUTE REQUEST=VERIFY macro.) In order for such requests to be valid, the current signed on user would have to be cross‑authorized to the requested ACID. By convention, if TSSCACEE is all blank (x'40'), the check to be requested will be presumed for the current signed on ACID.

In CICS, TSSCAI will only honor TSSCACEE when OPTIONS(64) has been selected at TSS initialization. In IDMS, TSSMAI will never honor TSSCACEE.

TSSLOG

If violation logging is required, code Y. If any other value is entered, no logging will occur.

CA Top Secret supplies a Return Code in the TSSRC field and a Character Return Code in the TSSCRC field to the application program.