Deleting an XRC volume pair

Use the XDELPAIR command to delete volumes or utility devices from an XRC session.

The XDELPAIR command returns a timestamp that identifies the application time that the volume was last consistent with the XRC session. After you issue the XDELPAIR command, XRC prompts you (unless you specified NOVERIFY) to confirm the request to delete the volumes. You can start the XDELPAIR command through a CLIST in either a foreground or a batch environment. If you do, you should either specify NOVERIFY or place your response to the prompt in the data stack. See the CLIST examples that follow.

If a volume pair has been removed from the session with XDELPAIR, it cannot be re-added until residual updates for the volume have been drained from the primary storage subsystem cache. This process can take several seconds to several minutes to complete, depending on the current XRC session delay.

Examples: The following are examples of commands to delete one or more volume pairs:

The following command deletes a volume pair from the XRC session:
```
 XDELPAIR DALLAS VOLUME(PRIM01)
```
The following command deletes three volume pairs from the XRC session and routes messages to user ID E299000:
```
 XDELPAIR DALLAS VOLUME(PRIM01)
```
```
XDELPAIR DALLAS VOLUME(PRIM01 PRIM02 PRIM03) MSGROUTEID(E299000)
```
You can process the following TSO CLIST in a standard TSO environment for commands that require a response. The following example shows how to use a CLIST to delete two volume pairs:
```
PROFILE MSGID
     CONTROL PROMPT
     XDELPAIR DALLAS VOLUME(PRIM01,PRIM02)
     DATA PROMPT
     YES
     ENDDATA
```

The following REXX EXEC example adds a new volume pair to the XRC session and deletes another pair from the session:

  /* REXX */
     'PROFILE MSGID'
     'PROFILE PROMPT'
     SETPROMPT=PROMPT('ON')
     'XADD   A V(XRCF40,SECF51)'
     PUSH 'YES'
     'XDEL   A V(XRCF26)'
     EXIT

You can submit the following batch job to the system:

 //XRCJOB   JOB   MSGLEVEL=(1,1),MSGCLASS=H,REGION=2048K,CLASS=A
     //XSTART   EXEC  PGM=IKJEFT01
     //STEPLIB  DD    DSN=IBMUSER.CLIST.CLIST,DISP=SHR
     //SYSTSPRT DD    SYSOUT=*
     //SYSTSIN  DD    *
       PROFILE MSGID
       EXEC 'TSOUSER.CLIST.CLIST(JOB)' C
     /*

The above JCL starts the following CLIST. The CLIST is in the data set TSOUSER.CLIST.CLIST.

 CONTROL PROMPT
    PROFILE MSGID
    XDEL NEVADA V(PRIM00)
    DATA PROMPT
    YES
    ENDDATA

Note: You do not need to include the SETPROMPT and PUSH statements if you specify the NOVERIFY option.

For additional information about the XDELPAIR command and how to use XRC utility devices, refer to XDELPAIR–Deleting volume pairs and Using XRC utility devices.