DEFINE CONNECTION

Defines a remote system with which ES communicates via inter-region communication (IRC).
Keyword Description
Connection(name) Specifies the logical name of this connection. Mandatory. Must be unique across all connected systems. Can be up to four alphanumeric characters.
Group(groupname) Names the group the connection definition belongs to. Mandatory. groupname can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. Do not specify a group name starting with DFH, as Mainframe Subsystem Support (MSS) uses that prefix for system groups.
Description(text) Describes the connection. Optional. text can be up to 60 characters in length, with no restrictions except that if you use a left parenthesis you must ensure that there is a matching right parenthesis.
Connection Properties  
Netname(name) Specifies the network name that identifies the APPLID of the remote system or region. name can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. Required in most circumstances.
PRotocol(Appc|Cci) Identifies the connection method to be used for the connection:

Appc: a remote connection over an LU6.2 link

Cci: a remote connection through a CCI gateway

Mandatory

Operational Properties  
INSERVICE(Yes|No) Indicates whether or not this connection is in service; that is, whether transactions can be initiated and messages sent.
Security  
SEcurityname(name) The security name of the remote system. Required only if the connection method is APPC. Can be up to eight alphanumeric characters from the set A through Z, 0 through 9, $, @ and #.
ATtachsec(Local|identify|Verify|Persistent|Mixedpe) The level of security required when a user attaches to this connection:

Local: the authority of the user is taken to be that of the link

Identify: Incoming attach requests must specify a user ID

Verify: Incoming attach requests must specify both a user ID and a password

Persistent: The first attach request must specify both a user ID and a password, but subsequent attach requests require only a user ID

Mixedpe: Incoming attach requests may specify either Identify or Persistent

_SYnclevel(1|2) Allows for two-phase commit if set to 2. By default, this is set to 1.
Micro Focus Extensions  
_OPERId(code) Specifies an operator ID used for routing messages. Up to three alphanumeric characters. Optional.
_OPERPriority(number) Specifies the operator priority for transactions initiated over this connection. Defaults to 0(zero). Operator priority is one factor in determining a transaction's execution priority, which is the sum of:

Terminal priority

Transaction priority

Operator priority (this field)

The sum cannot be greater than 255.

_Userid(name) Specifies a user ID to be associated with the connection. Mandatory if no sign-on takes place on the connection.
_Natlang(E|K) Specifies the national language in which messages are sent over the connection:

E: English

K: Kanji

_SEssionmax(number) Specifies the maximum number of concurrent sessions for the connection. Defaults to 0(zero).
_Lualias(name) Specifies the LU name by which the connection is known in the APPC configuration. Mandatory only where the connection method is APPC.
_Partneralias(name) Specifies the name used by local transactions to refer to this partner LU. Mandatory only where the connection method is APPC.
_Aliasapplid(code) Specifies the APPLID used by the APPC link. Mandatory only where the connection method is APPC.
_Modetable(name) Specifies the name of the APPC transmission service profile that describes the APPC link between the local and partner LUs. Mandatory only where the connection method is APPC. It can be up to eight characters in length. The first character must be from the set A through Z and $. Subsequent characters can be from the set A through Z, 0 through 9 and $.
_CCIProtocol(CCITCPIP) For connections where the connection method is CCI, specifies which CCI protocol is to be used:

CCITCPIP: TCP/IP

Mandatory.

_CCIMachine(name) Names the machine on which on which the CCITCP2 daemon is running. Required only where CCIProtocol is CCITCPIP.
_MFNode(name) Names the machine on which the target region runs. This is its IP name or IP address. _MFNode and _MFPort together equate to the socket used by the TCP/IP server for the remote target region that this connection definition describes. These fields are mandatory only where CCIProtocol is CCITCPIP and when using a direct connection to the remote region with no CCITCP2 daemon present on the network.
_MFport(number) Identifies the port number for _MFNode. _MFNode and _MFPort together equate to the socket used by the TCP/IP server for the remote target region that this connection definition describes. These fields are mandatory only where CCIProtocol is CCITCPIP and when using a direct connection to the remote region with no CCITCP2 daemon present on the network..
_FQPARTNRNAM(name) Identifies a fully qualified partner name for LU62 connection definitions. This field is formed of a NETWORK ID and a Partner LU name (both must be eight characters at the most) separated by a period ('.').

If the Fully Qualified Partner name in the connection is validated and installed, it will be used at run time on the APPC Allocate verb, whereas the PARTNER LU Alias is set to binary zeroes.

For example:

DEFINE CONNECTION(T88A) GROUP(MYCONNS) 
NETNAME(OFLLU0AA) INSERVICE(YES) ATTACHSEC(LOCAL) PROTOCOL(APPC) 
_OPERPRTY(0) _NATLANG(E) _SESSIONMAX(4) _LUALIAS(OFLLU0AA) 
_PARTNRALIAS(CICSDEV1) _ALIASAPPLID(OFLLU0AA) _MODETABLE(#INTER) 
_SYNCLEVEL(2) _FQPARTNRNAM(BBNET.CICSDEV1) 

Example

DEFINE CONNECTION(L001) GROUP(SAMPGRP)
DESCRIPTION(Sample APPC connection)
       NETNAME(NET081) INSERVICE(YES) SECURITYNAME(SESS1)
       ATTACHSEC(LOCAL) PROTOCOL(APPC)

DEFINE CONNECTION(C002) GROUP(SAMPGRP)
DESCRIPTION(Sample CCI connection)
       INSERVICE(YES) ATTACHSEC(LOCAL) PROTOCOL(CCI) _OPERPRTY(0)
       _NATLANG(E) _SESSIONMAX(0) _CCIPROTOCOL(CCITCP)
       _CCIMACHINE(cvimtb09)

DEFINE CONNECTION(L001) GROUP(SAMPGRP)
DESCRIPTION(Sample APPC connection with MF extensions)
       NETNAME(NET081) INSERVICE(YES) SECURITYNAME(SESS1)
       ATTACHSEC(LOCAL) PROTOCOL(APPC) _OPERPRTY(0) _USERID(U555)
       _NATLANG(E) _SESSIONMAX(4) _LUALIAS(MTB9AFG)
       _PARTNRALIAS(ASL8KKK) _ALIASAPPLID(MPAPP)