TAA Tools
CAPSYSINF       CAPTURE SYSTEM INFORMATION              TAASYTM

The Capture  System  Information tool  provides a  method of  capturing
all  object, member,  and IFS  object information  on  a system.   Each
type  of  information is  optional.   Each time  CAPSYSINF is  run, new
versions are added  to files in  a named library  (the default name  is
TAASYSINF).   These files can then be  used by other TAA  Tools such as
CPYSYSINF or CMPSYSINF or queried by user functions.

Each version becomes a separate member in one of the files.

A  large amount  of space  will normally  be required  and considerable
overhead is consumed when the command is running.

TAASYSINF Library and the CRTSYSINF command
-------------------------------------------

The TAASYSINF library  is the default  name of the  library to  contain
the  information.   Any name  may be  used,  but the  library must  not
exist.

If  you take  the default  for  CRTSYSINF, the  TAASYSINF name  will be
used as the library  name.  The TAASYSINF  library is not shipped  with
the TAA Productivity Tools product.

A  typical use  of  CAPSYSINF would  be  to use  *HOME  to convert  the
objects  in the '/home'  directory.  Many  system objects exist  in the
IFS  that you may not want to convert.   Each IFS object requires about
6000  bytes  in   order  to  hold  the   full  path  name  plus   other
information.

Another  typical  IFS solution  is  to  use  the CRTIFSLST  command  to
create  a list  of  directories you  want to  convert and  then specify
*IFSLST along  with the  file name  that contains  the list.   See  the
IFSLST tool for how to make an IFSLST.

When you  enter the  CRTSYSINF command,  the library  is created and  a
job  scheduling job  (CAPSYSINF) is  optionally set  to run  weekly and
collect the information.   You must have  *ALLOBJ special authority  to
use CRTSYSINF.

A typical CRTSYSINF command would be:

             CRTSYSINF    SCDDAY(*SAT) TIME(010000)
                            IFSLST(xxx/yyy)

The CAPSYSINF job is  then scheduled to run every Saturday  at 1:00 AM.
If  you   want  to  run  CAPSYSINF  using   your  own  SBMJOB,  specify
SCDDAY(*NONE).

By   default,  1)  information   for  objects  and   libraries  2)  all
information for  members and 3)  all objects  in the '/home'  directory
(and sub-directories) would be collected.

Changing or Removing the CAPSYSINF job schedule entry
-----------------------------------------------------

You can  change the  CAPSYSINF job schedule  entry by  using WRKJOBSCDE
and option 2 (Change).

If  you want to  change when the  job is scheduled,  use the CHGJOBSCDE
command parameters.  To change  the CAPSYSINF command parameters  (such
as whether to  capture IFS information), use CHGJOBSCDE and  then F4 to
prompt  for  CAPSYSINF  command  and  specify  the  types you  want  to
capture information for.

If you want submit CAPSYSINF when required, use option 4 (Remove).

CAPSYSINF
---------

CAPSYSINF is the name  of the job  schedule entry and  the name of  the
job which is submitted.   It is also the name of the  command that will
be  run.    CAPSYSINF  is  a  long  running  function  as  it  captures
information using several commands.

CAPSYSINF  is intended to be run weekly  by using a single job schedule
entry.  However, you  may enter CAPSYSINF with additional  job schedule
entries or enter the command directly as often as required.

Each time  CAPSYSINF is run,  one or more  versions are added  to files
in the library specified on CRTSYSINF.

The  following files will exist  in the library (assuming  you take the
defaults).  You may  choose not to collect  information for any of  the
files by using a parameter on CAPSYSINF.

  **   DSPOBJD.  The  DSPOBJD outfile for all objects  in all libraries
       is  written to the  DSPOBJD file in  the specified library  as a
       new version.

  **   DSPOBJDL.  A LF over the DSPOBJD outfile by object name.

  **   CVTFD.  This  is created  by the  TAA command CVTFD.   CVTFD  is
       the TAA version of  DSPFD TYPE(*MBR).  In addition  to the DSPFD
       information  for  all  members  on  the system,  CVTFD  provides
       additional   fields  for  IASP  information.    The  outfile  is
       written as  a new  version to the  CVTFD file  in the  specified
       library.

  **   CVTIFS.   This is created  by the TAA  tool CVTIFS.  If  the IFS
       parameter is other than *NO.

       The  outfile  is written  to the  CVTIFS  file in  the specified
       library as a new version.

Version (member)  names follow  the  format of  McyymmddN.   The  first
letter is  always M.   The next 7 characters  are CYYMMDD for  the date
converted.    The  9th character  is  letter  A for  the  first  use of
CAPSYSINF on  a  given  date.   You  may  have up  to  26  versions  of
CAPSYSINF in a single date where the 9th letter will be A-Z.

A typical version (member) name would be:

          M1050701A

meaning it is the first  version added on July 1, 2005.   The date/time
that  CAPSYSINF was begun  is used in  the member description  for each
version added.

Version name in outfiles
------------------------

Part  of the  CAPSYSINFx command  processing is  to update  the version
name  into  a  field in  the  record  so  the  processing  program  can
determine whether  a From  or To record  exists.  The  following fields
contain the version name:

               File            Field         Description
               ----            -----         -----------

               DSPOBJD         ODPGP         Primary group
               CVTFD           MBFMSL        Format selector library
               IFSDIRT         IFPGRP        Primary group

These  fields will not contain the original  data from the outfile, but
rather the version name as assigned by CAPSYSINFx.

Removing versions from the library
----------------------------------

Each time CAPSYSINF  is run, new  versions (members) are  added to  the
files in the library you specified on CRTSYSINF.

No automatic  removal of old versions  is provided for because  you may
have a unique strategy for how long to keep certain information.

For  example, you may want  to keep the  versions that were  run at the
beginning of each month to  allow for comparisons.   At the end of  the
month, you might  then remove the versions  for the weeks that  were no
longer needed.

Because the  versions can be very large, you  will want to periodically
remove  the versions  that you no  longer need.   The WRKSYSINF command
is provided for this.  Enter:

            WRKSYSINF

The work  display appears  with one  line for  each time  you have  run
CAPSYSINF.   You may remove all  the versions for  a specific CAPSYSINF
occurrence  or use  the  option to  work with  the versions  created on
that occurrence.

From the second  display, you may  remove specified versions  (members)
you no longer need.

All versions created by  the same use of CAPSYSINF  are shown as having
the same create date and time.

Querying and copying the files in the library
---------------------------------------------

You may  query the data in  the files in the  library you specified for
CRTSYSINF by  using CMPSYSINF,  your  own query,  or a  combination  of
CPYSYSINF and your own query.

To  allow for  a  subset, 3  Copy  commands are  provided  by the  tool
CPYSYSINF.

             CPYSYSINFO     Copies DSPOBJD object records
             CPYSYSINFM     Copies CVTFD member records
             CPYSYSINFI     Copies CVTIFS entry records

The CPYSYSINFn commands all provide various selection criteria.

You  may write your  own queries  against the  files in the  library or
make  a copy of selected records and perform  a query on your subset of
the data.

The  CVTFD  file  is  a  superset  of  the  system  outfile  for  DSPFD
TYPE(*MBR) which  uses QAFDMBR as the  outfile.  The CVTFD  outfile has
additional  fields  for  IASP information.    The  following  files are
provided:

   File       Model file   Format
   ----       ----------   ------

   DSPOBJD    QADSPOBJ     QLIDOBJD

   DSPOBJDL   QADSPOBJ     QLIDOBJD   Logical over DSPOBJD
   CVTFD      TAADBKHU     QWHFDMBR
   IFSDIRT    TAAIFSAT     IFSDIR2

CAPSYSINF Security
------------------

CRTSYSINF may  only be  entered by  an *ALLOBJ  user.   The default  on
CRTSYSINF is to create the TAASYSINF library as *PUBLIC *EXCLUDE.

CRTSYSINF also creates  the job schedule entry CAPSYSINF.   Because the
job is run by an *ALLOBJ user, all objects can be accessed.

To allow some trusted users to have access to the library, use:

             EDTOBJAUT     OBJ(xxx) OBJTYPE(*LIB)

with the library name you specified on CRTSYSINF.

The  files in  the library  are created  as  *PUBLIC *USE.   If  a user
(without *ALLOBJ special authority) is  allowed access to the  library,
he  can access  the information  in  any file,  but  cannot change  the
data.

The   WRKSYSINF  command  requires   *USE  authority  to   the  library
containing  the  files.    To  remove  a  version,  a  user  must  have
*OBJEXIST authority to the file.

A special command RTVSYSINFD  retrieves the library name you  specified
on  CRTSYSINF  and the  other  options  specified  on CRTSYSINF.    The
command  is  authorized  to  the  public  and  uses  the program  adopt
function  to   access   the  information   stored  in   the   CAPSYSINF
Application Value (*USRSPC) in TAASECURE.

Changing the System Information Library name
--------------------------------------------

If you have  already used the CRTSYSINF command and  created a library,
you  can change  the library  containing the  files used  by CAPSYSINF.
The Application Value CAPSYSINF in  TAASECURE contains the name of  the
library you  named when CRTSYSINF was  first used.   If you are  out of
synch between  what the tool  expects to use  for the library  name and
what you require, you must change the name.

To change the name, use:

             EDTAPPVAL     APPVAL(TAASECURE/CAPSYSINF)

When the display appears, enter the library name in LIB parameter.

CAPSYSINF escape messages you can monitor for
---------------------------------------------

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

CRTSYSINF command parameters                          *CMD
----------------------------

   SCDDAY        The  day  of  the  week to  run  CAPSYSINF.    A value
                 *NONE, *SUN, *MON ...  *SAT must be entered.

                 *NONE should  be  used  if you  want  to do  your  own
                 submit of CAPSYSINF on a non-regular basis such as:

           SBMJOB JOB(CAPSYSINF) CMD(CAPSYSINF)

                 Use *SUN,  *MON ...  *SAT  to run the job  on a weekly
                 basis.

                 If  you  choose  to run  the  command  at  a different
                 frequency,  after   CRTSYSINF   has   completed,   use
                 WRKJOBSCDE  JOB(CAPSYSINF) and  modify the  scheduling
                 parameters.

   TIME          The  time of  day to  run CAPSYSINF.   The  default is
                 000000 or  midnight.   A  valid time  of day  must  be
                 entered.

                 CAPSYSINF  requires significant  system  resources  to
                 run and should be run in a non-peak period.

   OBJECTS       A   *YES/*NO   parameter   for  whether   to   collect
                 information  on objects.   The value is  placed on the
                 job schedule entry for the CAPSYSINF command.

                 *YES is  the  default which  will cause  CAPSYSINF  to
                 use    DSPOBJD   OBJ(*ALL/*ALL)    to   collect    the
                 information.

                 *NO  may  be  specified to  bypass  the  collection of
                 object information.

   MEMBERS       A  *YES/*NO   parameter   for   whether   to   collect
                 information on  members.  The  value is placed  on the
                 job schedule entry for the CAPSYSINF command.

                 *YES  is the default  to cause CAPSYSINF  to use CVTFD
                 FILE(*ALL/*ALL)    TYPE(*MBR)    to    collect     the
                 information.

                 *NO  may be  specified  to  bypass the  collection  of
                 member information.

   IFS           Whether to  collect information for IFS  objects.  The
                 value  is  placed on  the job  schedule entry  for the
                 CAPSYSINF command.

                 Each  IFS  object that  is  converted  requires  about
                 6000  bytes.   This  allows  for  the  full path  name
                 along  with other information.   Because  of the large
                 space  required,  the  IFS(*IFSLST)  function  may  be
                 desirable  to use  so that  only  the directories  you
                 are  interested  in are  converted.    See the  IFSLST
                 tool.

                 *HOME  is  the  default  to  cause  CAPSYSINF  to  use
                 CVTIFS  OBJ('/home') to  collect  the IFS  information
                 in the home directory and sub-directories.

                 *IFSLST may  be specified along  with a file  named in
                 the  IFSLST parameter.   The  file must  be created by
                 the  CRTIFSLST  command  and  the  directories  to  be
                 converted  entered by  the  WRKIFSLST  command.   Only
                 those  directories   found  in  the  file  (and  their
                 subdirectories) will be converted.

                 *ALL may be  specified to  collect information on  all
                 IFS  objects except  those  in  the QSYS.LIB  or  QDLS
                 directories.   These directories  are excluded because
                 corresponding entries exist for objects in QSYS.

                 *NO may be specified to  bypass the collection of  IFS
                 information.

   SYSINFLIB     The  library  to  contain  the   files  that  will  be
                 created by CAPSYSINF.  The default is TAASYSINF.

   AUT           The  authority to  the library  you  named in  the LIB
                 parameter.    The default  is  *PUBLIC *EXCLUDE.   Use
                 EDTOBJAUT  OBJ(xxx)   OBJTYPE(*LIB)  to  add   trusted
                 users.

   IFSLST        If  OBJ(*IFSLST) is  specified,  the IFSLST  parameter
                 must   name  a  file   created  by   CRTIFSLST.    The
                 WRKIFSLST command is used  to enter directory  records
                 into the file.

CAPSYSINF command parameters                          *CMD
----------------------------

   OBJECTS       A *DFT/*YES/*NO  parameter for whether to  capture the
                 information for objects.

                 *DFT  is the  default to  cause the  use of  the value
                 specified on CRTSYSINF  as stored  in the  Application
                 Value CAPSYSINF in TAASECURE.

                 *YES  is   will   cause  CAPSYSINF   to  use   DSPOBJD
                 OBJ(*ALL/*ALL) to  collect the information.   The data
                 is  placed  in  the  DSPOBJD file  in  the  library of
                 files with a unique version name.

                 *NO  may be  specified  to  bypass  the  capturing  of
                 object information.

   MEMBERS       A  /*DFT/*YES/*NO  parameter  for whether  to  capture
                 the information for members.

                 *DFT  is the  default to  cause the  use of  the value
                 specified on CRTSYSINF  as stored  in the  Application
                 Value CAPSYSINF in TAASECURE.

                 *YES is  the default to  cause CAPSYSINF to  use CVTFD
                 FILE(*ALL/*ALL)     TYPE(*MBR)    to    collect    the
                 information.  The  data is  placed in  the CVTFD  file
                 in the  library of files  with a unique  version name.

                 *NO  may  be  specified  to  bypass the  capturing  of
                 member information.

   IFS           Whether  to collect information for  IFS objects.  The
                 value is  placed on  the  job schedule  entry for  the
                 CAPSYSINF command.

                 Each  IFS  object  that  is converted  requires  about
                 6000  bytes.    This allows  for  the  full  path name
                 along with other  information.   Because of the  large
                 space  required,  the  IFS(*IFSLST)  function  may  be
                 desirable  to  use so  that only  the  directories you
                 are interested  in  are  converted.   See  the  IFSLST
                 tool.

                 *DFT is  the default  to cause  the use  of the  value
                 specified  on CRTSYSINF as  stored in  the Application
                 Value CAPSYSINF in TAASECURE.

                 *HOME  may be specified cause  CAPSYSINF to use CVTIFS
                 OBJ('/home') to  collect the  IFS  information in  the
                 home directory and sub-directories.

                 *IFSLST may  be specified along  with a file  named in
                 the  IFSLST parameter.   The  file must be  created by
                 the  CRTIFSLST  command  and  the  directories  to  be
                 converted  entered by  the  WRKIFSLST  command.   Only
                 those  directories   found  in  the  file  (and  their
                 subdirectories) will be converted.

                 *ALL may be  specified to collect  information on  all
                 IFS  objects except  those  in  the QSYS.LIB  or  QDLS
                 directories.   These directories are  excluded because
                 corresponding entries exist for objects in QSYS.

                 *NO  may be specified to  bypass the collection of IFS
                 information.

   IFSLST        If OBJ(*IFSLST)  is  specified, the  IFSLST  parameter
                 must  name   a  file   created  by  CRTIFSLST.     The
                 WRKIFSLST  command is used to  enter directory records
                 into the file.

                 *DFT is the  default for  the file name  to cause  the
                 use of the  value specified on CRTSYSINF  as stored in
                 the Application Value CAPSYSINF in TAASECURE.

                 *DFT  is the  default for  the qualified  library name
                 to cause the use of  the value specified on  CRTSYSINF
                 as  stored  in  the  Application  Value  CAPSYSINF  in
                 TAASECURE.

WRKSYSINF command                                     *CMD
-----------------

No parameters exist.

RTVSYSINFD command                                    *CMD
------------------

   SYSINFLIB     The  name   of  the  library  you   specified  on  the
                 CRTSYSINF  command.    The  return  parameter  must be
                 specified as *CHAR LEN(10).

   OBJINFO       The  option   specified  on   the  CRTSYSINF   command
                 OBJECTS parameter.   The return value will  be *YES or
                 *NO.    The  return  parameter  must  be  specified as
                 *CHAR LEN(4).

   MBRINFO       The  option   specified  on   the  CRTSYSINF   command
                 MEMBERS parameter.   The return value will  be *YES or
                 *NO.    The  return  parameter  must  be specified  as
                 *CHAR LEN(4).

   IFSINFO       The option  specified  on the  CRTSYSINF  command  IFS
                 parameter.  The  return value will be  *HOME, *IFSLST,
                 *ALL,   or  *NO.     The  return  parameter   must  be
                 specified as *CHAR LEN(7).

   IFSLST        The  file  name  specified  on  the  CRTSYSINF command
                 IFSLST  parameter.   If  *NONE was  specified,  blanks
                 will  be  returned.    The return  parameter  must  be
                 specified as *CHAR LEN(10).

   IFSLSTL       The   qualified   library   name   specified  on   the
                 CRTSYSINF  command  IFSLST  parameter.    The   return
                 parameter must be specified as *CHAR LEN(10).

DLTSYSINF command                                     *CMD
-----------------

No parameters exist.

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

You must have  *ALLOBJ special authority to use  the CRTSYSINF command.

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

The following TAA Tools must be on your system:

     ADJVAR          Adjust variable
     CHKALLOBJ       Check *ALLOBJ special authority
     CVTDAT          Convert date
     CVTFD           Convert file description
     CVTIFS          Convert IFS
     CVTTIM          Convert time
     EDTVAR          Edit variable
     EXTLST2         Extract list
     FILEFDBCK       File feedback
     IFSLST          IFS List
     RTVDAT          Retrieve date
     RTVJOBSCDE      Retrieve job schedule entry
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

An  *ALLOBJ special  authority user  must use  CRTSYSINF to  create the
library of files and  add a job schedule  entry for the CAPSYSINF  job.

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

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

   CRTSYSINF     *CMD                   TAASYTM       QATTCMD
   WRKSYSINF     *CMD                   TAASYTM2      QATTCMD
   CAPSYSINF     *CMD                   TAASYTM3      QATTCMD
   RTVSYSINFD    *CMD                   TAASYTM4      QATTCMD
   DLTSYSINF     *CMD                   TAASYTM5      QATTCMD
   TAASYTMC      *PGM       CLP         TAASYTMC      QATTCL
   TAASYTMC2     *PGM       CLP         TAASYTMC2     QATTCL
   TAASYTMC3     *PGM       CLP         TAASYTMC3     QATTCL
   TAASYTMC4     *PGM       CLP         TAASYTMC4     QATTCL
   TAASYTMC5     *PGM       CLP         TAASYTMC5     QATTCL
   TAASYTMC12    *PGM       CLP         TAASYTMC12    QATTCL
   TAASYTMC13    *PGM       CLP         TAASYTMC13    QATTCL
   TAASYTMC14    *PGM       CLP         TAASYTMC14    QATTCL
   TAASYTMC15    *PGM       CLP         TAASYTMC15    QATTCL
   TAASYTMR2     *PGM       RPG         TAASYTMR2     QATTRPG
   TAASYTMR3     *PGM       RPG         TAASYTMR3     QATTRPG
   TAASYTMR21    *PGM       RPG         TAASYTMR21    QATTRPG
   TAASYTMR22    *PGM       RPG         TAASYTMR22    QATTRPG
   TAASYTMR23    *PGM       RPG         TAASYTMR23    QATTRPG
   TAASYTMD      *FILE      DSPF        TAASYTMD      QATTDDS
   TAASYTME      *FILE      DSPF        TAASYTME      QATTDDS
   TAASYTML      *FILE      LF          TAASYTML      QATTDDS
   TAASYTMP      *FILE      PF          TAASYTMP      QATTDDS
   TAASYTMQ      *FILE      PF          TAASYTMQ      QATTDDS
   TAASYTMS      *FILE      PF          TAASYTMS      QATTDDS

The CAPSYSINF Application Value (*USRSPC) exists in TAASECURE.

Structure
---------

CRTSYSINF   Cmd
   TAASYTMC   CL pgm

WRKSYSINF   Cmd
   TAASYTMC2   CL pgm
     TAASYTMR2   RPG Pgm
       TAASYTMC13   CL pgm RMVM from first display
       TAASYTMC14   CL pgm to refresh MBRLSTP in QTEMP
       TAASYTMD    Display file
       TAASYTMR3    RPG pgm to display members
         TAASYTME    Display file
         TAASYTMC12   CL pgm RMVM from second display
         TAASYTMC14   CL pgm to refresh MBRLSTP in QTEMP
         TAASYTMC15   CL pgm to prompt for CPY commands

CAPSYSINF   Cmd
   TAASYTMC3  CL pgm
      TAASYTMR21  RPG pgm to update TAASYTMP with mbr name in ODPGP
      TAASYTMR22  RPG pgm to update TAASYTMQ with mbr name in MBFMSL
      TAASYTMR23  RPG pgm to update TAASYTMS with mbr name in IFPGRP

RTVSYSINFD  Cmd
   TAASYTMC4  CL pgm

DLTSYSINF   Cmd
   TAASYTMC5  CL pgm

File summary
------------

      File         Description                 Model file
      ----         -----------                 ----------

      TAASYTMP     CAPSYSINF version of DSPOBJD   QADSPOBJ
      TAASYTML     LF over TAASYTMP for *LIB      QADSPOBJ
      TAASYTMQ     CAPSYSINF version of CVTFD     TAADBKHU
      TAASYTMY     PF Keyed vers of TAADBKHU      TAADBKHU
      TAASYTMS     CAPSYSINF version of TAAIFSAT  TAAIFSAT
      TAASYTMT     Member list - key on mbr       QAFDMBRL
					

Added to TAA Productivity tools June 1, 2005


Home Page Up to Top