TAA Tools
SNDAUDE         SEND AUDIT ENTRY                       TAASEDP

The Send Audit Entry  command sends an entry to the  QAUDJRN journal if
it  exists.  If  the journal  does not  exits, the entry  is sent  as a
TAA9881  message to QHST.   An ID must  be sent with  the entry to help
identify the entry.

The  intent of  SNDAUDE  is  when  you are  performing  some  sensitive
function  and want  to  provide an  audit  trail of  who performed  the

The  program adopts the  QSECOFR profile  to allow sending  an entry to
the QAUDJRN journal which may be *PUBLIC *EXCLUDE.

A typical command would be:

             SNDAUDE   ID(xxx) ENTDTA(yyyy)

The Journal Code  sent is  always a 'U'.   The Entry  Type defaults  to

Since a command other  than SNDJRNE is used, the  journal entry for the
JOPGM  field always describes the  CPP for SNDAUDE as  the program that
sent the journal entry.  To  provide more meaningful data, the  program
that used  SNDAUDE is determined  and the program  name is placed  into
the entry data (positions 11-20).

The entry that is sent has the following format:

       1 -  10    The ID specified on the command
      11 -  20    The program that used SNDAUDE
      21 - 510    The ENTDTA value.

Calling the CPP from a HLL

You  may call  the  CPP  (SNDAUD) directly  from  a HLL  program.   The
following is sample RPG code which may be copied:

     IENTDTA      DS                            490
     C                     MOVEL'...'     ENTDTA           Entry text
     C                     CALL 'SNDAUD'                   TAA Tool
     C                     PARM 'xxxxxxxx'ID     10        Entry ID
     C                     PARM           ENTDTA           Entry data
     C                     PARM 'TA'      ENTTYP  2        Entry type

The ID and ENTTYP fields must not be blank.

Command parameters                                    *CMD

   ID            The  audit ID  assigned.  This  is any  value you want
                 that will help  identify the entry  (up to 10  bytes).
                 For example,  it may be  a command name that  is being

   ENTDTA        The entry data.  Up to 490 bytes may be entered.

   ENTTYP        The  journal entry type.  This is  a 2 byte field that
                 is used as the ENTTYP  parameter if the entry is  sent
                 as a journal  entry.  The value defaults to  'TA'.  If
                 the  entry   is  sent  to  QHST,   this  parameter  is




The following TAA Tools must be on your system:

     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message


None, the tool is ready to use.

Objects used by the tool

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SNDAUDE       *CMD                   TAASEDP       QATTCMD
   SNDAUD        *PGM       CLP         TAASEDPC      QATTCL

Note that the command is SNDAUDE, but  to call the function from a  HLL
program, the CPP name is SNDAUD.

Added to TAA Productivity tools August 1, 1996

Home Page Up to Top