Defining the Command Name Using the :CMD Statement
The :CMD statement defines the name of a command as the system sees it and as the national language sees it.
The format of the :CMD statement is:
- uniqueid
- identifies the syntax definition name for the command within the DLCS file. This is required,
and it must be unique for each syntax definition. When you invoke the parsing facility, the
uniqueid is matched to the uniqueid you specify
on the PARSECMD command. These IDs must match exactly, that is even the uppercase and lowercase
letters must match. For example,
Anne=Anne
butANNE¬=Anne
.uniqueid is any combination of up to 16 characters. For quick access to the syntax definitions, the first one or two characters are used as an index. If the first two characters of uniqueid are valid hexadecimal digits, their value is used as the index. Otherwise, the EBCDIC value of the first character is used. For example,
D9xxx
andRxxx
have the same index value of 217. CMS can find syntax definitions faster if the unique IDs have different index values. - sl-name
- is the command name as CMS sees it. The exec from which the PARSECMD command is called must be named sl-name.
- nl-name
- is the command name as a national language user sees it. The default is sl-name.
- nl-n
- is the minimum number of characters that must be entered for nl-name to be accepted. The default is sl-n, which is the length of sl-name.
Note:
- A new command syntax definition begins each time a :CMD statement is encountered.
- All uniqueids used for IBM commands have a period as the fourth character. Do not use a period as the fourth character in the uniqueid for your own commands.
- A uniqueid of all blanks is reserved to let you define more than one translation for a command. When this uniqueid is found, no syntax information is stored. You can only code the :CMD and :SYN statements in this case.
- The minimum length for abbreviations of command name translations cannot be more than eight or HELP does not recognize them.
- The nl-name is only used by the CMS search order if the application identifier of this DLCS file is DMS.
- The SET TRANSLATE command enables or disables nl-name.
- If SET ABBREV OFF is in effect, you must use the full nl-name.