Brocade OS Command Reference Manual Supporting Fabric OS v6.0.0 (53-1000599-01, October 2007)

Fabric OS Command Reference 63

53-1000599-01

cfgShow

Displays zone configuration information.

Synopsis cfgshow ["pattern"][, mode]

Description Use this command to display zone configuration information.

If no operand is specified, all zone configuration information (both defined and effective) displays.

If the local switch has an outstanding transaction, this command displays the newly edited zone

configuration that has not yet been saved. If the local switch has no outstanding transaction, this

command displays the committed zone configuration.

If an operand is specified, it is used as a pattern to match zone configuration names in the defined

configuration; those that match the pattern display.

The defined configuration is the complete set of all zone objects that have been defined in the

fabric. There can be multiple zone configurations defined, but only one can be enabled at a time.

There might be inconsistencies in the definitions, zones, or aliases that are referenced but not

defined, or there might be duplicate members. The defined configuration is the current state of the

administrator input.

The effective configuration is the single zone configuration that is currently enabled. The devices

that an initiator sees in the fabric are based on this configuration. The effective configuration is

built when a specific zone configuration is enabled and all error checking has been completed

successfully.

When default zoning is enabled with “No Access” mode, “No Effective configuration: (No Access)”

is displayed.

This command will not display any zoning configuration output the very first time a transaction is

aborted on a local switch. Instead, this command will display this warning message:

Warning: Current Zoning Transaction was aborted.

Reason code = Zone Config update received

For example: a transaction is created on SW1 using the cfgCreate or zoneCreate commands. From

another switch, SW2, in the fabric, execute a transaction-closing command such as cfgDisable,

cfgEnable, or cfgSave. This sends a zone configuration update to all switches in the fabric and the

open transaction on SW1 is aborted. Now if you issue cfgShow on SW1, only the warning displays

and no zoning configuration information.

Notes This command requires a Brocade Advanced Zoning license.

When FCS policy is enabled, this command can be issued on any FCS switch in the fabric.

Operands This command has the following operands:

“pattern” A POSIX-style regular expression used to match zone configuration names.

The pattern must be enclosed in quotation marks, and can contain:

• Question mark (?), which is a placeholder for any single character

• Asterisk (*), which is a placeholder for any string of characters

• Ranges, which are a placeholder for any character within the range.

Ranges must be enclosed in brackets: for example, [0-9] or [a-f].