rmstorsys

Edit online

Use the rmstorsys command to remove a specific storage system and its volumes connected through a z/OS® connection to the copy services management server configuration.

Syntax

Read syntax diagramSkip visual syntax diagramrmstorsys-help-h-?-quiet -conntypezos -devdevice_id

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-quiet
Suppresses the confirmation prompt for this command. This flag answers yes to all confirmation prompts.
-conntype zos
Specifies the type of connection that the storage systems uses. Currently, you can specify only zos for a z/OS connection.
-dev device_id
Specifies the ID of the DS or ESS storage system that is to be removed from the configuration.
Tip: Use the lsdevice command to display a list of valid storage system IDs.

Description

Important:
  • You must have Administrator privileges to run this command.
  • You can run this command only from the copy services management server that is installed on a system running the z/OS operating system.
  • This command removes only the z/OS connection to the specified storage system. To remove other connection types to the same storage system, use the rmdevice or rmmc command.
If copy services management server has multiple connections to a storage system, the order in which you remove the connections produces different results:
  • If you remove direct and HMC connections first, the fixed-block and non-attached CKD volumes that are attached through these connection types are removed from the copy services management server configuration.
  • The remaining CKD volumes that are attached through the z/OS host connection remain in the copy services management server configuration until the z/OS host connection is removed.
  • If you remove the z/OS host connection first and there is an HMC or direct connection to volumes, those volumes are not removed from the copy services management server configuration.

To remove a storage system that is attached through a direct connection, use the rmdevice command. To remove a storage system that is attached through an hardware-management-console (HMC) connection, use the rmmc command.

Example: Removing the z/OS connection

This example illustrates how to remove the z/OS connection to the storage system with ID ESS:BOX:2105.12345.

csmcli> rmstorsys -dev ESS:BOX:2105.12345 -conntype zos

The following output is returned:

IWNH1614I  The storage device at ESS:BOX:2105.12345 was successfully removed.