YKDEXCTG (deletes a journal group from EXCTG)

Business Continuity Manager Web API Reference Guide

Version
9.9.1
Audience
anonymous
Part Number
MK-96HC137-03

Applies to Universal Replicator.

This command dissolves the journal group in the specified copy group container with EXCTG ID from an EXCTG.

Request body format

{ "action":"submit",
   "cliname":"YKDEXCTG",
   "operands" : "
     [GROUP(copy-group-ID)]
     [△1SN(storage-system-serial-number)
     [△1JNLG(journal-ID)]]
   "
}

Parameters specified in the request body

GROUP(copy-group-ID) ~ <GROUP string>

Specify the ID of the target copy groups that are loaded. If only one copy group is loaded, you can omit this parameter.

SN(storage-system-serial-number) ~ <from 5 to 12 alphanumeric characters>

Specify the serial number of the storage system that contains journal groups to be dissolved from an EXCTG. All journal groups contained in the specified storage system within the copy group container with EXCTG ID are dissolved.

If this parameter is omitted, all journal groups within the copy group container with EXCTG ID are dissolved.

Among the storage systems specified for the SN parameter, specify the journal ID of the journal group to be dissolved from an EXCTG. Specify either the journal ID of the primary site or the journal ID of the secondary site.

Notes

  • If a journal group that was already dissolved from an EXCTG is included in the journal groups to be dissolved, the YKZ257E message is output. However, journal groups that can be dissolved will be dissolved.

  • A journal group cannot be dissolved from an EXCTG while the processing to register the journal group in the EXCTG is still running. Wait for the registration processing to finish, and then execute the YKDEXCTG command again.

Return code

If the CLI command has finished running, the return code of the CLI command is set in the rc key of the response. If an error occurs before the CLI command is run, the BCM Web API server sets the return code.

The following table lists and describes the return codes of the YKDEXCTG command.

Table. YKDEXCTG command return code list

Return code

Meaning

-3

The module cannot be loaded. Possible causes are as follows:

  • The library dataset has not been linked.

  • The module is protected by the RACF program control function.

-1

An interruption occurred during execution.

0

The command terminated normally.

32

  • An I/O error occurred. For example, as in the following case:

    • A journal group that was already dissolved from an EXCTG is included in journal groups to be dissolved.

    • A copy group container that is not registered in an EXCTG is specified.

  • A change was detected in the I/O configuration definition.

36

An invalid or unknown element was found in a REXX variable structure.

44

The command terminated due to a processing error.

48

The command terminated due to invalid parameters. For example, as in the following case:

  • The JNLG parameter is specified but the SN parameter is not specified.

  • No journal group exists in the storage system specified for the SN parameter.

  • The journal specified for the JNLG parameter does not exist in the storage system specified for the SN parameter.

128

The command terminated abnormally. Alternatively, the user does not have permission to execute this command.

For details about return codes set by the BCM Web API server, see Return codes set by the BCM Web API server.