Table Of Contents

H Commands

host

H Commands

---

The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "About the CLI Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.

•host

host

Use the host command to configure the switch offline state, the mainframe access control parameters, and the mainframe time stamp parameters. To disable the configuration or to revert to factory defaults, use the no form of the command.

host {control [switch offline] | port control | set-timestamp}

no host {control [switch offline] | port control | set-timestamp}

Syntax Description

control	Allows the host control of FICON.
switch offline	Allows the host to move the switch to an offline state and shut down the ports (default).
port control	Enables the host to configure FICON parameters.
set-timestamp	Allows the host to set the director clock

Defaults

Host offline control enabled.

Command Modes

FICON configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.3(1).

Usage Guidelines

By default, the clock in each VSAN is the same as the switch hardware clock. Mainframe users are allowed to change the VSAN-clock.

Examples

The following example prohibits mainframe users from moving the switch to an offline state.

switch# config t

switch(config)# ficon vsan 2

switch(config-ficon)# no host control switch offline

The following example allows the host to move the switch to an offline state and shut down the ports .

switch(config-ficon)# host control switch offline

The following example prohibits mainframe users to configure FICON parameters in the Cisco MDS switch (default).

switch(config-ficon)# no host port control

The following example allows mainframe users to configure FICON parameters in the Cisco MDS switch.

switch(config-ficon)# host port control

The following example prohibits mainframe users from changing the VSAN-specific clock.

switch(config-ficon)# no host set-timestamp

The following example allows the host to set the clock on this switch (default).

switch(config-ficon)# host set-timestamp

Related Commands

Command	Description
show ficon	Displays configured FICON details.
ficon vsan vsan-id	Enables FICON on the specified VSAN.