Command Reference Guide

Fabric OS Command Reference 113
53-1002746-01
cfgShow
2
cfgShow
Displays zone configuration information.
SYNOPSIS cfgshow ["pattern"] [, mode]
cfgshow [--transdiffs]
cfgshow [--transdiffsonly]
cfgshow --help
DESCRIPTION Use this command to display zone configuration information.
If no operand is specified, all zone configuration information (both defined and effective) is displayed. If
the local switch has an outstanding transaction, this command displays the most recently 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 a pattern is specified, only matching configurations are displayed.
• 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.
Use the --transdiffs and --transdiffsonly options to view changes in the current transaction.
The command output displays changes in the current transaction by the following notations:
• An asterisk(*) before any tag indicates a change in that zone, zone configuration, alias or any other
entity in the zone configuration.
• A plus(+) before any entity indicates that it is a newly added entity.
• A minus(-) before any entity indicates that it is a deleted entity.
When this command is executed after a zoning transaction was aborted on the local switch, it displays
the following warning message: "Warning: Current Zoning Transaction was aborted. Reason code =
Zone Config update received."
When default zoning is enabled with "No Access" mode, "No Effective configuration: (No Access)" is
displayed.
NOTES The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
OPERANDS The following operands are optional:
"pattern"
A regular expression that matches zone configuration names. The pattern must
be enclosed in quotation marks and can contain the following:
Question mark (?)
Matches any single character