Using the Sysplex Coupling Facility › Define SYSTEM LOGGER to CA Top Secret

Define SYSTEM LOGGER to CA Top Secret

System logger is a z/OS component that allows an application to log data from different systems across a sysplex. A system logger application can be supplied by:

• IBM, for example the CICS log manager and the operations log stream (OPERLOG)
• Independent software vendors
• Your installation

A system logger application can merge the log data from systems across the sysplex into a log stream. A log stream is a collection of data in log blocks residing in a coupling facility list structure, on DASD, or on both.

To set up the z/OS CICS log manager with CA Top Secret

1. Follow substep A or B to define the IXGLOGE address space and the required SAF authorizations.
   1. Define IXGLOGR in the Started Task table to bypass SAF calls:

      	TSS ADD(STC) PROCNAME(IXGLOGR) ACID(BYPASS)
      

      This bypasses all SAF calls and, therefore, does not require additional resource permits.

      or

   2. Define IXGLOGR in the Started Task table:

      	TSS ADD(STC) PROCNAME(IXGLOGR) ACID(ixglogr)
      

2. Permit access to the log stream coupling facility structures.

   TSS ADD(dept) IBMFAC(IXLSTR.structure_name)
   TSS PER(ixglogr) IBMFAC(IXLSTR.structure_name) ACCESS(ALL)
   

3. Permit access to the DASD log stream and staging data sets.

   TSS ADD(dept) DSNAME(hlq.data_set_name)
   TSS PER(ixglogr) DSNAME(hlq.data_set_name) ACCESS(ALL)
   

   The default hlq is IXGLOGR if none is specified on the HLQ parm of the DEFINE LOGSTREAM statement.

4. Permit access to the systems SYSx.PARMLIB

   TSS ADD(dept) DSNAME(SYS1.PARMLIB)
   TSS PER(ixglogr) DSNAME(SYS1.PARMLIB) ACCESS(READ)
   

5. Control which applications can access the system logger resources.

   For logrec log stream, CICS log manager, and OPERLOG system logger application, define access to the log stream.

   TSS ADD(dept) LOGSTRM(log_stream_name)
   TSS PER(acid) LOGSTRM(log_stream_name) ACCESS(UPDATE)
   

6. Authorize who can use the IXCMIAPU utility.

   Define authorizations to use IXCMIAPU.

   TSS ADD(dept) IBMFAC(MVSADMIN.)
   TSS PER(acid) IBMFAC(MVSADMIN.) ACCESS(ALL)  <= Define structure
   TSS PER(acid) IBMFAC(MVSADMIN.) ACCESS(READ) <= Execute Report
   

   The LOGSTRM resource class is already pre‑defined in CA Top Secret.