TAA Tools
RPLGENDSPF      REPLACE GENERIC DISPLAY FILES          TAADSPH

The Replace  Generic Display  Files command  allows the re-creation  of
generic  display files  or all  display files  in a  library.   The TAA
Tool  RPLDSPF is  used to  re-create each  display file.   It retrieves
many  of  the existing  attributes  from  the  display  file  and  then
re-creates with  the current attributes.   By default, the  same source
member and file are used.

A typical command would be:

            RPLGENDSPF   FILE(LIBA/XXX*)

The  XXX  display  files would  be  found  in LIBA  and  each  would be
re-created using the  source member name and  file that was  originally
used  to create  the  display  file.   A  spooled  file describes  each
display file found and whether the create was successful or not.

By  default, the owner remains  the same.  Options  exist to change the
owner and use a different source file.

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

   FILE          The  generic  name   of  the  display   files  to   be
                 re-created  or  *ALL  for all  display  files  in  the
                 library.  The library qualifier must be specified.

   SRCFILE       The  qualified name  of the  source  file to  be used.
                 The  default is *OBJD meaning to  use the same file as
                 is specified  in  the object  description (the  source
                 file originally used) of each display file.

   OWNER         Who  should  be the  owner  of  the  new display  file
                 object.    The  default  is  *SAME,  meaning the  same
                 owner will exist.  The  user of the command must  have
                 *ALLOBJ authority  to change  the owner  name back  to
                 the original owner.

                 *NEW  may  be  specified  to  allow  the user  of  the
                 command to  become  the  owner of  the  display  file.
                 The  user  of  the command  must  have  the  *OBJEXIST
                 right  to the existing  display file to  specify *NEW.

   DLTSPLF       A  *YES/*NO  parameter  for whether  the  spooled file
                 for any  compiler  listing should  be deleted  if  the
                 create  is successful.    *NO is  default meaning  the
                 spooled files are always retained.

                 *YES  may be specified to delete  any spooled files if
                 the create is successful.

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

The RPLDSPF command used to re-create has some restrictions.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ authority
     RPLDSPF         Replace display file
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     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
   ------        ----    ---------      ----------    ----------

   RPLGENDSPF    *CMD                   TAADSPH       QATTCMD
   TAADSPHC      *PGM       CLP         TAADSPHC      QATTCL
   TAADSPHR      *PGM       RPG         TAADSPHR      QATTRPG
					

Added to TAA Productivity tools August 1, 1997


Home Page Up to Top