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