The TSO command RSESSION is used to set up and manage a Global Mirror session; see
Example 24-15. This includes the ability to define a Global Mirror session by means of the
ACTION(DEFINE) parameter option. Other options that can be specified for the ACTION
parameter are: START and STOP a Global Mirror session, as well as PAUSE and RESUME
of the session, or to UNDEFINE the session.
This example also shows that you have to define this Global Mirror session number to all
LSSs at the primary site that will hold the Global Copy primary volumes that are going to be
part of this session.
As with all TSO commands, you can issue this command interactively through ISPF menu 6,
or from the TSO READY status. In the z/OS SYSLOG this RSESSION command is only
logged as the command itself but not the response to this command. It is, therefore,
recommended to always use TSO in batch for documentation purposes and to be able to
track all commands and their outcomes.
24.3.6 Populate a Global Mirror session with volumes
After you successfully defined a Global Mirror session, you populate the session with the
Global Copy primary volumes. These are all the primary A volumes that are going to
participate in the Global Mirror session at the local site; see Example 24-16.
Example 24-16 Add Global Copy primary volumes to Global Mirror session
//* ---------------------------- TSO ------------ CREATE (5) ----- ***
//* POPULATE SESSION X'01' WITH PRIMARY VOLUMES
//*
//*
//* -------------------------------------------------------------- ***
//JOIN
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN
RVOLUME
RVOLUME
Example 24-16 shows the TSO command RVOLUME. To populate the Global Mirror session
with Global Copy volumes you use the ACTION(JOIN) parameter value.
With this command you also remove the Global Copy primary volumes from the session. The
corresponding parameter value for this action is ACTION(REMOVE).
With the VOLLIST or VOLRANGE parameters, you define the volumes that are added to the
session or removed from the session. VOLLIST is a list of channel connection addresses
(CCA) that identify the A volumes. VOLRANGE allows you to specify a range of CCAs. In
Example 24-16, a volume with CCA x'00' from LSS x'0C' is added to the session number
x'01'. Two more volumes from LSS x'0D'are added to the session. This is indicated by the
VOLRANGE parameter value 00:01, which adds volumes from CCA x'00' to CCA x'01'.
VOLUME LIST CONTAINS CCA NUMBERS
EXEC PGM=IKJEFT01
DD DDNAME=SYSIN
SNBR(01) VOLSER(XX2C00)
ACTION
(JOIN)
LSSTYPE (CKD) LSSNBR(0C)
ESSSERIAL(27131)
VOLLIST (00)
SNBR(01) VOLSER(XX2D00)
ACTION
(JOIN)
LSSTYPE (CKD) LSSNBR(0D)
ESSSERIAL(27131)
VOLRANGE (00:01)
***
***
***
+
+
+
+
+
+
+
+
Chapter 24. Global Mirror interfaces
309