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

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

Including the command_object as part of the command resource name enables you to control access to commands based on the object the command affects.

command_object is an optional part of the name.