Switch Operations Facility › SOF Server Commands › Miscellaneous Commands › DEFINE SWITCH Command—Identifies a Switch

DEFINE SWITCH Command—Identifies a Switch

The DEFINE SWITCH command is used in the INITCMDS file to identify a switch to the SOF server. This command will not normally be needed. For information about situations in which this command may be needed, see subsection Define Switches in section SOF server Configuration and Start-up.

This command has the following syntax:

DEFINE  SWItch  devnum  devid  [name]

devnum

Provides the logical device number of the switch as specified in the IODF of the local system. If this number is different on different systems in the SOF complex, then a different DEFINE SWITCH command will have to be directed to each different system.

devid

An arbitrary DEVID that SOF uses to properly correlate the switch among the multiple z/OS systems in the SOF complex. This value should be the same on each DEFINE SWITCH command issued for the same switch on different systems. Specify the 28-byte DEVID as 35 printable characters, with a period between the individual fields (type, model number, manufacturer, location, serial number, and tag) and the 2-byte binary tag as four printable hex characters.

Example: 009032.005.IBM.02.FAKESERIAL03.0000

name

(Optional) The name to be assigned to the defined switch. The name can be up to 24 characters in length, and can contain the following special characters: space, digits, period, and underscore. A name that contains spaces must be delimited by quotes.