Formatted output
for the CQUERY command contains
the following fields:
- DEVICE
- Displays the 4-digit hexadecimal device
address. SCH(x) indicates
the subchannel for the device.
- LEVEL
- Displays whether the volume is a primary or secondary volume. For a primary volume, it also
displays the status of the volume as defined by the CRIT parameter of the CESTPAIR command that
established the pair.
If neither PRIMARY nor SECONDARY is displayed, the volume is not part of a
PPRC pair.
CRIT(NO) indicates that you either issued the CESTPAIR command without the CRIT
parameter, or specified CRIT(NO).
CRIT(YES-PATHS) indicates that the volume pair only be
write-inhibited when there are no PPRC paths available. CRIT(YES-ALL) indicates that the primary
storage control has been configured to suspend the pair and prevent I/O to the primary volume as a
result of any error, including an error on the primary or secondary volume. CRIT(YES-PATHS) and
CRIT(YES-ALL) both indicate that the CESTPAIR command included the CRIT(YES) parameter.
- STATE
- Indicates whether the PPRC volume is in simplex, pending, duplex, suspended
(suspend(n)), extended distance pending XD, Multi-Target Internal Relationship (MTIR) or extended distance
susp(n).xd state. The value n for SUSPEND is one
of the following:
- (3) — The PPRC volume pair was suspended by a host command to the primary site storage
control.
- (4) — The PPRC volume pair was suspended by a host command to the recovery site storage
control.
- (5) — A command issued by the primary site storage control to the recovery site storage control
has suspended the pair. Only a recovery site storage control returns value 5.
- (6) — Internal conditions within either storage control have suspended the pair. Either storage
control returns value 6.
- (7) — The transition of the recovery volume to the simplex state has suspended the pair. Only a
primary site storage control returns value 7.
- (8) — The primary site storage control has suspended the pair as a result of abnormal conditions
within the recovery site storage subsystem. These conditions may involve the storage control, its
attached disk devices, and the ESCON® paths between the two
sites. The primary site storage control detects and reports this condition.
- (9) — Either an IPL, or a power interruption to either storage control, have suspended the pair.
The storage control that received the interruption returns value 9.
- (A) — A CGROUP command with the FREEZE parameter has suspended the pair. You must query a
primary device to receive value A.
- PATH STATUS
- Displays whether the status
is active or inactive.
- SSID CCA LSS Serial
# PRIMARY
- Displays the four-character subsystem ID (SSID)
of the primary
site storage control, the two-character LSS CCA of the primary volume
and, when available, the storage control serial number (up to 12 characters).
- SSID CCA LSS Serial # SECONDARY
- Displays
the four-character subsystem ID (SSID) of the recovery
site storage control, the two-character LSS CCA of the primary volume,
and the storage control serial number (up to 12 characters).
- CRIT
- Displays the status of the CRIT
keyword of the CESTPAIR command.
- CGRPLB
- Indicates whether or not
the storage subsystem is configured
to support PPRC consistency grouping.
- INCRES
- Indicates whether the incremental resync
change recording mechanism
has been started for the Metro/Global Mirror environment.
- Additional status lines for the queried device
might be displayed:
THIS DEVICE IS CURRENTLY IN A CASCADED, FAILOVER STATE.
THIS DEVICE IS CURRENTLY PRIMED FOR RESYNCHRONIZATION.
PAIR WAS THE TARGET OF A WITHDRAWN PRESERVE MIRROR RELATION.
THIS DEVICE IS CURRENTLY IN A SOFT FENCE STATE.
THIS PAIR HAS BEEN IDENTIFIED TO BE USED FOR PRESERVE MIRROR.
- PATHS
- Displays the number of valid
links, if there are any, between
primary site and recovery site storage controls.
- SAID
- Displays the four-character system adapter ID (SAID)
of the
primary site storage control. SAID and DEST make up the link address. If there are no paths, the
SAID/DEST header is the default.
- DEST
- Specifies up to four 4-digit, hexadecimal-character link addresses.
The link addresses each consist of a 2-digit, hexadecimal-character ESCON port address followed by
00.
- XXXX XXXX --
- The storage control
has an association recorded between the
indicated primary and secondary subsystems, but 0 paths identified,
so was it not able to determine the SAID and DEST. A path and a status
of FF will be displayed. This may occur after a freeze is issued.
To clean up the "XXXX XXXX" values, an establish path must be
issued. The SSID, CCA, LSS, Serial number, and WWNN are given to help
determine the correct primary and secondary parameters to use for
the establish path command. If you are continuing operations after
a freeze, reestablish the path and pairs. If a link between these
two subsystems is no longer required, the association should be removed
by reestablishing the path between the primary and secondary subsystems,
deleting any suspended pairs, and then deleting the path.
- PFCA
- Displays the primary Fibre Channel adapter
identifier.
- SFCA
- Displays the secondary
Fibre Channel adapter identifier.
- STATUS
- Displays a 2-digit number that indicates
the detailed status
of the path.
- DESCRIPTION
- Provides
a short description of the status indicator:
- 00 — No path
- 01 — Established path
- 02 — Either
initialization or reinitialization has failed,
or the path is inoperative
- 03 — Time out
- 04 — No resources
available at primary site storage control
- 05 — No resources
available at recovery site storage control
- 06 — Serial number
mismatch
- 10 — Configuration error
- 13 — Fibre Path
Established
- 14 — Fibre Channel Path Link Down
- 15
— Fibre Channel Path Retry Exceeded
- 16 — Fibre Channel Path
Secondary Adapter not PPRC Capable
- 17 — Fibre Channel Path Secondary Adapter not Available
- 18 — Fibre Channel Path Primary Login Exceeded
- 19 — Fibre
Channel Path Secondary Login Exceeded
- 1A — Primary
Fibre Channel not Configured
- 1B — Fibre Degraded
- 1C — Fibre Removed
- nn — Status is undetermined
- FF — Unable to determine
- FIRST
CYL OUT OF SYNCH (displayed for RAMAC Virtual
Array (RVA and IBM® 3990)
- This
information, when available, is presented only for volumes
in pending and suspended states.
If the volume is a primary volume,
this is the lowest cylinder number that is out of synchronization
on the primary volume. For a secondary volume, this is the lower cylinder
number that was received from the primary. This update is in cache,
as PPRC has not yet written this update to the secondary volume.
- LAST CYL OUT OF SYNCH (displayed for RAMAC
Virtual
Array (RVA and IBM 3990)
- This
information, when available, is presented only for volumes
in pending and suspended states.
If the volume is a primary volume,
this is the highest cylinder number out of synchronization on the
primary volume. For a secondary volume, this is the higher cylinder
number that was received from the primary. This update is in cache,
as PPRC has not yet written this update to the secondary volume.
- TRACKS OUT OF SYNC (displayed for ESSs)
- This
information displays for volumes that are in PENDING or
SUSPEND states. (The ESS must have the most current level of microcode
installed.) If the volume is a primary volume, this is the number
out-of-sync tracks that PPRC has not yet written to the secondary
volume.
- TRACKS ON VOLUMES (displayed for
ESSs)
- This information displays for volumes that are in PENDING
or
SUSPEND states. (The ESS must have the most current level of microcode
installed.) If the volume is a primary volume, this is the number
of tracks that exist on the volume.
- PERCENT
OF COPY COMPLETED
- Displays the percent completed for the copy
operation based
on the number of cylinders or tracks on the particular type of storage
control. This is an optional line of information that PPRC presents
only if the volume is a primary volume and the information is available.
- SECONDARY WAS SUSPENDED
- When it is
available, displays the Universal Time Coordinated
(UTC) to indicate when this secondary volume became suspended. The
UTC, in the ISO format “YYYY-MM-DD HH.MM.SS.NNNNNN”, is the
time-of-day clock value from the host system from which the CSUSPEND
command was issued.
- SUBSYSTEM
- Indicates all the primary and
secondary storage controls that
are associated with each WWNN that may have been established by a
CESTPATH request. The presence of either PRIMARY or SECONDARY indicates
that the subsystem is associated with a PPRC path.
The subsystem
may have PPRC activity that is unrelated to the device for which the
query was issued. The WWNN information may be included in the CQUERY
'VOLUME REPORT' as long as there is an active Fibre Channel Protocol
(FCP) path on the device's associated LSS. The device for which the
query was issued may not show active paths on the CQUERY 'VOLUME REPORT'.
If the CQUERY 'PATHS REPORT' indicates active paths for the device,
the WWNN information may be related to that device.
PRIMARY
indicates that the associated WWNN is for a primary (or source) logical
subsystem or storage control. SECONDARY indicates that the associated
WWNN is for a secondary (or target) logical subsystem or storage control.
The
absense of either PRIMARY or SECONDARY next to a WWNN indicates that
the query request could not determine the status of the subsystem.
The WWNN is provided as informational data.
- WWNN (Primary, Secondary)
- Specifies the World Wide Node
Name (WWNN) that is used to access
a primary or secondary logical subsystem or storage control referenced
by the SSID using fibre channel protocol (FCP) linkage. Every ESS
is assigned a WWNN and is 16 hexadecimal digits in length.
The
presence of the WWNN information indicates that there is one or more
paths established in the LSS associated with the device for which
the QUERY was issued.
UNKNOWN —
means the Query was not able to determine the WWNN of a subsystem.
Note: The SUBSYSTEM and WWNN values are only displayed
when a logical subsystem or storage control is FCP enabled.