The BEACONN file also includes a sample session definition. When placed on the remote host, it defines the logical links by which the ATMI platform local domain communicates with the remote host.

The name of the sample session definition is BEATEST, which is located under the installation group named BEACONN. The following listing shows an example of a BEACONN file session definition.

Listing Sample Session Definition in BEACONN File

DEFINE CONNECTION(BEA)     GROUP(BEACONN)
       DE(TUXEDO MAINFRAME ADAPTER FOR SNA EXAMPLE RDO CONNECTION)
       ACCESSMETHOD(VTAM)  PROTOCOL(APPC)
       NETNAME(**LOCALLU**)
       ATTACHSEC(LOCAL)    AUTOCONNECT(NO)

AUTOCONNECT indicates how the activation of the session is to be negotiated. YES enables the CICS/ESA host to negotiate its own winner sessions when the connection is bound. Remember that the Oracle Tuxedo Mainframe Adapter for SNA software must acquire the connection instead of the CICS/ESA host. However, when the stack acquires the connection, it can only bind the number of sessions identified as its winners. Setting the AUTOCONNECT parameter to YES causes the host to bind winner sessions immediately when the connection is acquired. Otherwise, the host’s outbound clients must wait for winner sessions to bind.

Replace **MODE** with either a CICS/ESA-supplied mode name, such as SMSNA100, or with your own defined mode name. If another set of session definitions exist for the BEA connection, this mode name must be unique among all sets defined to the connection. The mode name corresponds to a VTAM LOGMODE name.

The MAXIMUM option defines the total number of sessions in the set (**MAX**) and the total number of contention winner sessions (**MIN**). To verify the installation, the total number of winner sessions must include those for the host and the remote stack. The installation verification process allows both sides to execute as the client. The total number of local contention winner sessions plus remote contention winner sessions must equal the number of sessions. The local number of sessions must equal the remote number of sessions.