mkzone

Use the mkzone command to create a zone. This command must be run within a transaction. You must have Administrator authority to use this command.

Important:
  • An orphan zone is one that does not belong to a zone set. If the zone that you are creating is an orphan zone and the switch and data source that you are using support orphan zones, use only the mkzone command to create the zone.

    However, if the switch and data source that you are using do not support orphan zones, you must use the addzone command within the same transaction to add the zone to a zone set. Specify the addzone command AFTER you create the zone by using the mkzone command. For details about adding a zone to a zone set, see the addzone command.

  • To activate your changes to a zone set, use the actzs command. For details, see the actzs command.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoolmkzone-user user_name -pwd password -url url -fabric WWN -zone zone-help?-silent ports-

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-fabric WWN
Specifies the fabric. The WWN variable is the worldwide name (WWN).
-zone zone
Specifies the zone. The zone variable is the name of the zone.
-help | -h | -?
Lists help information for the command.
-silent
Suppresses all output for the command. If you omit this parameter, output is included.
ports | -
Specifies the switch ports. The ports variable is a list of worldwide port names (WWPNs). If you specify a single dash (-), the WWPNs are read from standard input.

Example: Creating a zone

In the following example, assume that the switch that you are using does not support orphan zones. To create the SUNSOLARIS zone, add the zone to a zone set, and activate the zone set. Specify all zoning changes within one transaction, from start to commit, and then activate the zone setwel by using the actzs command. The list of WWPNs is read from standard input.

tpctool> start -user me -pwd mypass -url myhost:myport -fabric 100000051E34F6A8
tpctool> mkzone -fabric 100000051E34F6A8 -zone SUNSOLARIS -
tpctool> addzone -fabric 100000051E34F6A8 -zs PARIS SUNSOLARIS
tpctool> commit -fabric 100000051E34F6A8
tpctool> actzs -fabric 100000051E34F6A8 PARIS