Commands

This chapter provides a description of the syntax and semantics of all SHC-OSD commands. An overview of all the commands is provided on the next page.

The commands are described in alphabetical order, and the descriptions have the following structure:

• the command name and function

• a description of the command function

• an illustration of the command format

• a description of the command operands

• information on command processing, if necessary

• one or more examples, if necessary

• for SHOW commands: output formats

• for SHOW commands: output in S variables

• a description of the command return codes

The 1st volume of the manual “Commands” [1] provides general explanations regarding the metasyntax used, the command return codes and display of S variables.

Command overview

Command	Function
ACTIVATE-CLONE	Activates a clone pair
FAILBACK-STORAGE-CLUSTER	Executes failback in a Storage Cluster
FAILOVER-STORAGE-CLUSTER	Executes failover in a Storage Cluster
HOLD-REMOTE-COPY	Interrupts remote copy mode
MODIFY-REMOTE-COPY-PARAMETER	Changes the processing mode and remote copy parameters
MODIFY-SHC-ENVIRONMENT	Modify configuration of the external servers
MODIFY-SHC-PROCESSING	Changes settings of SHC-OSD
RESTART-CLONE-SESSION	Re-creating a clone pair
RESTORE-FROM-CLONE	Reconstructs an original from a clone unit
RESTORE-FROM-SNAP	Reconstructs an original from a snap unit
RESUME-IO	Resume input/output activity
RESUME-REMOTE-COPY	Resumes remote copy mode
SHOW-CLONE-SESSION-STATUS	Displays the status of clone pairs
SHOW-REMOTE-COPY-STATUS	Displays the status of remote copy pairs
SHOW-SHC-ENVIRONMENT	Displays configuration of the external servers
SHOW-SHC-PROCESSING	Displays settings of SHC-OSD
SHOW-SNAP-SESSION-STATUS	Displays the status of snap pairs
SHOW-STORAGE-CLUSTER-CONFIG	Displays configurations of Storage Clusters
SHOW-STORAGE-CONFIGURATION	Displays storage configuration
SHOW-STORAGE-DEVICE-CONFIG	Displays storage device configuration
START-CLONE-SESSION	Creates a clone pair
START-REMOTE-COPY	Creates a remote copy pair
START-SNAP-SESSION	Creates a snap pair
STOP-CLONE-SESSION	Cancels a clone pair
STOP-REMOTE-COPY	Cancels a remote copy pair
STOP-SNAP-SESSION	Cancels a snap pair
SWAP-CLONE-SESSION	Swaps original and clone attributes of a clone pair
SWAP-REMOTE-COPY	Swaps the source and target property of a remote copy pair

Commands according to function groups

An overview of the commands for the functions can be found in the chapters with the related functional description:

• for local replication with clones on "Local replication with clones (ETERNUS DX/AF)"

• for local replication with snapshots on "Local replication with snapshots (ETERNUS DX/AF)"

• for remote replication with REC on "Remote replication with REC (ETERNUS DX/AF)"

• for thin provisioning on "Thin provisioning (ETERNUS DX/AF)"

• for Automated Storage Tiering on "Automated Storage Tiering (ETERNUS DX/AF)"

• for Storage Cluster on "Storage Cluster Option (ETERNUS DX/AF)"

Commands for controlling the internal settings

Command	Function
MODIFY-SHC-ENVIRONMENT	Modify configuration of the external servers
MODIFY-SHC-PROCESSING	Changes settings of SHC-OSD
SHOW-SHC-ENVIRONMENT	Displays configuration of the external servers
SHOW-SHC-PROCESSING	Displays settings of SHC-OSD

The internal settings for execution, maintenance and diagnostics of the SHC-OSD subsystem can be displayed and modified dynamically. This option complements the settings via the SHC-OSD parameter file (see section "Configuration of SHC-OSD").

SHOW commands

Command	Function
SHOW-CLONE-SESSION-STATUS	Displays the status of clone sessions
SHOW-REMOTE-COPY-STATUS	Displays the status of remote copy pairs
SHOW-SHC-ENVIRONMENT	Displays configuration of the external servers
SHOW-SHC-PROCESSING	Displays settings of SHC-OSD
SHOW-SNAP-SESSION-STATUS	Displays the status of snap sessions
SHOW-STORAGE-CLUSTER-CONFIG	Displays the configuration of Storage Clusters
SHOW-STORAGE-CONFIGURATION	Displays the configuration
HOW-STORAGE-DEVICE-CONFIG	Displays device configuration

The SHOW commands support the structured output to S variables.