Command Definition (CMD)

Parameters
Examples
Error messages

The Command (CMD) command definition statement specifies the prompt text for the command being created. The prompt text is displayed when a user requests prompting while entering the command that is being defined. The CMD statement can be anywhere in the source file referred to by the Create Command (CRTCMD) command; one and only one CMD statement must be used in the source file even if no prompt text is specified for the created command.

Top

Parameters

Keyword Description Choices Notes
PROMPT Prompt text or message ID Character value, *NONE Optional, Positional 1
Top

Prompt text or message ID (PROMPT)

Specifies the prompt text, if any, that is included in the heading (title) of the prompt display for the command being defined. The prompt text further describes the name of the command.

Note: Prompt text for each of the parameters of this command can be specified in the PROMPT parameters of the PARM, ELEM, and QUAL command definition statements, which specify the prompt text for the parameters, elements, and qualifiers, just as the PROMPT parameter in this statement specifies the prompt text for the command.

*NONE
No prompt text is included in the displayed heading of the prompt when the command is being prompted.
message-identifier
Specify the message identifier that specifies the message, containing no more than 30 characters, for the prompt text displayed when the command is being prompted. If a message having the specified identifier cannot be found in the message file specified on the PMTFILE parameter of the Create Command (CRTCMD) command, the message identifier itself is used as the prompt text.
'prompt-text'
Specify the prompt text that is displayed during the command prompting. It must be a character string of no more than 30 characters, enclosed in apostrophes.

Variables cannot be coded for this parameter.

Top

Examples

CMD   PROMPT(UCD0001)

This statement describes a command that is prompted with additional text in the display heading. The command prompt text comes from the message identified by UCD0001. The message file which contains message identifier UCD0001 must be specified on the PMTFILE parameter of the Create Command (CRTCMD) command used to create the command definition object.

Top

Error messages

None

Top