TAA Tools
CAPPTFINF       CAPTURE PTF INFORMATION                TAAPTFB

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
					

Added to TAA Productivity tools July 15, 2006


Home Page Up to Top