Understanding the XADDPAIR command

The following are examples of XADDPAIR commands:

To add utility volumes and regular volume pairs to two storage controls, use the following commands:

XADDPAIR DALLAS VOLUME(PRIMA1 XRCUTL,PRIMB1 XRCUTL)
     XADDPAIR DALLAS VOLUME(PRIMA2 SEC001,PRIMB2 SEC002)

To add utility volumes and volume pairs to two storage controls, use the following command:

 XADDPAIR DALLAS VOLUME(PRIMA1 XRCUTL,PRIMB1 XRCUTL,PRIMB2 SEC001,
              PRIMB2 SEC002)

To copy primary volumes PRIM01 and PRIM02 to secondary volumes SECO01 and SECO02 to an XRC session called Dallas, issue the following command. A blank or comma is used to separate each primary and secondary volume serial number within each pair; a comma is used to separate the pairs.
```
XADDPAIR DALLAS VOLUME(PRIM01 SECO01,PRIM02 SECO02) 
```
To add a volume pair to an XRC session called Dallas, route XRC messages to user ID E299000, and specify that XRC only copy updates to the primary volume, issue the following command. XRC does not copy the initial volume image
```
XADDPAIR DALLAS VOLUME(PRIM01 SECO01,PRIM02 SECO02)
              MSGROUTEID(E299000) NOCOPY
```
Note: XRC ignores the NOCOPY keyword, however, if you issue this XADDPAIR command to resynchronize the volume pair.
To add volume pairs to an XRC session called Dallas so that both pairs belong to a group that is called DB2GROUP, issue the following command:
```
 XADDPAIR DALLAS VOLUME(PRIM01 SECO01,PRIM02 SECO02)
              ERRORLEVEL(DB2GROUP)
```
To add volume pairs with an SCSESSION keyword, use the following command. In this example, the command adds two volume pairs to the storage control session called GA. The XADDPAIR SCSESSION keyword provides a way to manage volumes for a single storage control. If there are multiple storage control sessions within that storage control, then all of the sessions are affected.
```
 XADDPAIR DALLAS VOLUME(PRIM01 SECO01,PRIM02 SECO02)
              SCSESSION(GA) 
```

Guideline: For the best SDM performance, assign heavy use volumes to separate storage control sessions.