The Asynchronous Operations Manager QUERY FlashCopy® return codes and reason codes specify the condition that occurred. Table 1 lists the explanation for each code.
| Return Code | Reason Code | Description |
|---|---|---|
| 0 (X'00') | The control volume and all of the volumes in the VOLLIST have been processed. All of the volume entries have been marked to indicate their degree of FlashCopy eligibility and separation. | |
| 0 (X'00') | All volumes are eligible. | |
| 1 (X'01') | One or more known volumes in the volume list are ineligible. | |
| 4 (X'04') | Processing cannot be accomplished. None of the volumes' entries have been marked to indicate their degree of FlashCopy eligibility and separation. | |
| 1 (X'01') | The control volume does not support any version of FlashCopy. | |
| 2 (X'02') | Control volume support for FlashCopy cannot be determined. I/O to read flash copy support status for uninitialized device (offline) did not complete or has incomplete status. | |
| 8 (X'08') | QUERYFC detected an error in the input parameters or in the contents of the VOLLIST. | |
| 1 (X'01') | AOM02039 was passed a SERVL in which SERVVPTR is zero. | |
| 2 (X'02') | AOM02039 was passed a SERVL in which AOMQFC_LISTNUM is zero. | |
| 3 (X'03') | The chain of pointers needed to locate the SSCT contains a zero pointer. | |
| 4 (X'04') | A number for extent pairs to be checked was passed without passing the extent pairs. | |
| 5 (X'05') | A number for extent pairs to be checked exceeded max relations allowed on volume. | |
| 10 (X'0A') | ASYN PPRC primary is currently active on volume. | |
| 12 (X'0C') | A serious AOMQFC error occurred, such as an ABEND. | |
| 1 (X'01') | Load module AOM02039 could not be loaded by module IGX00039. SERVFRC will contain the failure return code from LOAD. | |
| 2 (X'02') | Load module AOM02039 was passed a SERVL that specified a request type other than SERVFVLS(QUERYFC). | |
| 3 (X'03') | Getmain failed in AOM02039. SERVFRC set to getmain return code. | |
| 4 (X'04') | Freemain failed in AOM02039. SERVFRC set to freemain return code. | |
| 5 (X'05') | Program error in AOM02039. SERVFRC set to system completion code. | |
| 6 (X'06') | Getmain failed in AOM02139. SERVFRC set to getmain return code. | |
| 7 (X'07') | Freemain failed in AOM02139. SERVFRC set to freemain return code. | |
| 8 (X'08') | Program error in AOM02139. SERVFRC set to system completion code. | |
| 9 (X'09') | Load module AOM02139 could not be loaded by module AOM02039. SERVFRC will contain the failure return code from LOAD. |
| Reason Code | Description |
|---|---|
| FlashCopy Volume Capability (AOMQFC_VCAP): | |
| 0 (X'00') | Volume is not capable. |
| 1 (X'01') | Volume is source capable (source query). |
| 2 (X'02') | Volume is target capable (target query). |
| FlashCopy not eligible for volume-related reasons (AOMQFC_VRSN): Reason message text (AOMQFC_MSGTEXT): |
|
| 0 (X'00') | Volume is capable. Reason msg text: VOLUME IS TARGET CAPABLE Or Reason msg text: VOLUME IS SOURCE CAPABLE |
| 1 (X'01') | Total relations active is at maximum for the volume. Reason msg text: MAX VOL FC RELATIONS |
| 2 (X'02') | PPRC primary is active on volume Reason msg text: PPRC PRIM CURRENTLY ACTIVE |
| 3 (X'03') | PPRC secondary is active on volume Reason msg text: PPRC SEC CURRENTLY ACTIVE |
| 4 (X'04') | Concurrent copy source is active on volume. Reason msg text: CC SRC CURRENTLY ACTIVE |
| 5 (X'05') | XRC source is active on volume. Reason msg text: XRC SRC CURRENTLY ACTIVE |
| 6 (X'06') | Volume inhibited for FlashCopy
operations by command. Reason msg text: VOLUME INHIBITED FOR FC |
| 7 (X'07') | Version 1 FlashCopy relation
exists on the volume. Reason msg text: VERSION 1 FC RELATION EXISTS |
| 8 (X'08') | Total relations active is at maximum of the ESS. Reason msg text: MAX ESS FC RELATIONS |
| 9 (X'09') | Volume is inaccessible. Reason msg text: VOLUME INACCESSIBLE |
| 10 (X'0A') | ASYN PPRC primary is currently active on volume. Reason msg text: ASYNC PPRC PRIM ACTIVE |
| 11 (X'0B') | Volume already active as a full volume target (target capability). Reason msg text: FULL VOL FC TARGET RELATION |
| 12 (X'0C') | Volume already active as a full volume source (target capability). Reason msg text: FULL VOL FC SOURCE RELATION |
| 13 (X'0D') | Volume already active in the maximum full volume source relations. Reason msg text: MAX FULL VOL FC RELATIONS |
| 200 (X'C8') | Volume not found. Reason msg text: VOLUME NOT FOUND |
| 201 (X'C9') | No versions of Flash Copy are supported on this volume. Reason msg text: FLASHCOPY NOT SUPPORTED |
| 202 (X'CA') | Volume exceeds current supported FC boundary of the control volume. Reason msg text: BOUNDARY EXCEPTION |
| 203 (X'CB') | I/O error obtaining current FlashCopy status. Reason msg text: I/O ERROR ON QUERY |
| 204 (X'CC') | Volume geometry not compatible with control volume. Reason msg text: VOL GEOMETRY NOT COMPATIBLE |
| 205 (X'CD') | MVS-formatted VM minidisk. Reason msg text: MVS-FORMATTED VM MINIDISK |
| FlashCopy Extent Capability (AOMQFC_XCAP): | |
| 0 (X'00') | Volume is not capable. |
| 1 (X'01') | Volume is source capable (source query). |
| 2 (X'02') | Volume is target capable (target query). |
| FlashCopy not
eligible for extent-related reasons (AOMQFC_XRSN): Reason text (AOMQFC_MSGTEXT): |
|
| 0 (X'00') | Volume is capable on extent basis. Reason msg text: VOLUME IS TARGET CAPABLE or VOLUME IS SOURCE CAPABLE |
| 1 (X'01') | Already active as a source extent (target capability) Reason msg text: ALREADY ACTIVE AS SOURCE |
| 2 (X'02') | Already active as a target extent (source or target capability) Reason msg text: ALREADY ACTIVE AS TARGET |
| 3 (X'03') | Total relations active is at maximum for targets (source capability).
Reason msg text: ALREADY IN MAX RELATIONS |
| 4 (X'04') | Relationship entry is in a validation-required state (source or target
capability). Reason msg text: RELATION IN VALIDATION |
| Preserve Mirror (PM) FlashCopy (FC) Volume Capability (AOMQFC_PM_VCAP): | |
| 0 (X'00') | PM volume is not capable. |
| 1 (X'01') | PM volume is capable. |
| 2 (X'02') | PM capability was not requested. |
| 3 (X'03') | PM capability was not checked because not FC capable. |
| PM FlashCopy not eligible for volume-related reasons
(AOMQFC_PM_VRSN): Reason message text (AOMQFC_MSGTEXT): |
|
| 0 (X'00') | PM Volume is capable or not checked. Reason msg text: PRESERVE MIRROR CAPABLE (if AOMQFC_PM_VCAP=X'01') or ADDRESSED VOL NOT FC CAPABLE(if AOMQFC_PM_VCAP=X'03') |
| 1 (X'01') | Total relations active is at maximum for the secondary volume. Reason msg text: MAX VOL RELATIONS FOR SCNDRY |
| 4 (X'04') | Concurrent copy src active for the secondary. Reason msg text: SCNDRY CC SRC ACTIVE |
| 5 (X'05') | XRC src active for the secondary. Reason msg text: SCNDRY XRC SRC ACTIVE |
| 6 (X'06') | Secondary volume is inhibited for FlashCopy. Reason msg text: FC INHIBITED ON SCNDRY VOL |
| 7 (X'07') | Phase 1 FC relation exists on the secondary volume. Reason msg text: VER 1 FC RELATION ON SCNDRY |
| 8 (X'08') | Total relations currently at the maximum for the secondary ESS. Reason msg text: MAX FC RELATIONS FOR SCNDRY |
| 9 (X'09') | Secondary volume is inaccessible. Capability information could not be
obtained. Reason msg text: SCNDRY VOLUME INACCESSIBLE |
| 10 (X'0A') | Secondary volume is a Global Mirror primary. Reason msg text: SCNDRY IS GL MIRROR PRIMARY |
| 11 (X'0B') | Full volume target relation exists on the secondary volume. Reason msg text: MAX FC RELATIONS FOR SCNDRY |
| 12 (X'0C') | Full volume source relation exists on the secondary volume and target
capability was requested. Reason msg text: FULL VOL SRC RELATION ON SEC |
| 13 (X'0D') | The maximum number of full volume source relations exist on the secondary
volume and source capability was requested. Reason msg text: MAX FULL VOL RELATION ON SEC |
| 14 (X'0E') | Secondary voume is a Track Space Efficient volume and target capability was
requested. Track Space Efficient volumes are not allowed for Preserve Mirror operations. Reason msg text: SEC VOL IS SPACE-EFFICIENT |
| 15 (X'0F') | Secondary volume is in the process of PPRC Cascading Failback
Enabled. Reason msg text: INCRES OR CASC FB STARTED |
| 16 (X'10') | Secondary is a cascaded PPRC. Reason msg text: SEC IS CASCADED PPRC |
| 128 (X'80') | Volume is not a PPRC primary device. Reason msg text: NOT PPRC PRIMARY DEVICE |
| 129 (X'81') | The secondary to the addressed volume and the secondary to the control volume
are not in the same SFI. Reason msg text: SEC VOLS NOT IN THE SAME SFI |
| 130 (X'82') | PPRC relationship between the addressed volume and its secondary volume is not
in the DUPLEX state. Reason msg text: PPRC PAIR NOT A FULL DUPLEX |
| 131 (X'83') | The secondary control unit does not have PM feature installed. Reason msg text: SEC CTRL UNIT NOT PM ENABLED |
| 132 (X'84') | The control volume is not a PPRC primary device. Reason msg text: CTRL VOL IS NOT PPRC PRIMARY |
| 133 (X'85') | The command was received while system was attempting to install a new
microcode load and it does not support PM feature. Reason msg text: PARTNER CEC INCAPABLE OF PM |
| 134 (X'86') | Error was detected while the PRSDX47 was sent to the addressed secondary
volume. Reason msg text: PRSDX47 IN ERROR ON SCNDRY |
| 135 (X'87') | The addressed volume is Track Space Efficient volume and target capability was
requested. Reason msg text: VOLUME IS SPACE-EFFICIENT |
| 208 (X'D0') | PPRC Primary and PM feature not installed. Reason msg text: PPRC PRIM WITHOUT PM FEATURE |
| 209 (X'D1') | PPRC Primary not duplex or RPFCv2 feature not enabled. Reason msg text: PRIMARY NOT DUPLEX, no RPFCv2 |
| 256 (X'100') | PM feature not installed in storage server. Reason msg text: PM FEATURE NOT INSTALLED |
| Preserve Mirror (PM) volume reason code for extent capability (AOMQFC_PM_XCAP): | |
| 0 (X'00') | PM volume is not capable. |
| 1 (X'01') | PM source capable (on source query). |
| 2 (X'02') | PM target capable (on target query). |
| PM FlashCopy not eligible due to extent-related reasons
(AOMQFC_PM_XRSN): Reason message text (AOMQFC_MSGTEXT): |
|
| 0 (X'00') | Volume is capable on extent basis. Reason msg text: VOLUME IS REMOTE TGT CAPABLE or Reason msg text: VOLUME IS REMOTE SRC CAPABLE |
| 1 (X'01') | Already active as a remote source extent (target capability) Reason msg text: ALREADY ACTIVE AS REMOTE SRC |
| 2 (X'02') | Already active as a remote target extent (source or target capability)
Reason msg text: ALREADY ACTIVE AS REMOTE TGT |
| 3 (X'03') | Total relations active is at maximum for targets (source capability).
Reason msg text: REMOTE IN MAX RELATIONS |
| 4 (X'04') | Relationship entry is in a validation-required state (source or target
capability). Reason msg text: REMOTE REL IN VALIDATION |