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
|