The Update Message File command uses the MSGFP outfile created from
the TAA CVTMSGF command to update the message descriptions in a
message file. UPDMSGF allows you to keep a data base file of
messages or update selected messages on the same or another system.
A typical command would be:
UPDMSGF MSGF(xxx) MSGFPLIB(yyy)
The MSGFPLIB parameter describes the library where the MSGFP file
exists. The file must have been created by the CVTMSGF command. By
default, all message descriptions in the MSGFP file would be checked
to see if they exist in the specified message file. Non-existing
message descriptions would be added. Existing message descriptions
would be changed. A spooled file is output with the results.
Options exist such as specifying the message IDs to be updated and to
'add only' or 'change only'.
The user must have *CHANGE authority to the message file.
CVTMSGF has some restrictions (see the tool documentation).
LVL parameter
-------------
The LVL parameter on ADDMSGD used when adding a new message
description is not converted from the CVTMSGF outfile. The default
of *CURRENT is used.
UPDMSGF escape messages you can monitor for
-------------------------------------------
TAA9891 The command failed. See messages and spooled file
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
MSGF The qualified name of the message file to be
updated. The library value defaults to *LIBL.
*CURLIB may also be used.
A message file created by a user profile name of
*IBM, QLPINSTALL, or *TIVOLI cannot be used.
MSGID A list of up to 300 message IDs or generic IDs to be
updated. The default is *ALL for all message IDs
found in the MSGFP file.
Providing a list of message IDs allows you to update
a specific set of message descriptions. A generic
range such as USR85* could be entered to add or
change any message descriptions in the range of
USR85AA to USR8599.
MSGFPLIB The library containing the MSGFP file with the
message descriptions to update with. The file must
have been created by the CVTMSGF TAA command.
ADD A *YES/*NO parameter for whether message
descriptions which do not exist in the message file
will be added. *YES is the default.
*NO may be specified to prevent adding new
descriptions.
CHANGE A *YES/*NO parameter for whether message
descriptions which exist in the message file will be
changed. *YES is the default.
*NO may be specified to prevent changing existing
descriptions.
Restrictions
------------
UPDMSGF only updates the message description attributes in the
outfile created by CVTMSGF. The LVL value from the outfile is not
used. CVTMSGF has some minor restrictions.
The user must have *CHANGE authority to the message file to be
updated.
A message file created by a user profile name of *IBM, QLPINSTALL, or
*TIVOLI cannot be used.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKAPOST Check apostrophe
CHKGENERC Check generic
CHKOBJ3 Check object 3
CVTMSGF Convert message file
EDTVAR Edit variable
EXTLST Extract list
EXTLST2 Extract list 2
RSNLSTMSG Resend last message
RTVFMT Retrieve data base format
RTVMSGD Retrieve message description
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic 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
------ ---- --------- ---------- ----------
UPDMSGF *CMD TAAMSIN QATTCMD
TAAMSINC *PGM CLP TAAMSINC QATTCL
TAAMSINR *PGM RPG TAAMSINR QATTRPG
|
