TAA Tools
CHGSYSTXT       CHANGE SYSTEM LIBRARY TEXT             TAALIDC

The Change  System Library  Text command  allows the text  descriptions
of certain  system libraries to be changed to  the system supplied text
value  as seen with GO LICPGM.   Many system libraries are shipped with
blank text  descriptions.    The default  provides  a listing  of  what
would be  changed.  Other library  text descriptions such  as QDSNX may
be optionally changed to English text.

You must have *ALLOBJ special authority to use CHGSYSTXT.

A typical command would be:

            CHGSYSTXT     ACTION(*TEST) OTHERLIB(*YES)

The  DSPSFWRSC command  is run  internally to create  an outfile.   The
outfile has  records for  library names  and message  IDs for  messages
which  contain the  text used  by GO  LICPGM.   The OTHERLIB  parameter
(defaults to  *YES) specifies whether you want  to also change the text
for system  libraries that  are not  in the  DSPSFWRSC outfile.    This
includes such libraries as QDSNX and QDIRSRV2.

A listing would be output of the proposed text descriptions.

If you want to change the text descriptions, enter:

            CHGSYSTXT     ACTION(*UPDATE)

The same  libraries that were  on the  listing for ACTION(*TEST)  would
be changed.

The  first time  CHGSYSTXT  is  used (or  the  first time  after  a new
system  release is installed), the existing  text descriptions of the Q
libraries are saved  to the SYSLIBTXT file  in TAASECURE.  This  allows
ACTION(*RESET) to be  used to reset the values.   See later discussion.

A  *BLANK  option also  exists  to allow  the text  descriptions  to be
reset to blanks.

ACTION(*RESET) Option
---------------------

The first  time CHGSYSTXT is  used (or  the first  time after  a a  new
system  release  is   installed),  the  text  descriptions   of  the  Q
libraries are saved to the SYSLIBTXT file in TAASECURE.

If  ACTION(*RESET) is  specified,  the file  is read  and  each library
text description  is reset  to the  saved  value if  the owner  of  the
library is an IBM supplied profile.

Because all Q libraries  are saved, there are some  differences between
*RESET  and the  other ACTION  values.   The  other ACTION  values will
only  change libraries  that are found  in the DSPSFWRSC  outfile and a
few  other special  cased  libraries  such  as QDSNX.    All  libraries
processed are described in the listing.

If you  have changed a  Q library text  description that is owned  by a
system  supplied profile,  ACTION(*RESET) will  reset the value  to the
last save  of the text  descriptions.   The listing  will describe  the
reset values.

CHGSYSTXT escape messages you can monitor for
---------------------------------------------

      TAA9893    Some errors occurred

Escape messages from based on functions will be re-sent.

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

   ACTION        The action to be performed.

                 *TEST is the  default to output a spooled  file of the
                 proposed changes.

                 *UPDATE   may   be  specified   to   cause   the  text
                 descriptions to  be  changed  to  the  values  in  the
                 spooled file.

                 *RESET   may   be  specified   to   reset   the   text
                 descriptions  to the  values  that were  saved  to the
                 SYSLIBTXT  file in  TAASECURE.   The text descriptions
                 are saved on the  first use of CHGSYSTXT or  the first
                 use after  a new system  release is installed.   There
                 are    differences   between   which   libraries   are
                 processed between  the use  of  *RESET and  the  other
                 ACTION values.  See the previous discussion.

                 *BLANK   may   be   specified  to   reset   the   text
                 descriptions  to blanks  as  described in  the spooled
                 file.

   OTHERLIB      Whether to place  English text on  the libraries  that
                 are not identified in the DSPSFWRSC outfile.

                 *YES is the  default.  This causes a  text description
                 to be placed on such libraries as QDSXN, QGY, etc.

                 *NO  may be  specified  to bypass  the  libraries that
                 are not found in the DSPSFWRSC file.

   OUTPUT        How  to  output  the results.    * is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.   The spooled file is  deleted after it
                 is displayed.

                 If  the  command  is entered  in  batch  or  *PRINT is
                 specified, the spooled  file is  output and  retained.

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

You must have *ALLOBJ special authority to use CHGSYSTXT.

Only  those   libraries  with   a  record   output  by   DSPSFWRSC  are
considered.

If the text description exceeds 50 bytes, it is truncated to 50.

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

The following TAA Tools must be on your system:

     CHGOBJD2        Change object description 2
     CHKALLOBJ       Check *ALLOBJ special authority
     CHKAPOST        Check apostrophes
     CHKIBMPRF       Check IBM profile
     CVTDSPDTA       Convert display data
     CVTLIBA         Convert library attributes
     EDTVAR          Edit variable
     PRINT           Print
     RTVMSGD         Retrieve message description
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message
     SORTDBF         Sort data base file

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CHGSYSTXT     *CMD                   TAALIDC       QATTCMD
   TAALIDCC      *PGM       CLP         TAALIDCC      QATTCL
   TAALIDCC2     *PGM       CLP         TAALIDCC2     QATTCL
					

Added to TAA Productivity tools February 1, 2005


Home Page Up to Top