eTrust CA-Top Secret Security for z/OS and OS ... - SupportConnect

The SYSPLEX XES FunctionThere are three types of structures that can be defined to the Coupling Facility,these include the List, Cache, and Lock structures. eTrust CA-Top Secret uses theList structure to "hold" the Security File. With a List structure, numerousfunctions can be performed against the Security File. For example, reads, writes,deletes, or multiple deletes can be performed. A connection between eachsystem in the sysplex and the structure in the Coupling Facility must be createdto establish communication. This connection must be established prior to anyother function and indicates to the Coupling Facility which structure is to containthe data for future processing. When eTrust CA-Top Secret is donecommunicating with the structure in the Coupling Facility, a disconnect must beperformed. A List structure can be redefined while systems are connected to it.A redefining of the structure can take place if, for example, it becomes full and itis necessary to increase its size.A List structure is made up of headers and data elements. Each header can beused to break up different types of information in the structure. There is amaximum of sixteen headers that any one structure can have. With each header,data elements contain the data that is stored in the structure. The number ofheaders and the size of each data element are defined to the Coupling Facilitywhen eTrust CA-Top Secret "connects" to the structure. eTrust CA-Top Secretonly requires the use of one header. Multiple data elements can exist under thatone header.The total size of the structure is dependent on how the structure is defined to theCoupling Facility. The required size of the Coupling Facility structure can bedetermined using the TSSFAR utility. This is done when the systemsprogrammer defines the name of the structure. Next, the amount of data isdependent on how the structure is defined at connection time. The first systemto connect to a structure supplies information on how the structure is set up. Forexample, the number of headers and the maximum data element size, are two ofmany factors determining the amount of data that can be placed in a structure.These factors are supplied at connection time and are used in a calculation that isdone during the connection.Once a List structure is full, no more data can be added to it. However, thesystem programmer can increase the size of the Coupling Facility structure withno disruption to the system, or rebuilt the structure characteristics with minimaldisruption to the system.The Coupling Facility design handles any failure in it or its connections bydisconnecting and reverting to normal I/O processing. After the problem isresolved, the user must reactivate the Coupling Facility by reactivating thesysplex connection.3–2 Cookbook