TAA Tools
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