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.
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
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
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
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:
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
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
** 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.
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
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
The TAACMDML file is only used for the create steps of dependent
tools. The TAACMDML2 file is used to create the CMDKWDL logical file