DSPIFSAUD -- Display IFS Auditing

DSPIFSAUD DISPLAY IFS AUDITING TAAIFTV
The Display IFS Auditing command displays the auditing attribute of IFS objects. Selection may be made on the type of auditing including NONE. DSPIFSAUD assists in understanding what is being audited. To specify auditing for an IFS object, use CHGAUD. DSPIFSAUD uses CVTIFS to convert the IFS objects to an outfile (unless OBJ(EXISTS) is specified). To use CVTIFS, you must be authorized to the TAACVTIFS AUTL. A typical command would be: DSPIFSAUD OBJ('/home/xxx') The objects in the specified directory would be displayed with their auditing attribute. For a discussion of the system auditing function, use DSPTAA AUDITING. DSPIFSAUD escape messages you can monitor for --------------------------------------------- None. Escape messages from based on functions will be re-sent. DSPIFSAUD Command parameters CMD ---------------------------- OBJ The path name of the object to be converted. The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. The default is . Specifying will start the convert process at the current directory level. If the current directory level is at the root ('/'), the convert process will start at the home directory ('/home'). You must be authorized to the TAACVTIFS authorization list to specify a path name. The special value of IFS may also be entered. Specifying IFS will start the convert process at the root directory level ('/') excluding /QDLS, /QOPT and /QSYS.LIB. If directories are to be excluded, CVTIFS must be used previously with the OMITDIR parameter. The special value EXISTS may be entered if CVTIFS has already been run and you want to use the created outfile. If EXISTS is used, the IFSDIRPLIB and MBR parameters must specify the library and member of the existing file. See the OUTFILFMT parameter for the file name. PROCSUBDIR If the Object parameter is a directory, specify a YES/NO value to indicate whether all subdirectories relative to that directory are to be included. The default is YES. NO may be specified to process only the directory level. AUDVAL The auditing value to be selected. ALLVAL is the default meaning that all values including NONE (not being audited) are selected. NONE may be specified to select those not being audited. USRPRF may be specified to select those objects that will be audited if the user profile using or changing the object is specified to be audited. CHANGE may be specified to select those objects that if changed will cause an audit entry. ALLAUDVAL may be specified to select those objects that are specified for some auditing (CHANGE, ALL, or USRPRF). This selects those objects that are other than NONE. USRPRF The user profile that will be switched to during run time. QSECOFR is the default. For file systems (such as QNTC), CVTIFS will fail if QSECOFR does not exist. CURRENT may be used or a specific user profile, but the profile must have ALLOBJ special authority. OUTPUT How to output the results. * is the default to display the spooled file if the command is entered interactively. The spooled file is deleted after it is displayed. If the command is entered in batch or PRINT is specified, the spooled file is output and retained. IFSDIRPLIB The library of the existing file if OBJ(EXISTS) is specified. The default is LIBL. CURLIB may also be entered. See the OUTFILFMT for the name of the file. MBR The member of the existing file if OBJ(EXISTS) is specified. The default is FIRST. LAST may also be entered. This parameter is ignored if EXISTS is not specified for the OBJ parameter. Restrictions ------------ DSPIFSAUD uses CVTIFS to convert the IFS objects to an outfile (unless OBJ(EXISTS) is specified). To use CVTIFS, you must be authorized to the TAACVTIFS AUTL. Prerequisites ------------- The following TAA Tools must be on your system: CHKOBJ3 Check object 3 CHKSPCAUT Check special authority CRTDUPPF Create duplicate physical file CVTIFS Convert IFS RSNLSTMSG Resend last message RTVSYSVAL3 Retrieve system value 3 SNDCOMPMSG Send completion message SNDESCINF Send escape information SNDJLGMSG Send job log message SNDSTSMSG Send status message Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- DSPIFSAUD CMD TAAIFTV QATTCMD TAAIFTVC PGM CLP TAAIFTVC QATTCL TAAIFTVR *PGM RPG TAAIFTVR QATTRPG

DSPIFSAUD       DISPLAY IFS AUDITING                   TAAIFTV


The Display  IFS Auditing  command displays  the auditing attribute  of
IFS objects.   Selection may be made on  the type of auditing including
*NONE.   DSPIFSAUD assists in understanding  what is being audited.  To
specify auditing for an IFS object, use CHGAUD.

DSPIFSAUD  uses  CVTIFS to  convert  the  IFS  objects  to  an  outfile
(unless  OBJ(*EXISTS)  is specified).    To  use  CVTIFS, you  must  be
authorized to the TAACVTIFS *AUTL.

A typical command would be:

             DSPIFSAUD   OBJ('/home/xxx')

The  objects in the  specified directory would be  displayed with their
auditing attribute.

For  a  discussion  of  the   system  auditing  function,  use   DSPTAA
AUDITING.

DSPIFSAUD escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

DSPIFSAUD Command parameters                          *CMD
----------------------------

   OBJ           The path  name of  the object  to be  converted.   The
                 object  path name  can be  either a  simple name  or a
                 name  that  is   qualified  with  the   name  of   the
                 directory  in  which  the  object  is  located.    The
                 default is *.

                 Specifying  * will  start the  convert process  at the
                 current  directory  level.   If the  current directory
                 level is at the  root ('/'), the convert  process will
                 start at the home directory ('/home').

                 You    must   be    authorized   to    the   TAACVTIFS
                 authorization list to specify a path name.

                 The  special  value  of  *IFS  may  also  be  entered.
                 Specifying *IFS  will  start the  convert  process  at
                 the  root  directory  level   ('/')  excluding  /QDLS,
                 /QOPT  and  /QSYS.LIB.    If  directories  are  to  be
                 excluded, CVTIFS  must  be used  previously  with  the
                 OMITDIR parameter.

                 The special  value *EXISTS  may be  entered if  CVTIFS
                 has already  been run and you want  to use the created
                 outfile.   If *EXISTS is  used, the IFSDIRPLIB and MBR
                 parameters must  specify  the  library and  member  of
                 the existing  file.   See the OUTFILFMT  parameter for
                 the file name.

   PROCSUBDIR    If  the  Object parameter  is a  directory,  specify a
                 *YES/*NO    value    to    indicate    whether     all
                 subdirectories relative  to that  directory are  to be
                 included.  The default is *YES.

                 *NO  may be  specified to  process only  the directory
                 level.

   AUDVAL        The auditing value  to be  selected.   *ALLVAL is  the
                 default meaning that  all values including  *NONE (not
                 being audited) are selected.

                 *NONE  may  be specified  to  select  those not  being
                 audited.

                 *USRPRF  may  be  specified  to  select  those objects
                 that will  be audited  if  the user  profile using  or
                 changing the object is specified to be audited.

                 *CHANGE  may  be  specified  to select  those  objects
                 that if changed will cause an audit entry.

                 *ALLAUDVAL  may be  specified to select  those objects
                 that are specified for  some auditing (*CHANGE,  *ALL,
                 or  *USRPRF).   This selects  those  objects that  are
                 other than *NONE.

   USRPRF        The user  profile that will be  switched to during run
                 time.   QSECOFR  is the  default.   For  file  systems
                 (such as QNTC),  CVTIFS will fail if QSECOFR  does not
                 exist.

                 *CURRENT may  be used or a specific  user profile, but
                 the profile must have *ALLOBJ special authority.

   OUTPUT        How  to  output  the results.    * is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.   The spooled file is  deleted after it
                 is displayed.

                 If  the  command  is entered  in  batch  or  *PRINT is
                 specified, the spooled  file is  output and  retained.

   IFSDIRPLIB    The library  of the  existing file if  OBJ(*EXISTS) is
                 specified.   The default  is *LIBL.   *CURLIB may also
                 be entered.   See the  OUTFILFMT for the  name of  the
                 file.

   MBR           The member  of the  existing file  if OBJ(*EXISTS)  is
                 specified.   The default  is *FIRST.   *LAST  may also
                 be entered.

                 This   parameter   is  ignored   if  *EXISTS   is  not
                 specified for the OBJ parameter.


Restrictions
------------

DSPIFSAUD  uses  CVTIFS to  convert  the  IFS  objects  to  an  outfile
(unless  OBJ(*EXISTS)  is specified).    To  use  CVTIFS, you  must  be
authorized to the TAACVTIFS *AUTL.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CHKSPCAUT       Check special authority
     CRTDUPPF        Create duplicate physical file
     CVTIFS          Convert IFS
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDJLGMSG       Send job log message
     SNDSTSMSG       Send status message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

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

   DSPIFSAUD     *CMD                   TAAIFTV       QATTCMD
   TAAIFTVC      *PGM       CLP         TAAIFTVC      QATTCL
   TAAIFTVR      *PGM       RPG         TAAIFTVR      QATTRPG

Added to TAA Productivity tools January 15, 2010

Home Page

Up to Top