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
|