TAA Tools
FIXHLPRCD       FIX HELP RECORD                        TAASRDB

The Fix  Help Record command  is designed for  the situation where  you
have  HLPRCD keywords  in  a file  (they  refer to  help  formats which
exist  in  a file)  and you  want to  have  all the  help formats  in a
different file.

For example, assume you  have all the HLPRCD keywords  referencing help
formats in the same  file and you want to move all  the help formats to
a  different file.   SEU will let  you copy the formats  to a different
file and it is easy to delete  blocks of records in SEU.  However,  you
must now change  all of the HLPRCD  keywords to refer to  the file with
the help formats.

FIXHLPRCD  will do  it  automatically for  you.   The  only significant
requirement is that  you have the  HLPRCD keyword as  the only  keyword
in  the  keyword   area  for  a  single  DDS   statement  (continuation
statements are valid for the format and file name).

To change  all of the  HLPRCD keywords so that  they reference HELPFILE
as the file, you would specify:

      FIXHLPRCD    MBR(xxx) SRCFILE(yyy)
                     HLPRCDFILE(HELPFILE)

FIXHLPRCD  would copy  the source  to a  temporary file and  modify the
HLPRCD keywords  for  the new  file.   If no  errors  had occurred,  it
would copy the new source back and replace the existing source.

If an  error occurs, it  is noted along  with the statement  number and
an escape message is sent.  The original source is not changed.

You  can use a qualified  name for the Help  file.  If  you have a help
file name specified  and want  the formats  in the same  file, you  can
use the special value *NONE to remove any file.

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

   MBR           The source member  to be checked for  HLPRCD keywords.

   FILE          The  qualified  file name  of  the source  file.   The
                 library value defaults to *LIBL.

   HLPRCDFILE    The qualified name of  the display file that  contains
                 the help  formats.   The  special value  *NONE can  be
                 used  in which case  any existing  file names  will be
                 dropped.

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

The  HLPRCD  keyword  cannot  have  any  other  keywords  on  the  same
statement.

Valid syntax must  exist for the  HLPRCD keyword (e.g.   followed by  a
left parenthesis,  closed with  a right parenthesis  etc).  If  not, an
error message  will most likely be sent.   In some cases it is possible
for unpredictable results to occur.

The HLPRCD keyword cannot exist  in a continuation record.  The  format
and/or file name can be in a continuation record.

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

The following TAA Tools must be on your system:

     EDTVAR       Edit variable
     FILEFDBCK    File feedback data structure
     HLRMVMSG     HLL Remove message
     RTVDAT       Retrieve date
     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
   ------        ----    ---------      ----------    ----------

   FIXHLPRCD     *CMD                   TAASRDB       QATTCMD
   TAASRDBC      *PGM       CLP         TAASRDBC      QATTCL
   TAASRDBR      *PGM       RPG         TAASRDBR      QATTRPG
					

Added to TAA Productivity tools May 1, 1996


Home Page Up to Top