Technical Considerations › CLIST Library Format Considerations

CLIST Library Format Considerations

The data center can choose the record format (RECFM) for the prefix.EXAMINE.CLIST library. When the TSO EXEC command executes a CLIST from the CA Auditor CLIST library, the format of the CLIST library is not relevant. TSO determines the record format from the attributes of the CLIST library.

If the CA Auditor CLIST library is incorporated into an existing TSO logon procedure, the record format selected should match that of other CLIST libraries already in use in that procedure. This is necessary because CLIST libraries are concatenated together under the SYSPROC ddname. All libraries in a concatenation must have like attributes. Therefore, the record formats of each library must be identical. Otherwise, error messages and abends can occur.

You can use the TSO LISTALC STATUS command to find the names of the CLIST libraries that your own logon procedure refers to. First, locate the SYSPROC ddname in the LISTALC command output. The data set name appearing in the line immediately above SYSPROC is the name of a CLIST library. Next, issue a LISTDS command specifying that data set name. Check the record format returned in the RECFM column. V or VB indicates variable record format, and F or FB indicates fixed record format for the CLIST library.

If you do not include DD statements for CA Auditor libraries in the TSO logon procedure, you can obtain access to those data sets by invoking the EXAMSTRT CLIST from the TSO READY mode. When EXAMSTRT receives control, it invokes a CA Auditor module that allocates the CA Auditor data sets. The CA Auditor data set names are derived from the name of the LOAD library, which is specified in the EXAMSTRT CLIST.

When allocated, the CA Auditor data sets are inserted at the top of the relevant TSO and ISPF/PDF data set concatenations. The prefix.EXAMINE.CLIST library becomes the first data set in the SYSPROC concatenation. Similarly, other CA Auditor libraries are inserted at the top of the ISPF/PDF program (ISPLLIB), panel (ISPPLIB), message (ISPMLIB), and table (ISPTLIB) library concatenations. In this way, if duplicate member names occur in any of these concatenations, the system always uses the CA Auditor version. Those allocations then remain in effect for the duration of the TSO session.