Suspend Option dialog box

Business Continuity Manager Web API Reference Guide

Version
10.1.x
Audience
anonymous
Part Number
MK-96HC137-06
ft:lastEdition
2026-05-04

ShadowImage copy group

When you right click a copy group ID in the copy group dashboard of the Dashboard tab and then select Suspend from the copy group action menu, a dialog box appears for you to enter YKSUSPND command options (the dialog box differs depending on the copy type). When you click the OK button, YKSUSPND is executed on the copy group that was right clicked. Examples of dialog boxes and the items displayed are shown below.

If the group is a non-consistency group or if the dialog box is displayed from the pair action menu:

In cases other than the above:

Item

Description

Pair state goto

Specify the final copy pair status after the copy pair operation terminates normally. If you specify a status other than N/A, the copy group will be monitored until all the copy pairs in the copy group change to this status or until one of the copy pairs changes to abnormal status.

  • SUSPEND: If you specify SUSPEND, the final copy pair status is SUSPOP or SWAPPING.

  • SUSPVS: If you specify SUSPVS, the final copy pair status is SUSPOP or SUSPVS.

  • SWAP2SUS: If you specify SWAP2SUS, the final copy pair status is SUSPOP, SUSPER, or SUSPCU.

Nothing can be specified if ATTIME PRESET or ATTIME CANCEL is selected from Suspend option. If ATTIME CANCEL is specified, the copy group monitoring will not be executed regardless of the value specified for Pair state goto.

Pair selection

Specify SELECT parameter of YKSUSPND command i.e. how to select a copy pair to be manipulated.

  • ALL: Selects all copy pairs as targets.

  • COND: Selects target copy pairs based on the volume status of the copy pair.

Secondary Volumes R/W

Specify whether to permit updates to S-VOLs after suspension (the SVOL parameter of the YKSUSPND command).

  • (Copy group definition value): Applies the ProtectMode attribute value of the copy group definition file.

  • PROTECT: Prohibits updates.

  • PERMIT: Permits updates.

When changing the status to SWAPPING or to a suspend status from the SWAPPING status, this specification will be ignored, and the settings will permit writing to S-VOLs.

ATTIME PRESET and ATTIME CANCEL of the Suspend Option cannot be specified at the same time.

Volunit

Specify whether to perform copy group operation by volume (the VOLUNIT parameter value of the YKSUSPND command). You cannot make any selection in the dialog box displayed from the pair action menu. ATTIME PRESET and ATTIME CANCEL of the Suspend Option cannot be specified at the same time.

  • NO: Performs operations on a group basis if this is supported by the environment.

  • YES: Performs operations on a volume basis, even for an environment that supports operations on a group basis during specification.

Suspend option

Specify the suspend mode.

  • STEADY: Performs suspension immediately without using the ATTIME Suspend function. The status will change to SUSPOP after data copying finishes.

  • QUICK: Performs suspension immediately without using the ATTIME Suspend function. The status will change to SUSPOP without waiting for data copying to finish.

  • ATTIME PRESET: Uses the ATTIME Suspend function. This cannot be selected if no consistency group ID is specified or if the dialog box was displayed from the pair action menu.

  • ATTIME CANCEL: Cancels the suspend time. This cannot be selected if no consistency group ID is specified or if the dialog box was displayed from the pair action menu.

You can only enter values for the following item when ATTIME PRESET or ATTIME CANCEL is selected from Suspend option:

Item

Description

ATTIME preset /cancel mode

Specify the type of the ATTIME Suspend function to be used.

  • NORMAL: Uses the NORMAL ATTIME suspend function or the TC ATTIME suspend function.

  • UR: Uses the UR ATTIME suspend function.

You can only enter values for the following items when ATTIME PRESET is selected from Suspend option:

Item

Description

ATTIME split mode

Specify the operating mode during transition to the suspend status.

  • (copy group definition value): The value in the copy group definition file (the AttimeSplitMode attribute value) will be applied.

  • STEADY: The status will change to SUSPOP after data copying finishes.

  • QUICK: The status will change to SUSPOP without waiting for data copying to finish.

ATTIME date (yyyymmdd)#

Specify the ATTIME suspend date. If this is omitted, the current date is assumed.

  • yyyy: Specify the year (1970 to 2042).

  • mm: Specify the month (01 to 12).

  • dd: Specify the date (01 to 31).

ATTIME local time (hhmmss)#

Specify the ATTIME suspend time (in local time). If this is omitted, the current time is assumed.

  • HH: Specify the time (00 to 23).

  • MM: Specify the minute (00 to 59).

  • SS: Specify the second (00 to 59).

ATTIME plus time(sec)#

Specify the offset value to be added to the ATTIME suspend time in second (00 to 86399).

When this is omitted, 120 seconds are assumed if neither ATTIME date nor ATTIME local time is specified, and 0 seconds are assumed in other cases.

ATTIME timeout (min)

Specify the ATTIME Suspend timeout time in minutes (the TIMEOUT parameter value of the YKSUSPND command) within the range from 0 to 9999.

ATTIME generation ID

Specify the GENID parameter of the YKSUSPND command within the range from 00 to FF.

The specified number can be used to identify the generation of backups.

#: The ATTIME suspend date and time is calculated by adding the time specified by ATTIME plus time to the date and time specified by ATTIME date and ATTIME local time. You can neither specify any date and time that is 65,536 or more minutes later than the current date and time nor an ATTIME suspend date and time that is less than one minute later than the current date and time.

TrueCopy copy group

Item

Description

Pair state goto

This is the final copy pair status after normal termination of the copy pair operation. The copy group will be monitored until all the copy pairs in the copy group change to this status or until one of the copy pairs changes to abnormal status.

  • SUSPEND: If you specify SUSPEND, the final copy pair status is SUSPOP or SWAPPING.

  • SWAP2SUS: If you specify SWAP2SUS, the final copy pair status is SUSPOP, SUSPER, or SUSPCU.

Pair selection

Specify SELECT parameter of YKSUSPND command i.e. how to select a copy pair to be manipulated.

  • ALL: Selects all copy pairs as targets.

  • COND: Selects target copy pairs based on the volume status of the copy pair.

Secondary Volumes R/W

Specify whether to permit updates to S-VOLs after suspension (the SVOL parameter of the YKSUSPND command).

  • (Copy group definition value): Applies the ProtectMode attribute value of the copy group definition file.

  • PROTECT: Prohibits updates.

  • PERMIT: Permits updates.

When changing the status to SWAPPING or to a suspend status from the SWAPPING status, this specification will be ignored, and the settings will permit writing to S-VOLs.

Volunit

Specify whether to perform copy group operation by volume (the VOLUNIT parameter value of the YKSUSPND command). You cannot make any selection in the dialog box displayed from the pair action menu.

  • NO: Performs operations on a group basis if this is supported by the environment.

  • YES: Performs operations on a volume basis, even for an environment that supports operations on a group basis during specification.

Copy direction

Specify the copy direction after suspension and copy pair resynchronization.

  • (No change): Specify this parameter when you do not want the copy direction to change after copy pair resynchronization.

  • FORWARD: Specify this parameter when you want the copy direction to be from the primary site to the secondary site after copy pair resynchronization.

  • REVERSE: Specify this parameter when you want the copy direction to be from the secondary site to the primary site after copy pair resynchronization.

Universal Replicator copy group

Item

Description

Pair state goto

This is the final copy pair status after normal termination of the copy pair operation. The copy group will be monitored until all the copy pairs in the copy group change to this status or until one of the copy pairs changes to abnormal status.

  • SUSPEND: If you specify SUSPEND, the final copy pair status is SUSPOP or SWAPPING.

  • HOLD: If you specify HOLD, the final copy pair status is HOLD.

  • SWAPPING: If you specify SWAPPING, the final copy pair status is SWAPPING.

  • SWAP2SUS: If you specify SWAP2SUS, the final copy pair status is SUSPOP, SUSPER, or SUSPCU.

Pair selection

Specify SELECT parameter of YKSUSPND command i.e. how to select a copy pair to be manipulated.

  • ALL: Selects all copy pairs as targets.

  • COND: Selects target copy pairs based on the volume status of the copy pair.

Secondary volumes R/W

Specify the SVOL parameter of the YKSUSPND command (the option related to updating of S-VOLs after suspension).

  • (Copy group definition value): Applies the ProtectMode attribute value of the copy group definition file.

  • PROTECT: Prohibits updates.

  • PERMIT: Permits updates.

When changing the status to SWAPPING or to a suspend status from the SWAPPING status, this specification will be ignored, and the settings will permit writing to S-VOLs.

Volunit

Specify whether to perform copy group operation by volume (the VOLUNIT parameter value of the YKSUSPND command). You cannot make any selection in the dialog box displayed from the pair action menu.

  • NO: Performs operations on a group basis if this is supported by the environment.

  • YES: Performs operations on a volume basis, even for an environment that supports operations on a group basis during specification.

Suspend option

Specify YKSUSPND command parameters.

  • FLUSH: Suspends the copy pair after all pending data is synchronized. Since the suspension is performed when data up until the time of the suspend request is synchronized, the system does not wait for updating to finish. Data updated after the suspend request is managed by main control unit and remote control unit as differential data, and becomes a differential copy target when the copy pair is resynchronized.

    The currently specified copy direction will not change when a copy pair is resynchronized.

  • PURGE: When this is specified, the copy pair is suspended when a suspend request is issued, even if unsynchronized data remains. Unsynchronized data is managed by main control unit and remote control unit as differential data, and becomes a differential copy target when the copy pair is resynchronized.

    The currently specified copy direction will not change when a copy pair is resynchronized.

    This cannot be selected from the dialog box displayed from the pair action menu.

  • FORWARD: Specify this parameter when you want the copy direction to be from the primary site to the secondary site after copy pair resynchronization.

  • REVERSE: Specify this parameter when you want the copy direction to be from the secondary site to the primary site after copy pair resynchronization.