R_cachserv Callable Service And Top Secret

Products

• Top Secret

Issue/Introduction

What is the R_cacheserv callable service and what is the relationship with Top Secret?

Resolution

The R_cacheserv SAF callable service provides a mechanism for the storage and retrieval of security relevant information from a cache.

1. Top Secret security for HARDENNING:
   
   Function codes X'0001' through X'0005' only:
   
   For callers not running in system key or supervisor state, the use of R_cacheserv is authorized by the resource IRR.RCACHESERV.cachename in the IBMFAC class.
   
   The application server must be running with a Top Secret ACID or profile that has at least READ authority to this resource. READ allows the application server to utilize the Fetch function, x'0004', while UPDATE authority provides the capability to use all the functions.
   
   Function code X'0006' only:
   
   For callers not running in system key or supervisor state, the use of R_cacheserv is authorized by the resource IRR.RCACHESERV.ICTX in the FACILITY class.
   
   The application server must be running with a Top Secret ACID or profile that has at least READ authority to this resource. READ allows the application server to utilize the Retrieve, and RetrieveAppl, and RemoveExpired options (X'0003', X'0004', and X'0006'), while UPDATE authority provides the capability to use all of the options.
   
   Function code X'0007' only:
   
   For callers not running in system key or supervisor state, the use of R_cacheserv is authorized by the resource IRR.RCACHESERV.ICRX in the IBMFAC class.
   
   The application server must be running with a Top Secret ACID or profile at the address space level that has at least READ authority to this resource.
   
   READ authority allows the application server to utilize the RetrieveAppl and Remove options ( X'0002' and X'0003'), while UPDATE authority provides the capability to use all of the options.
   
   
2. How to call the R_cachserv callable service and relationships with Top Secret control options:
   
   How to call:
   
   CALL IRRSCH00 (Work_area,
   ALET, SAF_return_code,
   ALET, RACF_return_code,
   ALET, RACF_reason_code,
   ParmALET,
   NumParms,
   Function_code,
   Option,
   Version,
   Version_length,
   Record_name_ptr,
   Record_name_length,
   Data_ptr,
   Data_length,
   Data_timeout,
   Source_ptr,
   Source_length,
   Reference_timeout,
   Reference_userID,
   Reference,
   Subpool,
   ACEE_ALET,
   ACEE,
   ICRX_area,
   ICRX_length
   )

How to harden:

1. Add the following DD statement to the Top Secret startup procedure JCL:
   
   //RCACHE DD DSN=rcache.vsam.file.name, DISP=OLD
   
   file.name : Specifies the file name used in the INITCSRV job.
   
   
2. Insert RCACHE and RCQNAME control options to specify hardening and to define the cache names that are to be hardened.
   
   The RCQNAME contains the Cache_name. It is 6 chars long and starts with 'R'.
   RCACHE(YES) allows cache hardening.
   If you have RCACHE(YES) and NO R_CACHSERV HARDENING TABLE ENTRIES, it means there is no RCQNAME defined to Top Secret.