The Capture PTF Information tool allows you to periodically capture
PTF information using the outfile from the system DSPPTF command.
Each captured version becomes a separate member in the PTFINFP data
base file. The CMPPTFINF command may then be used to compare the
changes between different versions.
The tool as shipped is English language dependent. See the section
on 'Changing English constants' if required.
You must be authorized to the system DSPPTF command to use the tool
commands.
Assume you had captured the PTF information on different days and now
want to compare the first version with the last version. You would
specify:
CMPPTFINF FROMVER(*FIRST) TOVER(*LAST)
A listing would be displayed with the comparisons by PTF ID. Two
passes occur of the data. The first pass would read the From version
and compare by PTF ID to the To version. Differences would be noted.
The second pass would read the To version and flag the PTF if the
corresponding PTF does not exist in the From version. Summary
information is output.
Options exist to reduce the amount of output.
** Bypass Cover letter only. This will bypass any PTFs which
have a status of 'Cover letter only'.
** Bypass same Temporarily applied status. This will bypass any
PTFs where the 'Temporarily applied' status exists in both
versions.
** Bypass same Permanently applied status. This will bypass any
PTFs where the 'Permanently applied' status exists in both
versions.
** Bypass Temporary to Permanent. This will bypass any
'Temporarily applied' PTFs in the From version that have a
corresponding value of 'Permanently applied' in the To
version.
** Bypass Superseded. This will bypass any 'Superseded' PTFs in
the To file.
Commands provided
-----------------
CRTPTFINF Creates the file used to hold the versions
DLTPTFINF Deletes the file used to hold the versions
CAPPTFINF Captures the current PTF information
CMPPTFINF Compares two PTF versions
Use WRKMBRS to remove members that are no longer needed.
Getting started
---------------
** You must be authorized to the system DSPPTF command to use
CRTPTFINF or CAPPTFINF.
** Determine the library to hold the PTF versions and prompt for:
CRTPTFINF
Enter the library name to hold the versions. The PTFINFP file
will be created in the specified library.
** Capture a PTF version
CAPPTFINF PTFINFLIB(xxx)
A new member is added to the PTFINFP library.
** Use DSPMBRS to review the member heading information.
DSPMBRS FILE(PTFINFP)
Each member is given the name PTFcyymmdd. The member text
description contains the date added in job format. Only one
member a day may be added.
** You must wait until you (or automatic updates from the system)
have added or changed PTFs before doing CAPPTFINF for another
version. Assuming you have added new PTFs a few days later,
enter:
CAPPTFINF PTFINFLIB(xxx)
This adds another version.
** To make a comparison, you must either know the member names of
the versions or use one of the special values for the member
parameter. The CMPPTFINF command defaults to 'net' the
changes. Prompt for the command:
CMPPTFINF
and enter the required member names, options, and PTFINFP
library required. Either a display or spooled file will be
output depending on the OUTPUT parameter.
Note that entering:
CMPPTFINF
defaults to compare the *FIRST version with the last version.
If you specified:
CMPPTFINF FROMVER(*PREV)
you would compare the version added before the last version to
the last version.
Regular use of CAPPTFINF
------------------------
The CAPPTFINF tool is only of advantage if you have something to
compare against. For simple use, a job scheduling job could be setup
to run the CAPPTFINF command at least once a week.
Cleaning up old versions
------------------------
Use the WRKMBRS command to display the existing versions and the
'RMV' option to remove members that are no longer needed.
Changing English constants
--------------------------
If you have a lower case English language version of the operating
system, you do not need to change anything. The supplied constants
will operate correctly.
If you do not have a lower case English language version, do DSPPTF
and check the spelling of the data in the PTF status field. If you
see spellings of:
Temporarily applied
Permanently applied
Superseded
Cover letter only
you do not have to do anything as the shipped code will function
properly.
If your language differs (or you have an upper case only English
language version), you must change the constants that are stored in
the data area CAPPTFINF in TAASECURE. These constants are used
within the CMPPTFINF program for the BYPxxx options.
As an *ALLOBJ special authority user, enter:
EDTDTAARA2 DTAARA(TAASECURE/CAPPTFINF)
The spelling of the constants must match what you see in the output
of DSPPTF (If you cannot find the corresponding spelling, position
the cursor to the 'Status' field and press Help).
Note that the constants are only used for the command options. The
two summary tables that are output at the end of the listing do not
use these constants, but rely instead on the data found in the DSPPTF
outfile.
CAPPTFINF escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
CRTPTFINF Command parameters *CMD
----------------------------
PTFINFLIB The library where the PTFINFP file will be created.
SRCLIB The source library to use for the QATTDDS file
source. The default is *TAAARC meaning the TAA
Archive.
A specific user library may be named, but the source
file name must be QATTDDS.
AUT The authority to the PTFINFP physical file for the
*PUBLIC user.
*USE is the default.
*CHANGE or *EXCLUDE may be specified.
DLTPTFINF Command parameters *CMD
----------------------------
PTFINFLIB The library where the PTFINFP file exists. The
default is *LIBL. *CURLIB or a specific library may
be entered.
CAPPTFINF Command parameters *CMD
----------------------------
PTFINFLIB The library where the PTFINFP file exists. The
default is *LIBL. *CURLIB or a specific library may
be entered.
CMPPTFINF Command parameters *CMD
----------------------------
FROMVER The member name of the From version to compare.
*FIRST is the default meaning the first member in
the file (the earliest date added).
*PREV may be entered to mean the member added prior
to the last member.
A specific member name may be entered (use DSPMBRS
of the PTFINFP file to help determine the member
names).
TOVER The member name of the To version to compare.
*LAST is the default meaning the last member in the
file (the most current date added).
*PREV may be entered to mean the member added prior
to the last member.
A specific member name may be entered (use DSPMBRS
of the PTFINFP file to help determine the member
names).
BYPCOVLTR A *YES/*NO value for whether PTFs with a status of
'Cover letter only' will be bypassed.
*YES is the default.
*NO may be specified to list these PTFs.
BYPSAMTEMP A *YES/*NO value for whether the PTFs will be
bypassed that have a status of 'Temporarily applied'
in both versions.
*YES is the default.
*NO may be specified to list these PTFs.
BYPSAMPERM A *YES/*NO value for whether the PTFs will be
bypassed that have a status of 'Permanently applied'
in both versions.
*YES is the default.
*NO may be specified to list these PTFs.
BYPPERM A *YES/*NO value for whether the PTFs that are
'Temporarily applied' in the From version and
'Permanently applied' in the To version should be
bypassed.
*YES is the default to bypass this condition.
*NO may be specified to include this condition.
BYPSPRCED A *YES/*NO value for whether the PTFs that are
'Superseded' in the To version should be bypassed.
*YES is the default to bypass this condition
regardless of what the value is in the From version.
*NO may be specified to include this condition.
PTFINFLIB The library where the PTFINFP file exists. The
default is *LIBL. *CURLIB or a specific library may
be entered.
OUTPUT How to output the results. * is the default to
display the CMPPTFINF 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.
Restrictions
------------
You must be authorized to the system DSPPTF command to use CRTPTFINF
or CAPPTFINF.
Prerequisites
-------------
The following TAA Tools must be on your system:
EDTVAR Edit variable
RTVDAT Retrieve date
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape 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
------ ---- --------- ---------- ----------
CRTPTFINF *CMD TAAPTFB QATTCMD
DLTPTFINF *CMD TAAPTFB2 QATTCMD
CAPPTFINF *CMD TAAPTFB3 QATTCMD
CMPPTFINF *CMD TAAPTFB4 QATTCMD
TAAPTFBC *PGM CLP TAAPTFBC QATTCL
TAAPTFBC2 *PGM CLP TAAPTFBC2 QATTCL
TAAPTFBC3 *PGM CLP TAAPTFBC3 QATTCL
TAAPTFBC4 *PGM CLP TAAPTFBC4 QATTCL
TAAPTFBC14 *PGM CLP TAAPTFBC14 QATTCL
TAAPTFBC15 *PGM CLP TAAPTFBC15 QATTCL
TAAPTFBR4 *PGM RPG TAAPTFBR4 QATTRPG
Structure
---------
CRTPTFINF Cmd
TAAPTFBC CL pgm
DLTPTFINF Cmd
TAAPTFBC2 CL pgm
CAPPTFINF Cmd
TAAPTFBC3 CL pgm
CMPPTFINF Cmd
TAAPTFBC4 CL pgm
TAAPTFBC14 CL pgm - Accesses language constants
TAAPTFBR4 RPG pgm
TAAPTFBC15 CL pgm - Accesses product descriptions
|
