Example: restarting an inactive XRC coupled session after an error occurs

The following scenario describes how to restart an inactive coupled XRC session after an error has occurred on the session. Issue the XQUERY MASTER command to determine if an XRC session is inactive. The session status of UNK may indicate that a coupled XRC session is inactive. You can issue an XQUERY SUMMARY command on the system from which the XRC session is running to determine if the session is still active.

First, an error occurs on session PHOENIX; session TUCSON reacts and suspends all volumes to the msession recovered time.

Result: This is an example of the message that was generated:

ANTC8402W XRC SESSION(TUCSON) COUPLED TO MSESSION(CXRC) DETECTED  
COUPLING_TIMEOUT CONDITION IN XRC_SESSION(PHOENIX),                   
ANTC8402W (CONT) SUSPENDING ALL VOLUMES                               

ANTV8107I SUSPEND COMPLETE FOR VOLUME PAIR(PRIM01,SEC001) FOR SESSION(TUCSON)
   AT CONSISTENCY_GROUP TIME(2004.080 ANTV8107I (CONT) 22:35:21.643364)                                        
ANTV8107I SUSPEND COMPLETE FOR VOLUME PAIR(PRIM02,SEC002) FOR SESSION(TUCSON)
   AT CONSISTENCY_GROUP TIME(2004.080 ANTV8107I (CONT) 22:35:21.643364)

Perform the following steps to restart an inactive XRC coupled session after an error occurs:

Issue the following command to generate an XQUERY MASTER report:

XQUERY CXRC MASTER

Result: The following output is generated from an XQUERY MASTER report for the master session named CXRC, with a default master high-level qualifier of SYS1:

ANTQ8300I XQUERY STARTED FOR MSESSION(CXRC) MHLQ(SYS1)            
ANTQ8202I XQUERY MASTER REPORT - 002                                    
ANTQ8302I SESSION   STA VOL INT CMD   JOURNAL DELTA      RCV/ADV DELTA  
ANTQ8303I ------------------------------------------------------------- 
ANTQ8304I TUCSON    ACT SYM  Y       +00:00:03.824936  =00:00:00.000000 
ANTQ8304I PHOENIX   UNK      Y       =00:00:00.000000  +00:00:03.470722 
ANTQ8305I TOTAL=2  ACT=1  SUS=0  END=0  ARV=0  RCV=0  UNK=1             
ANTQ8306I MSESSION STATUS=HOLD                                          
ANTQ8308I MSESSION RECOVERABLE TIME(2004.080 22:35:21.643364)           
ANTQ8309I INTERLOCKED=2  NON-INTERLOCKED=0                              
ANTQ8301I XQUERY MASTER REPORT COMPLETE FOR MSESSION(CXRC)

Determine why the XRC session PHOENIX did not respond so you can resolve the error. The XRC session PHOENIX might have ended for one of the following reasons:
- The logical partition on which the XRC session PHOENIX was running had to be IPLed (Initial Program Load).
- The XRC address space was canceled for this XRC session.
- The logical partition where this XRC session was running lost connectivity to the master data set.
Correct the problem for XRC session PHOENIX.

Issue the following command to apply journal data to the XRC session PHOENIX. The XRC session PHOENIX has a positive RCV/ADV DELTA time. Issue the XADVANCE command on the system from which PHOENIX is running.

XADVANCE PHOENIX

The XADVANCE command brings the consistency time of the session up to the msession recoverable time.

Result: The processing of the XADVANCE command generates the following XQUERY output:

ANTQ8300I XQUERY STARTED FOR MSESSION(CXRC) MHLQ(SYS1)            
ANTQ8202I XQUERY MASTER REPORT - 002                                    
ANTQ8302I SESSION   STA VOL INT CMD   JOURNAL DELTA      RCV/ADV DELTA  
ANTQ8303I ------------------------------------------------------------- 
ANTQ8304I TUCSON    ACT SYM  Y       +00:00:03.824936  =00:00:00.000000 
ANTQ8304I PHOENIX   UNK      Y       =00:00:00.000000  +00:00:00.000000 
ANTQ8305I TOTAL=2  ACT=1  SUS=0  END=0  ARV=0  RCV=0  UNK=1             
ANTQ8306I MSESSION STATUS=HOLD                                          
ANTQ8308I MSESSION RECOVERABLE TIME(2004.080 22:35:21.643364)           
ANTQ8309I INTERLOCKED=2  NON-INTERLOCKED=0                              
ANTQ8301I XQUERY MASTER REPORT COMPLETE FOR MSESSION(CXRC)

Perform your installation backup procedures to back up the data on your secondary devices for both sessions. Both sessions are consistent to the msession recoverable time.
Issue the XSTART command to restart the XRC session PHOENIX.
```
XSTART PHOENIX SESSIONTYPE(XRC) ERRORLEVEL(SESSION)
```

Issue the following command to generate an XQUERY MASTER report:

XQUERY CXRC MASTER

Result: The following output is generated from an XQUERY MASTER report for the master session named CXRC, with a default master high-level qualifier of SYS1:

ANTQ8300I XQUERY STARTED FOR MSESSION(CXRC) MHLQ(SYS1)            
ANTQ8202I XQUERY MASTER REPORT - 002                                    
ANTQ8302I SESSION   STA VOL INT CMD   JOURNAL DELTA      RCV/ADV DELTA  
ANTQ8303I ------------------------------------------------------------- 
ANTQ8304I TUCSON    ACT SYM  Y       +00:00:03.824936  =00:00:00.000000 
ANTQ8304I PHOENIX   ACT ERR  Y       =00:00:00.000000  +00:00:00.000000 
ANTQ8305I TOTAL=2  ACT=2  SUS=0  END=0  ARV=0  RCV=0  UNK=0             
ANTQ8306I MSESSION STATUS=HOLD                                          
ANTQ8308I MSESSION RECOVERABLE TIME(2004.080 22:35:21.643364)           
ANTQ8309I INTERLOCKED=2  NON-INTERLOCKED=0                              
ANTQ8301I XQUERY MASTER REPORT COMPLETE FOR MSESSION(CXRC)

Issue the XCOUPLE command with the RELEASE option to release the master session named CXRC, with a default master high-level qualifier of SYS1, from HOLD status.
```
XCOUPLE CXRC RELEASE SYS1
```
See What to do if the master session is in coupled HOLD status for additional information regarding the HOLD status for a master session.

Issue the XQUERY command after you issue the XCOUPLE command to ensure that the status of the master session named CXRC, with a default master high-level qualifier of SYS1, is no longer in HOLD status.

XQUERY CXRC MASTER

Result: The command will generate the following output:

ANTQ8300I XQUERY STARTED FOR MSESSION(CXRC) MHLQ(SYS1)           
ANTQ8202I XQUERY MASTER REPORT - 002                                   
ANTQ8302I SESSION   STA VOL INT CMD   JOURNAL DELTA      RCV/ADV DELTA 
ANTQ8303I -------------------------------------------------------------
ANTQ8304I TUCSON    ACT AVS  N                                         
ANTQ8304I PHOENIX   ACT AVS  N                                         
ANTQ8305I TOTAL=2  ACT=2  SUS=0  END=0  ARV=0  RCV=0  UNK=0            
ANTQ8308I MSESSION RECOVERABLE TIME(NO_TIME_AVAILABLE)                 
ANTQ8309I INTERLOCKED=0  NON-INTERLOCKED=2                             
ANTQ8301I XQUERY MASTER REPORT COMPLETE FOR MSESSION(CXRC)

Issue the following command to add the volume pairs to the XRC session PHOENIX:
```
XADDPAIR PHOENIX(VOL1,VOL2)
```