Previous Topic

Next Topic

Book Contents

Book Index

Coding the network map

When coding the network map in the IOA.PARM library member with the name specified in the ECAPARM NETWMAP parameter, BMC recommends that you code the network map for the whole network and distribute this member to all sites that run IOAGATE. Each IOAGATE is able to extract the relevant information for itself from the same global map definitions.

All the parameters in the network map are mandatory.

The following are sample coded network maps that correspond to the sample configuration illustrated in Example.

Figure 55 Sample coded network map for SNA

LOCAL  APPL=CONTROLO,NODE=GATE01                                

       PARTNER APPL=CONTROLO,NODE=GATE02,LUNAME=LU02            

       PARTNER APPL=CONTROLO,NODE=GATE03,LUNAME=LU03            

LOCAL  APPL=CONTROLO,NODE=GATE02                                

       PARTNER APPL=CONTROLO,NODE=GATE01,LUNAME=LU01            

LOCAL  APPL=CONTROLO,NODE=GATE03                                

       PARTNER APPL=CONTROLO,NODE=GATE01,LUNAME=LU01            

Figure 56 Sample coded network map for TCP

LOCAL  APPL=CONTROLO,NODE=GATE01                                

       PARTNER APPL=CONTROLO,NODE=GATE02,HOST=HOST2,            

       PORT=2760,CONNECTOR=LOCAL                                

       PARTNER APPL=CONTROLO,NODE=GATE03,HOST=HOST3,            

       PORT=2760,CONNECTOR=LOCAL                                

LOCAL  APPL=CONTROLO,NODE=GATE02                                

       PARTNER APPL=CONTROLO,NODE=GATE01,                       

       CONNECTOR=PARTNER                                        

LOCAL  APPL=CONTROLO,NODE=GATE03                                

       PARTNER APPL=CONTROLO,NODE=GATE01,                       

       CONNECTOR=PARTNER       

Each LOCAL statement defines a specific IOAGATE in the network. Each PARTNER statement under the LOCAL statement defines another remote IOAGATE with which this specific IOAGATE will communicate.

When an IOAGATE starts, it reads the network map member specified in the ECAPARM member and locates the LOCAL statement that corresponds to that IOAGATE. This LOCAL statement is the one that has the same value in the NODE parameter as the value coded in the NODE parameter of the ECAPARM member.

In the sample network map in Figure 43, because the IOAGATE on MF01 in Figure 42 has NODE set to GATE01 in the ECAPARM member, that IOAGATE locates the first LOCAL statement in the network map. That IOAGATE establishes a connection with each partner IOAGATE specified in the PARTNER statements under that LOCAL statement.

Considerations For SNA — The connection to the partner IOAGATE is the LUNAME specified on the PARTNER statement. This LUNAME must match the APPLID in the ECAPARM member of the partner IOAGATE. Each IOGATE initiates a connection to its partner IOAGATEs, so that between each pair of IOAGATEs there are two connections.

For example, in the configuration illustrated in Figure 42, the IOAGATE on MF01 connects to both LU02, which is the IOAGATE on MF02 (because it has APPLID=LU02), and LU03, which is the IOAGATE on MF03.

Note: Each connection must be defined in both directions. If a connection is defined between CONTROLO on GATE01 and CONTROLO on GATE02, define both CONTROLOs as LOCALs connecting to each other as PARTNERs. A connection defined only in one direction cannot be established by IOAGATE.

Considerations For TCP — The connection to the partner IOAGATE is to the host and port specified by the HOST and PORT parameters, but only if CONNECTOR is set to LOCAL. If CONNECTOR is set to PARTNER, IOAGATE waits for the partner IOAGATE to initiate the connection. Therefore, you must define one IOAGATE with CONNECTOR set to LOCAL and the other with CONNECTOR set to PARTNER.

The PORT parameter defined in the MAP must match the port on which the partner IOAGATE listens for incoming connections. That port is defined in the ECAPARM CHANNEL statement of the partner IOAGATE.

Note: In TCP, only one side initiates the connection.

For example, in the configuration illustrated in Figure 42.

The value of APPL can be any of the following:

Parent Topic

IOAGATE network map