Converting a Standalone Server System into One IBM Connect:Direct/Plex Setup
To convert two existing IBM® Connect:Direct® Stand-alone Server systems into one IBM Connect:Direct/Plex environment:
- Copy the the INITPARMs member for CD.PROD1 into $CD.PLEX.INITPARM as member CDPLX.
- Resolve any differences (other than data set names) between the new INITPARMS member and the CD.PROD2 INITPARMS member.
- Copy the CD.PROD1 IBM Connect:Direct/Plex startup JCL into $CD.PLEX.JCL as member CDMGR.
- Resolve any differences, such as trace DDs, with the CD.PROD2 startup JCL.
- Merge the existing AUTH and TYPE files from both systems as described in IBM Connect:Direct/Plex System File Considerations, using the same files names used for CD.PROD1.
- Create new TCQ/TCX, CKPT, and statistics file pairs as discussed in CKPT file, using the same file names used for CD.PROD1.
- Merge the source from the individual network map files as described in NETMAP file.
- Change the new network map source (created from the merged
network map files) as follows:
- Specify new APPLIDs and a new LOCAL.NODE name for the
LOCAL.NODE and the PNODE/SNODE ADJACENT.NODE.
Because the existing APPLIDs are used for SERVER1, you do not need to change the external IBM Connect:Direct connections.
- Specify USE.SERVER.NODE=YES on all ADJACENT.NODE records.
- Use the same local node name that is used for CD.PROD1.
- Load the network map.
- Specify new APPLIDs and a new LOCAL.NODE name for the
LOCAL.NODE and the PNODE/SNODE ADJACENT.NODE.
- Add the following initialization parameters to the CDPLX
member in $CD.PLEX.INITPARM. This member becomes the IBM Connect:Direct/Plex
global initialization parameters file.
CDPLEX=YES CDPLEX.MAXSERVER = number of servers | 4 XCF.NAME=8-char-name
The CDPLEX=YES parameter indicates a IBM Connect:Direct/Plex environment. It also directs the DTF to read its local initialization parameters from the file specified in the //CDPLEX DD statement in the startup JCL.
The CDPLEX.MAXSERVER parameter specifies the maximum number of servers the Connect:Direct/Plex Manager will manage. For more information, see Storage Requirements in a IBM Connect:Direct Environment in the IBM Connect:Direct for z/OS® Configuration Guide.
The XCF.NAME parameter specifies a unique name used by the z/OS XCF to assist communications among IBM Connect:Direct/Plex members. This name indicates that the IBM Connect:Direct Manager and IBM Connect:Direct Servers are part of the same XCF group.
- You can add the following optional parameters to the CDPLX
member in $CD.PLEX.INITPARM:
- CDPLEX.TIMER = 5 | number of minutes specifies the time-out value for XCF communications in minutes.
- CDPLEX.WLM.GOAL = (NO | YES) specifies whether IBM Workload Manager (WLM) Goal Mode queries are made. This parameter is optional.
- Create the local initialization parameters files for each IBM Connect:Direct/Plex
member:
- Copy the DGAITMGR, DGAISRV1, and DGAISRV2 sample local initialization parameters members from the IBM Connect:Direct $CD.SDGAPARM library into $CD.PLEX.SDGAPARM as members MANAGER, SERVER1, and SERVER2.
- Change the TCP.LISTEN parameter of the MANAGER member
to specify the TCP/IP stack address used by the IBM Connect:Direct/Plex
Manager.
You need not change any other parameters need in the MANAGER member.
CDPLEX.MANAGER=YES TCP.LISTEN=(nnn.nnn.nnn.nnn,port) CDPLEX.SERVER.JOBDSN=$CD.PLEX.JCL CDPLEX.SERVER.JOBMEM=((CDSRV1,SERVER1), - (CDSRV2,SERVER2))
- Change the CDPLEX.VTAM parameter in the SERVER1 member
as follows:
- Replace the applid11 value with the VTAM APPLID from CD.PROD1 for SNA copy Processes.
- Replace the applid12 value with the VTAM APPLID from CD.PROD1
for the PNODE-SNODE APPLID.
These APPLIDs must be unique across the IBM Connect:Direct/Plex and cannot be the same as those specified in the new network map.
CDPLEX.MANAGER=NO CDPLEX.SERVER=SERVER1 CDPLEX.VTAM=(applid11,applid12,applid13) CDPLEX.PLEXCLASSES=(TAPE,*) TCP.LISTEN=(nnn.nnn.nnn.nnn,port)
- Change the TCP.LISTEN parameter in the SERVER1 member to specify the TCP/IP stack address used by this IBM Connect:Direct/Plex server.
- Change the TCP.LISTEN parameter in SERVER1 member to
the TCP.LISTEN value from CD.PROD1. Note: The CDPLEX.PLEXCLASSES parameter in SERVER1 specifies a ‘TAPE' PLEXCLASS. For Processes that require tape drives, specify the ‘TAPE' PLEXCLASS in their Process definitions. These Processes run on SERVER1. (See Building, Modifying, and Submitting Processes in IBM Connect:Direct for z/OS User Guide for more information on using PLEXCLASS in a Process.)
- Add the following statement to the SERVER1 member.
CDPLEX.SERVER.NODE=CD.PROD1
- Change the CDPLEX.VTAM parameter in the SERVER2 member
as follows:
- Replace the applid21 value with the VTAM APPLID from CD.PROD2 for SNA copy Processes.
- Replace the applid22 value with the VTAM APPLID from CD.PROD2
for the PNODE-SNODE APPLID.
These APPLIDs must be unique across the IBM Connect:Direct/Plex and cannot be the same as those specified in the new network map or used for SERVER1.
CDPLEX.MANAGER=NO CDPLEX.SERVER=SERVER2 CDPLEX.VTAM=(applid21,applid22) CDPLEX.PLEXCLASSES=(*) TCP.LISTEN=(nnn.nnn.nnn.nnn,port)
- Change the TCP.LISTEN parameter in the SERVER2 member to specify the TCP/IP stack address used by this IBM Connect:Direct/Plex server.
- Change the TCP.LISTEN parameter in the SERVER2 member to the TCP.LISTEN value from CD.PROD2.
- Add the following statement to the SERVER2 member.
CDPLEX.SERVER.NODE=CD.PROD2
- Add the CDPLEX DD statement in the following example to
the CDMGR member in $CD.PLEX.JCL. (This JCL is the startup JCL copied
earlier.)
//DTF EXEC DGADINIT, // PARM='$CD.PLEX.INITPARM(CDPLX)' //CDPLEX DD DISP=SHR,DSN=$CD.PLEX.INITPARM(MANAGER)
- Create the CDSRV1 member and copy CDMGR into it.
- Make the following changes to the CDSRV1 member:
- Change the job name so that this job can run simultaneously with the CDMGR JCL.
- Change the member name in the CDPLEX DD statement to
SERVER1 as follows. This directs the CDSRV1 JCL to its local initialization
parameters file.
//CDPLEX DD DISP=SHR,DSN=$CD.PLEX.INITPARM(SERVER1)
- Create the CDSRV2 member and copy CDSRV1 into it.
- Make the following changes to the CDSRV2 member:
- Change the job name so that this job can run simultaneously with the CDMGR JCL and CDSRV1 JCL.
- Change the member name in the CDPLEX DD statement to
SERVER2 as follows. This directs the CDSRV2 JCL to its local initialization
parameters file.
//CDPLEX DD DISP=SHR,DSN=$CD.PLEX.INITPARM(SERVER2)
Note: You can route jobs to a different z/OS image by specifying the local node name of the other system name in an XEQ statement in the IBM Connect:Direct Manager or Server JCL as follows:/*XEQ njenode [JES2] //*ROUTE XEQ njenode [JES3]
This example routes the job to the z/OS image identified by the local node name NJENODE.
- Submit the CDMGR JCL to bring up the IBM Connect:Direct/Plex.
After the IBM Connect:Direct Manager initializes, it submits the CDSRV1 JCL and CDSRV2 JCL to bring up the two IBM Connect:Direct Servers.
- After the IBM Connect:Direct Manager
initializes, use the IUI to signon to the IBM Connect:Direct Manager.
You can then submit Processes and perform other functions through the IUI.