CVTCMDKWD -- Convert Command Keywords

CVTCMDKWD CONVERT COMMAND/KEYWORDS TAACMDM
The Convert Command Keywords to Data Base file command creates an outfile of commands and keywords. One record is output for every combination of command and keyword. If a command does not have any keywords, a single record is output with a keyword of NONE. The user of the command must be authorized to the DMPOBJ command. DMPOBJ is used to find the keywords. If library QSYS is requested, the user must have ALLOBJ authority. A typical command would be: CVTCMDKWD LIB(LIB1 OUTLIB(yyy) All commands in LIB1 would be converted to the CMDKWDP output file in the OUTLIB you specified. The logical file CMDKWDL is also created with a key on the keyword and command name. The CMDKWDx files can be used for application functions that need to know command/keyword combinations. Many system supplied commands have hidden keywords that are not seen when prompting. These are normally designed to allow a common CPP to be used by several different commands. These keywords will be included in the data base file. Because some older forms of commands have a different internal format, certain command objects cannot be successfully converted. See the restrictions section. Excessive keywords ------------------ Due to the implementation method, there are some commands that have more keywords than can be converted. If this occurs, the value TOOMANY may be returned for the keyword name. This value is not output until as many keywords as possible have already been output from the command. Command parameters CMD ------------------ CMDLIB The library containing the commands to be converted. All commands in the library will be converted. A user library or any system library including QSYS may be specified. CMD The command name to be converted. The default is ALL for all commands in a library. A specific command name or a generic command name may also be used. OUTLIB The library in which the file CMDKWDP will be placed. The default is LIBL. If the CMDKWDP file does not already exist, a library must be specified. OUTMBR The member of the CMDKWDP file to be used. If the member does not exist, it is added. The default is CMDKWDP. REPLACE A YES/NO value for whether the member should be cleared before writing records into it. The default is YES. File format ----------- The file name that is output is CMDKWDP. The model file used is TAACMDMP with a format name of CMRCD. To see the field names used: DSPFMT TAACMDMP Restrictions ------------ Only a user authorized to DMPOBJ can use CVTCMDKWD. Only a user with ALLOBJ authority can use CVTCMDKWD on library QSYS. If the command has many keywords, a value of TOOMANY may exist for the keyword name. See the previous discussion. Because the tool must read the program dump, only English is supported. In some cases, older forms of commands use a different internal layout and cannot be converted. This applies to commands created on S/38 and restored on an i5 System. It does not apply to S/38 commands found in the QSYS38 library on i5/OS. The following command types are not converted: * If it has a License Program value of 5714 (S/38). If the release is V1R4, V1R5, V1R6, V1R7, or V1R8 (S/38 releases). If the command was created before 1988 (before OS/400). ** If the commands are from the BR1 product. In some cases, CVTCMDKWD cannot determine that the command was created on S/38 and will fail. Prerequisites ------------- The following TAA Tools must be on your system: CHKALLOBJ Check all object authority CVTHEXDEC Convert hex to decimal EDTVAR Edit variable HLRMVMSG HLL Remove message SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCMSG Send escape message SNDSTSMSG Send status message WRTSRC Write source Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- CVTCMDKWD CMD TAACMDM QATTCMD TAACMDMC PGM CLP TAACMDMC QATTCL TAACMDMR PGM RPG TAACMDMR QATTRPG TAACMDMP FILE PF TAACMDMP QATTDDS TAACMDML *FILE LF TAACMDML QATTDDS TAACMDML2 QATTDDS The TAACMDML file is only used for the create steps of dependent tools. The TAACMDML2 file is used to create the CMDKWDL logical file during CVTCMDKWD.

CVTCMDKWD       CONVERT COMMAND/KEYWORDS               TAACMDM


The Convert  Command  Keywords to  Data Base  file  command creates  an
outfile  of commands  and keywords.   One  record  is output  for every
combination  of command and  keyword.  If  a command does  not have any
keywords, a single record is output with a keyword of *NONE.

The user  of the  command must  be  authorized to  the DMPOBJ  command.
DMPOBJ is  used to find  the keywords.   If library QSYS  is requested,
the user must have *ALLOBJ authority.

A typical command would be:

         CVTCMDKWD    LIB(LIB1 OUTLIB(yyy)

All  commands in LIB1 would be converted  to the CMDKWDP output file in
the OUTLIB you  specified.  The  logical file CMDKWDL  is also  created
with a key on the keyword and command name.

The CMDKWDx  files can be used  for application functions that  need to
know command/keyword combinations.

Many  system supplied commands have  hidden keywords that  are not seen
when prompting.  These are normally  designed to allow a common CPP  to
be  used  by  several different  commands.    These  keywords  will  be
included in the data base file.

Because  some  older  forms  of  commands  have  a  different  internal
format,  certain  command  objects  cannot  be  successfully converted.
See the restrictions section.

Excessive keywords
------------------

Due to  the implementation method,  there are  some commands that  have
more  keywords  than can  be  converted.   If  this  occurs, the  value
*TOOMANY  may be  returned for  the keyword  name.   This value  is not
output until  as many  keywords as  possible have  already been  output
from the command.

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

   CMDLIB        The library  containing the commands to  be converted.
                 All  commands in  the library  will  be converted.   A
                 user library  or  any system  library  including  QSYS
                 may be specified.

   CMD           The command  name  to be  converted.   The default  is
                 *ALL  for  all  commands in  a  library.   A  specific
                 command  name or  a generic  command name  may also be
                 used.

   OUTLIB        The  library  in  which  the  file  CMDKWDP   will  be
                 placed.   The default is  *LIBL.  If the  CMDKWDP file
                 does  not already exist, a  library must be specified.

   OUTMBR        The member of  the CMDKWDP file  to be used.   If  the
                 member does  not exist, it is  added.  The  default is
                 CMDKWDP.

   REPLACE       A  *YES/*NO  value for  whether the  member  should be
                 cleared before writing records  into it.  The  default
                 is *YES.

File format
-----------

The file name that is output is CMDKWDP.

The model file used is TAACMDMP with a format name of CMRCD.

To see the field names used:

       DSPFMT    TAACMDMP

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

Only a user authorized to DMPOBJ can use CVTCMDKWD.

Only a user with  *ALLOBJ authority can use CVTCMDKWD  on library QSYS.

If the  command has many  keywords, a value  of *TOOMANY may  exist for
the keyword name.  See the previous discussion.

Because   the  tool  must  read  the  program  dump,  only  English  is
supported.

In  some cases,  older  forms  of  commands use  a  different  internal
layout and  cannot be converted.   This applies to commands  created on
S/38  and  restored  on an  i5  System.   It  does  not  apply  to S/38
commands found in the QSYS38  library on i5/OS.  The following  command
types are not converted:

  **   If it has a License Program value of 5714 (S/38).

  **   If  the  release  is  V1R4, V1R5,  V1R6,  V1R7,  or  V1R8  (S/38
       releases).

  **   If the command was created before 1988 (before OS/400).

  **   If the commands are from the BR1 product.

In  some  cases,  CVTCMDKWD  cannot  determine  that  the  command  was
created on S/38 and will fail.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check all object authority
     CVTHEXDEC       Convert hex to decimal
     EDTVAR          Edit variable
     HLRMVMSG        HLL Remove message
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message
     WRTSRC          Write source

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

None, the tool is ready to use.

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

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

   CVTCMDKWD     *CMD                   TAACMDM       QATTCMD
   TAACMDMC      *PGM       CLP         TAACMDMC      QATTCL
   TAACMDMR      *PGM       RPG         TAACMDMR      QATTRPG
   TAACMDMP      *FILE      PF          TAACMDMP      QATTDDS
   TAACMDML      *FILE      LF          TAACMDML      QATTDDS
                                        TAACMDML2     QATTDDS

The TAACMDML  file is  only  used for  the  create steps  of  dependent
tools.  The TAACMDML2  file is used to create the  CMDKWDL logical file
during CVTCMDKWD.

Added to TAA Productivity tools May 1, 1996

Home Page

Up to Top