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