SCF Reference Manual for the Storage Subsystem (G06.28+, H06.05+, J06.03+)

SWITCH Command
The SWITCH command designates the active a path to a device.
Supported objects are:
• “SWITCH ADAPTER Command” (page 294)
• “SWITCH CLIM Command” (page 294)
• “SWITCH DISK Command” (page 295)
• “SWITCH SCSI Command” (page 296)
SWITCH is a sensitive command.
SWITCH ADAPTER Command
The SWITCH ADAPTER command moves all device paths from and to a SAC on an adapter, as
part of adapter replacement. The syntax is:
SWITCH [ / OUT file-spec / ]
ADAPTER $ZZSTO.#type.GRP-g.MOD-m.SLOT-s
, { AWAY | DEFAULT } [ , FORCED ]
Wild-card characters are supported.
OUT file-spec
directs all SCF output to the specified file.
ADAPTER $ZZSTO.#type.GRP-g.MOD-m.SLOT-s
is a ServerNet adapter of type PMF, IOMF, or SNDA. g cannot have a leading zero.
AWAY [ , FORCED ]
specifies that all active paths using the specified adapter become inactive, if possible.
The FORCED attribute stops all paths to the specified adapter after attempting to make them
inactive.
DEFAULT [ , FORCED ]
specifies that all -P and -M paths using the specified adapter become active, if possible, and
all -B and -MB paths become inactive if possible.
The FORCED attribute starts all paths to the specified adapter before attempting to make them
active.
SWITCH ADAPTER Examples
• To stop all data paths to a PMF adapter before removing it:
-> SWITCH ADAPTER $ZZSTO.#PMF.GRP-1.MOD-1.SLOT-55, &
-> AWAY, FORCED
• To restore data paths to an adapter after inserting it:
-> SWITCH ADAPTER $ZZSTO.#SNDA.GRP-11.MOD-1.SLOT-54, DEFAULT
SWITCH CLIM Command
The SWITCH CLIM command initiates disk path switches for disks configured through the specified
CLIM. The syntax is:
SWITCH [ / OUT file-spec / ] CLIM $ZZSTO.clim-name
, { AWAY | DEFAULT }
[ , FORCED ]
294 Storage Subsystem Commands