Logging SPI commands

System programming interface commands are audited to aid system administration and auditing.

About this task

Auditing system programming interface commands generates messages which are directed to the CADS transient data queue. The messages are written in a human readable form and can be redirected to another queue to aid problem determination. You can also redirect them to a separate queue if the volume of messages is high. See SPI commands that can be audited.

The CADS queue is defined in the DFHDCTG group which is part of DFHLIST. CADS is defined as an indirect queue and redirected to the CSSL queue by default. The definitions are shown in Figure 1. However, you can redirect CADS to an extrapartition queue specially defined for the purpose. For example, you can define an extrapartition queue named "SPIAUDIT" as shown in Figure 2

Figure 1. Definitions for SPI audit messages redirected to CSSL

*
DEFINE TDQUEUE (CSSL)         GROUP(DFHDCTG)
       DESCRIPTION(USED FOR MESSAGES)
       TYPE(EXTRA)            TYPEFILE(OUTPUT)
       RECORDSIZE(132)        BLOCKSIZE(136)
       RECORDFORMAT(VARIABLE) BLOCKFORMAT(UNBLOCKED)
                              DDNAME(MSGUSR)
*
DEFINE TDQUEUE (CADS)         GROUP(DFHDCTG)
       DESCRIPTION(SPI AUDIT MESSAGES)
       TYPE(INDIRECT)         INDIRECTNAME(CSSL)
*

Figure 2. Definitions for SPI audit messages redirected to extrapartition queue

*
DEFINE TDQUEUE (SPIA)     GROUP(DFHDCTG)
       DESCRIPTION(USED FOR MESSAGES)
       TYPE(EXTRA)            TYPEFILE(OUTPUT)
       RECORDSIZE(132)        BLOCKSIZE(136)
       RECORDFORMAT(VARIABLE) BLOCKFORMAT(UNBLOCKED)
                              DDNAME(SPIAUDIT)
*
DEFINE TDQUEUE (CADS)         GROUP(DFHDCTG)
       DESCRIPTION(SPI AUDIT MESSAGES)
       TYPE(INDIRECT)         INDIRECTNAME(SPIA)
*