TAA Tools
UPDMSGF         UPDATE MESSAGE FILE                    TAAMBRI

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
					

Added to TAA Productivity tools March 31, 2004


Home Page Up to Top