TAA Tools
CPYSYSINF       COPY SYSTEM INFORMATION                 TAASYTN

The  CPYSYSINF tool  copies  the  information  from the  files  in  the
library you  named for CRTSYSINF  that were created by  CAPSYSINF.  The
files  (if all  defaults were  taken) contain  object, member,  and IFS
information from each use  of CAPSYSINF.  Various selection  capability
exists on the CPY commands.

The purpose  of CPYSYSINF  is to allow  you to subset  the full  set of
data  captured by CAPSYSINF to allow  unique processing or comparisons.

Three different  copy  commands  allow  copying  information  from  the
files in the library used for CAPSYSINF.

         CPYSYSINFO     Object information from DSPOBJD
         CPYSYSINFM     Member information from CVTFD
         CPYSYSINFI     IFS information from IFSDIRT

A typical command to copy object information would be:

             CPYSYSINFO   TOFILE(xxx/DSPOBJD) LIB(ABC) CRTFILE(*YES)

All  the information  from the  objects  captured from  library ABC  by
CAPSYSINF  would  be  copied  to  the  file  DSPOBJD in  the  specified
library.

Note that the objects  in library ABC are  not used by CPYSYSINFO,  but
rather  the information  stored  in the  DSPOBJD  file as  captured  by
CAPSYSINF.   The library  is specified on  the CRTSYSINF command.   The
DSPOBJD  file would  be created.   Selection can be  performed on other
values such  as the  multiple or  generic libraries,  the object  type,
the object attribute, or the object name.

Copy commands provided
----------------------

   CPYSYSINFO    CPYSYSINFO  may  be  used  to copy  records  from  the
                 DSPOBJD  file in  the  library specified  on CRTSYSINF
                 to your  own  file for  further  processing.   If  the
                 file already exists,  it must have the  same format as
                 the  current version of  the DSPOBJD  outfile with the
                 format QADSPOBJ.

                 You may use special values  for the library name  such
                 as  *NONSYS.   An  OMITLIB  parameter exists  to  omit
                 specified libraries or generic libraries.

   CPYSYSINFM    CPYSYSINFM  may  be  used  to  copy records  from  the
                 CVTFD  file in  the library specified  on CRTSYSINF to
                 your own  file for further  processing.   If the  file
                 already exists,  it must have  the same format  as the
                 current  version of the CVTFD  outfile with the format
                 TAADBKHU.

                 You may use special values  for the library name  such
                 as  *NONSYS.    A  OMITLIB parameter  exists  to  omit
                 specified libraries or generic libraries.

   CPYSYSINFI    CPYSYSINFI  may  be  used  to  copy  records from  the
                 IFSDIRT file  in  library specified  on  CRTSYSINF  to
                 your own  file for  further processing.   If the  file
                 already exists,  it must have  the same format  as the
                 current  version  of  the  IFSDIRT  outfile  with  the
                 format TAAIFSAT.

                 CAPSYSINF  allows  options  for  the   IFS  parameter.
                 *YES  will capture  all IFS  objects except  for those
                 in  the  QSYS  and  QDLS  directories.    This  avoids
                 capturing the same information  that would already  be
                 in the DSPOBJD file.

                 You  can   specify  *IFSLST  to  capture   only  those
                 directories  (and  subdirectories) found  in  the file
                 named for the IFSLST parameter.   See the IFSLST  tool
                 for how to create an IFSLST file.

CPYSYSINFx escape messages you can monitor for
----------------------------------------------

      TAA9894    No records were copied.

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

CPYSYSINFO command parameters                         *CMD
-----------------------------

   TOFILE        The qualified  file  name to  copy to.    If the  file
                 exists,  it must use  the format  of the  DSPOBJD file
                 for  the  current  release.    The  library  qualifier
                 defaults to *LIBL.  *CURLIB may be specified.

   TOMBR         The member  name to copy  to.   The default is  *FIRST
                 for  the first  member of  the  file.   If the  member
                 does  not  exist, it  will be  added  to the  file and
                 given the name  of the  member that was  used to  copy
                 from.

   LIB           The library  to select.  The  default is *ALL  for all
                 libraries.

                 Up  to 300 libraries  or generic library  names may be
                 entered.  See the  further comments about the  library
                 record (*LIB) in QSYS.

                 No  check is  made  to determine  if  a valid  library
                 exists.

                 If  the library criteria  is met,  the objects  in the
                 library  will be considered to  be copied based on the
                 other selection criteria.

                 Special values  are  supported to  allow  a copy  from
                 the  same  libraries  as   described  by  the  special
                 value.   For  example, if LIB(*USRLIBL)  is specified,
                 all  objects  from  libraries  on  the  current   user
                 portion of the  library list will be  considered to be
                 copied.

                 Note  that  the library  record  in  QSYS (*LIB  type)
                 will not be  copied when  a specific  user library  is
                 entered  or  the  special   values  *NONSYS,  *ALLUSR,
                 *ALLNONQ,  or *USRLIBL.   If *LIBL is  specified, QSYS
                 will  be  on  the  library  list  and  will  cause the
                 library records to  be considered automatically.   Use
                 the  special function  of LIB(QSYS)  and OBJTYPE(*LIB)
                 if  you   need  the  library  record  for  a  specific
                 library.

                 When a LIB  special value  is used, OBJTYPE(*LIB)  may
                 be   used,  but   must   be  the   only  object   type
                 identified.

                 You  can  copy  records  from  multiple  libraries  by
                 using special values:

                      *NONSYS  may  be  entered  to  copy  from   those
                      libraries   that   are   saved    by   a   SAVLIB
                      LIB(*NONSYS).    See   the  discussion  with  the
                      SAVLIB command.

                      *ALLUSR   may  be  entered  to  copy  from  those
                      libraries   that   are   saved   by    a   SAVLIB
                      LIB(*ALLUSR).    See   the  discussion  with  the
                      SAVLIB command.

                      *ALLNONQ  may  be  entered  to  consider  copying
                      only from  those  libraries  that  do  not  begin
                      with the letter Q.

                      *USRLIBL  may  be  entered  to  copy  from  those
                      libraries that  exist on the user  portion of the
                      library  list.     This   includes  the   current
                      library and  excludes libraries  that are in  the
                      product portion.

                      *LIBL   may  be  entered   to  copy   from  those
                      libraries  that exist on the  user portion of the
                      library list.

   LIBTYPE       The type  of library.   The  default is  *ALL for  all
                 types.

                 *PROD  may  be  specified  to  copy  only  objects  in
                 libraries  with an attribute of PROD.   If the library
                 object (or an object in  the library) is specified  as
                 a PROD type, it will be considered.

                 *TEST  may  be  specified  to  copy  only  objects  in
                 libraries with  an attribute of TEST.   If the library
                 object (or an object in  the library) is specified  as
                 a TEST type, it will be considered.

   OBJ           The object  or generic object  name to compare.   *ALL
                 is the default to compare all object names.

   OBJTYPE       The  object types to  copy.   The default is  *ALL for
                 all  types.  A  list of up  to 40 object  types may be
                 entered.

                 To see  the possible  values, prompt  for the  command
                 and use the ?  function for the parameter.

                 If  OBJTYPE(*LIB)   is  specified,   it  may   not  be
                 combined  with any other object  types.  OBJTYPE(*LIB)
                 allows the copying  of the  library object from  QSYS.
                 If *ALL  or *LIBL are  specified, the  library objects
                 are  automatically  considered  because  they  are  in
                 QSYS.

   OBJATTR       The object attribute to copy such  as RPG.  A list  of
                 up  to 10  object  attributes  may  be entered.    The
                 default is *ALL for all attributes.

                 A  specific attribute may  be entered  such as  RPG or
                 DFU.   There  is no  checking of  the validity  of the
                 attribute you enter.

   IASP          The Independent ASP  to select.   The default is  *ALL
                 for all IASPs.   A specific *IASP name  or the special
                 value *SYSBAS may be entered.

   ASP           The  number of the ASP to copy.   The default is *ALL.
                 A number in the range of 1 to 99 may be entered.

   SYSINFVER     The version in the DSPOBJD  file in the library  named
                 on CRTSYSINF.   The  default is  *CURRENT meaning  the
                 most  recently  added version  in the  file  (based on
                 the create date).  Use  WRKSYSINF to see the names  of
                 the existing versions.

   OMITLIB       A list  of up  to 300  libraries to be  omitted.   The
                 default  is  *NONE.    Either  a specific  library  or
                 generic  library  name may  be entered.   There  is no
                 check to  that the  library exists or  to ensure  that
                 it is  included.  For example, if  you include library
                 A and B and omit library C, no error occurs.

   CRTFILE       A  *YES/*NO parameter for  whether the  file should be
                 created if  it does  not exist.   *NO  is the  default
                 meaning  that   your  version  of  the   file  already
                 exists.   The  level  ID of  the file  must  match the
                 current system level  ID of  the QADSPOBJ  file or  an
                 error will occur.

                 *YES may be specified to create the file.

   REPLACE       A *YES/*NO parameter  for whether to replace  the data
                 in  an  existing  member.    *YES  is the  default  to
                 replace the data.

                 *NO may be specified to add to the existing data.

CPYSYSINFM command parameters                         *CMD
-----------------------------

   TOFILE        The  qualified  file name  to copy  to.   If  the file
                 exists, it must use  the format as the TAADBKHU  model
                 file  in  TAATOOL  as  used  by CVTFD.    The  library
                 qualifier   defaults  to   *LIBL.    *CURLIB   may  be
                 specified.

   TOMBR         The member name  to copy  to.  The  default is  *FIRST
                 for  the first  member of  the  file.   If the  member
                 does  not exist,  it  will be  added to  the  file and
                 given the name  of the  member that was  used to  copy
                 from.

   LIB           The library to  select.  The  default is *ALL  for all
                 libraries.

                 Up to  300 libraries or  generic library names  may be
                 entered.

                 If  the library  criteria is  met, the  members in the
                 library will be considered  to be copied based  on the
                 other selection criteria.

                 Special  values  are  supported  to allow  a  copy  of
                 members  from  the  same  libraries  as  described  by
                 special values.    For example,  if  LIB(*USRLIBL)  is
                 specified, all  members from libraries on  the current
                 user  portion of the  library list  will be considered
                 to be copied.

                 *NONSYS  may   be  entered   to  copy   members   from
                 libraries that  are  saved by  a SAVLIB  LIB(*NONSYS).
                 See the  SAVLIB command for what  libraries are saved.

                 *ALLUSR   may   be  entered   to  copy   members  from
                 libraries that  are saved  by  a SAVLIB  LIB(*ALLUSR).
                 See the  SAVLIB command for what  libraries are saved.

                 *ALLNONQ   may  be   entered  to  copy   members  from
                 libraries that do not begin with the letter Q.

                 *USRLIBL  may  be   entered  to   copy  members   from
                 libraries  that  exist  on  the user  portion  of  the
                 library  list.  This includes  the current library and
                 excludes libraries that  are in  the product  portion.

                 *LIBL may  be entered to  copy members  from libraries
                 that exist  on the user  portion of the  library list.

   FILE          The  file or generic  file name to  copy.  The default
                 is *ALL.

   FILETYPE      The file type  to copy.  The  default is *ALL for  all
                 types.

                 Use *PF for physical files.

                 Use *LF for logical files).

   DATATYPE      The data  type to copy.   The default is *ALL  for all
                 types.

                 Use *DATA for data files.

                 Use *SRC for source files.

   MBR           The  member to  be copied.   The  default is  *ALL for
                 all members.

                 A specific  member or  a generic  member  name may  be
                 entered.

   IASP          The Independent  ASP to select.   The default  is *ALL
                 for all  IASPs.  A specific *IASP  name or the special
                 value *SYSBAS may be entered.

   ASP           The number of the ASP to  copy.  The default is  *ALL.
                 A number in the range of 1 to 99 may be entered.

   SYSINFVER     The version  in the  CVTFD file  in the library  named
                 on  CRTSYSINF.   The default  is *CURRENT  meaning the
                 most  recently  added version  in  the file  (based on
                 the create date).   Use WRKSYSINF to see the  names of
                 the existing versions.

   OMITLIB       A  list of up  to 300  libraries to  be omitted.   The
                 default  is  *NONE.    Either  a  specific  library or
                 generic library  name may  be entered.    There is  no
                 check to ensure  that the library exists  or to ensure
                 that  it  would  be included.    For  example, if  you
                 include library A and B  and omit library C, no  error
                 occurs.

   CRTFILE       A *YES/*NO  parameter for whether  the file  should be
                 created if it does not exist.

                 *NO is  the default meaning  that your version  of the
                 file  already exists.   If *NO is  specified, the file
                 must have the format  level ID of the  current version
                 of  the TAADBKHP  model  file in  TAATOOL  as used  by
                 CVTFD.

                 *YES may be specified to create the file.

   REPLACE       A  *YES/*NO parameter for whether  to replace the data
                 in an  existing  member.    *YES  is  the  default  to
                 replace the data.

                 *NO may be specified to add to the existing data.

CPYSYSINFI command parameters                         *CMD
-----------------------------

   TOFILE        The  qualified file  name to  copy  to.   If the  file
                 exists, it  must use the format  of the TAAIFSAP model
                 file in TAATOOL.   The library  qualifier defaults  to
                 *LIBL.  *CURLIB may be specified.

   TOMBR         The member  name to copy  to.   The default is  *FIRST
                 for  the first  member  of the  file.   If  the member
                 does  not  exist, it  will be  added  to the  file and
                 given the  name of the  member that  was used to  copy
                 from.

   DIR           The directory to be copied.  The default is *ALL.

                 A specific directory name may be entered.

   IFSTYP        The  type of  IFS object  to select.   The  default is
                 *ALL for all types.

                 A  list of up to  10 types may be  entered from a list
                 of *CHRSF,  *DDIR,  *DIR, *FLR,  *SOCKET,  *STMF,  and
                 *SYMLNK.

   OMITOWN       A list of  up to 50 owner names that  will be omitted.
                 The default is *NONE.

                 Because  the  IFS  contains  a  significant number  of
                 system owned objects,  you may want  to omit them  for
                 your   processing.     You   may   convert   specified
                 directories  by  using  the IFS(*IFSLST)  function  on
                 CAPSYSINF.  See the IFSLST tool also.

                 The  special value *QNAMES will  omit all objects that
                 are  owned  by  a  user  profile  beginning  with  the
                 letter Q.

                 You  may  enter  a  specific  list  of  owners  to  be
                 omitted.   Typical owner names to  omit would be QSYS,
                 QTCP, QDIRSRV, etc.

   SYSINFVER     The version in the IFSDIRT  file in the library  named
                 on CRTSYSINF.   The  default is  *CURRENT meaning  the
                 most  recently  added version  in the  file  (based on
                 the create date).  Use  WRKSYSINF to see the names  of
                 the existing versions.

   CRTFILE       A *YES/*NO  parameter for whether  the file  should be
                 created  if it  does not  exist.   *NO is  the default
                 meaning   that  your  version   of  the  file  already
                 exists.

                 *YES may be specified to create the file.

   REPLACE       A *YES/*NO parameter for  whether to replace the  data
                 in  an  existing  member.    *YES is  the  default  to
                 replace the data.

                 *NO may be specified to add to the existing data.

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

You   must  have   specified  the   CAPSYSINF  for   the  corresponding
information required on  the CPYSYSINFx command.   For example, if  you
specified  OBJECTS(*NO) on  CAPSYSINF,  you cannot  use the  CPYSYSINFO
command.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CVTTIM          Convert time
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVALLUSR       Retrieve *ALLUSR
     RTVCURMBR       Retrieve current member
     CVTTIM          Convert time
     RTVDAT          Retrieve date
     RTVFMT          Retrieve format
     RTVLIBL         Retrieve library list
     RTVNONSYS       Retrieve *NONSYS libraries
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None.

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

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

   CPYSYSINFO    *CMD                   TAASYTN       QATTCMD
   CPYSYSINFM    *CMD                   TAASYTN2      QATTCMD
   CPYSYSINFI    *CMD                   TAASYTN3      QATTCMD
   TAASYTNC      *PGM       CLP         TAASYTNC      QATTCL
   TAASYTNC2     *PGM       CLP         TAASYTNC2     QATTCL
   TAASYTNC3     *PGM       CLP         TAASYTNC3     QATTCL
   TAASYTNR      *PGM       RPG         TAASYTNR      QATTRPG
   TAASYTNR2     *PGM       RPG         TAASYTNR2     QATTRPG
   TAASYTNR3     *PGM       RPG         TAASYTNR3     QATTRPG
   TAASYTNR11    *PGM       RPG         TAASYTNR11    QATTRPG

Structure
---------

CPYSYSINFO  Cmd
   TAASYTNC   CL pgm
     TAASYTNR   RPG pgm
       TAASYTNR11  RPG pgm

CPYSYSINFM  Cmd
   TAASYTNC2  CL pgm
     TAASYTNR2  RPG pgm

CPYSYSINFI  Cmd
   TAASYTNC3  CL pgm
     TAASYTNR3  RPG pgm
					

Added to TAA Productivity tools June 1, 2005


Home Page Up to Top