TAA Tools
UPDPFILE2       UPDATE PFILE 2                         TAADBNQ

The Update PFILE 2  command updates one or more LF  source type members
to  change  the PFILE  keyword  to  a library  qualified  value.   This
allows  the source  to be  changed to  indicate that  the LF  should be
built over a PF in a  specific library.  If the existing  physical file
is  on the  library list,  attempting to  create the  new  logical file
over  a copy  of the  physical can  often result  in the  logical being
built over the wrong physical file.

LF38  type  members  are  not  changed  nor  are  source  members  with
multiple PFILE  keywords.  The entire  PFILE keyword must  be contained
in a single source statement.

Assume you  have a data base structure with a  physical and one or more
logical files in  library ABC  along with a  QDDSSRC file  in the  same
library with the  corresponding source.   You want to create  a similar
structure in library DEF.

You begin  by creating a QDDSSRC  file in DEF and then  copying the DDS
source  for the file structure to  the new source file (CPYGENSRC could
be used).

Then use UPDPFILE2 to  change the LF source  to use a PFILE  keyword of
PFILE(DEF/file).

             UPDPFILE   LIBQLF(DEF) SRCMBR(*ALL)
                          SRCFILE(DEF/QDDSSRC)

Only LF  type source members would  be searched for in  the named file.
If  found, the  PFILE  keyword would  be scanned  for.   If  found, the
library qualifier would be added.  If the original PFILE keyword was:

              PFILE(FILEA)

It would be changed to:

              PFILE(DEF/FILEA)

Requirements
------------

The logical file source must have a single PFILE keyword.

The PFILE keyword  must begin in  position 45 of  the source  statement
and be the only keyword on the source statement.

Valid syntax must exist.

LF38 type  logical files  are not supported.   If  any exist,  they are
bypassed.

UPDPFILE2 escape messages you can monitor for
---------------------------------------------

      TAA9891    No LF source members were found
      TAA9892    Errors occurred.  See diagnostic messages.

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

UPDPFILE2 Command parameters                          *CMD
----------------------------

   LIBQLF        The library qualifier to be used.

   SRCMBR        The  source  member  to be  changed.    A specific  or
                 generic name may  be used or  the special value  *ALL.

   SRCFILE       The  source  file  to be  changed.    The  default  is
                 QDDSSRC.   The  library qualifier  defaults  to *LIBL.
                 A  specific library may be  named or the special value
                 *CURLIB.


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

See the section on Requirements.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTMBRLST       Convert member list
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     UPDPFILE        Update PFILE

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

None, the tool is ready to use.

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

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

   UPDPFILE2     *CMD                   TAADBNQ       QATTCMD
   TAADBNQC      *PGM       CLP         TAADBNQC      QATTCL
   TAADBNQR      *PGM       RPG         TAADBNQR      QATTRPG
					

Added to TAA Productivity tools January 15, 2013


Home Page Up to Top