Syntax
IBM® recommends that command resource names use the syntax described in this topic.
A command resource name can include up to four parts: a system identifier, the command or a variation of the command, a command qualifier, and a command object. These parts enable you to define a naming hierarchy that can identify specific commands or command subsets.
All command resource names must include a system identifier and the command name or a variation of the command name. The use of the command qualifier and the command object is optional and depends on the naming structure you want to define.
Periods must separate the parts of a command resource name. A command resource name can be up to 39 bytes long including the periods.
system_identifier .command [.command_qualifier [.command_object]] |
- system_identifier
- Identifies the system, subsystem, or application to which the
command belongs. For example, IBM uses MVS to
identify MVS™ operator
commands, JES2 to identify JES2 commands, and JES3 to
identify JES3 commands.
system_identifier is a required part of the name.
- command
- Identifies a specific command or some variation of a command.
Where possible, use the command name. In cases where the command
name does not provide the level of identification you require, use
a variation of the command name. You might use a variation of a command
name under the following conditions:
- When coding a particular keyword on a command causes command processing to be significantly different than if you omitted the keyword
- When coding a particular keyword on a command requires the issuer of the command to have a higher authority than is required if the keyword is omitted.
For example, the appearance of the ARM keyword on the MVS FORCE command causes significantly different processing than occurs when the ARM keyword is omitted. Therefore, if you were defining command resource names for the FORCE command, you might use the following variations:- MVS.FORCE.DEV.device
- The resource name that identifies the FORCE device command.
- MVS.FORCEARM.DEV.device
- The resource name that identifies the FORCE device,ARM command.
command is a required part of the name.
- [.command_qualifier]
- command_qualifier allows you to more precisely identify
the command variation in question. For example, if you were defining
a command resource name for the MVS SET command, you might use the keywords
IOS or SMS. The command resource names would appear as:
- MVS.SET.IOS
- MVS.SET.SMS
command_qualifier is an optional part of the name.
- [.command_object]
- command_object identifies the object of the command.
For example, command_object might identify:
- the device on a CANCEL command
- the jobname on a MODIFY command
command_object is an optional part of the name.