Connection definition attributes

The connection resource definition attribute descriptions are:

AccessMethod
specifies the access method to be used for this connection.
VTAM
VTAM intersystem communication.
INDIRECT
Communication between the local CICS system and the system defined by this connection definition is through the system named in the Indirect Sys field.
XCF
MVS coupling facility
IRC
The interregion communciation (IRC) program DFHIRP.
XM
MVS cross-memory services.
AttachSec
specifies the level of attach-time user security required for the connection.
IDENTIFY
Incoming attach requests must specify a user identifier. Enter IDENTIFY when the connecting system has a security manager; for example, if it is another CICS system.
LOCAL
The authority of the user is taken to be that of the link itself, and you rely on link security alone to protect your resource. If the PROTOCOL attribute on the CONNECTION definition is LU6.1, you must specify LOCAL.
MIXIDPE
Incoming attach requests may be using either or both IDENTIFY or PERSISTENT security types. The security type actually used depends on the incoming attach request.
PERSISTENT
Incoming attach requests must specify a user identifier and a user password on the first attach request.
VERIFY
Incoming attach requests must specify a user identifier and a user password.
AutoConnect
Indicate whether autoconnect processing is to occur for the connection.
BindPassword (APPC only)
For APPC links on systems running CICS®/MVS™ 2.1.2 or CICS/ESA 3.3, specify a password of up to 16 hexadecimal characters (0 - 9, A - F).

The password does not appear while you are typing it and it is not displayed on the update or browse panel. If you specify a password, the BindPassword field name appears highlighted on the update and browse panels to indicate a password exists; the field itself contains blanks. You can use the update panel to change an existing password or add a new password.

BindSecurity (APPC only)
specifies whether an ESM is being used for bind-time security.
NO
No external bind-time security is required.
YES
If security is active and the XAPPC system initialization parameter is set to YES, an ESM is called.
ConnType
For external CICS interface (EXCI) connections, this specifies the nature of the connection.
GENERIC
The connection is for communication from a non-CICS client program to the CICS system, and is generic. A generic connection is an MRO link with a number of sessions to be shared by multiple EXCI users. For a generic connection you cannot specify the NETNAME attribute.
SPECIFIC
The connection is for communication from a non-CICS client program to the CICS region, and is specific. A specific connection is an MRO link with one or more sessions dedicated to a single user in a client program. For a specific connection, NETNAME is mandatory.
APPC
Connection to another CICS system using APPC.
NOTAPPLIC
The connection does not use EXCI.
Datastream
specifies the type of data stream.
LMS
Specify the type of data stream.
SCS
The data stream is an SCS data stream as defined in the LUTYPE6.1 architecture.
STRFIELD
The data stream is a structured field data stream as defined in the LUTYPE6.1 architecture.
USER
User-defined data stream.
3270
The data stream is a 3270 data stream as defined in the type 6.1 logical unit (LUTYPE6.1) architecture.
Description
(Optional.) Specifies a 1- to 30-character description of the resource.
IndirectSys
specifies the name of an intermediate system that is used to relay communications between this system and the remote system. The name can be up to four characters in length.

You may name an intermediate system only if you specify INDIRECT in the AccessMthod field.

Inservice
specifies the status of the connection that is being defined.
NO
The connection can neither receive messages nor transmit input.
YES
Transactions may be initiated and messages may automatically be sent across the connection.
MaxQueTime
specifies a time control on the wait time for queued allocate requests waiting for free sessions on a connection that appears to be unresponsive. The maximum queue time is used only if a queue limit is specified in the Queuelimit field, and then the time limit is applied only when the queue length has reached the queue limit value.
NO
No limit on the length of time that allocate requests can remain queued.
nnnn
The approximate upper limit on the time that allocate requests can be queued for a connection that appears to be unresponsive. The number represents seconds in the range 0 through 9999.

If you do not specify a queue limit, leave this field blank.

Name
Specify a 1- to 4-character name for the connection definition.
NetName
Specify the 1- to 8-character network name of the remote system.
Protocol
specifies the type of protocol that is to be used for the link.
APPC (LUTYPE6.2 protocol)
Advanced program-to-program communication, or APPC protocol. This is the default value for ACCESSMETHOD(VTAM).
EXCI
The external CICS interface. Specify this to indicate that this connection is for use by a non-CICS client program using the external CICS interface.
LU61
LUTYPE6.1 protocol. Specify this for CICS-CICS ISC or CICS-IMS™ ISC, but not for MRO.
NOTAPPLIC
For CICS-CICS MRO links whenyou specify LU61 on the associated session definition (SESSDEF).
PSRecovery
In a CICS region running with persistent sessions support, this specifies whether, and how, LU6.2 sessions are recovered on system restart within the persistent session delay interval.
NONE
All sessions are unbound as out-of-service with no CNOS recovery.
SYSDEFAULT
If a failed CICS system is restarted within the persistent session delay interval, the following actions occur:
  • User modegroups are recovered to the SESSIONS RECOVOPTION value.
  • The SNASVCMG modegroup is recovered.
  • The connection is returned in ACQUIRED state and the last negotiated CNOS state is returned
N/A
The PSRecovery value does not apply to this defintion and should not be validated.
Queuelimit
specifies the maximum number of allocate requests that CICS is to queue while waiting for free sessions:
NO
There is no limit set to the number of allocate requests that CICS can queue while waiting for a free session.
nnnn
The maximum number of allocate requests, in the range 0 through 9999, that CICS can queue on the connection while waiting for a free session.

If you leave this field blank, CICSPlex® SM uses the default value for your CICS environment.

RecordFormat
specifies the type of SNA chain.
U
A single, unblocked stream of data.
VB
The SNA chain is formatted according to the VLVB standard as defined in the LUTYPE6.1 architecture.
RemoteName
specifies the name by which the APPC connection for transaction routing is known in the system or region that owns the connection. The name can be up to four characters in length.
RemoteSysNet
specifies the network name (APPLID) of the system that owns the connection. The name can be up to fourcharacters in length.
RemoteSystem
specifies the name that identifies the intercommunication link to the system that owns the connection. The name can be up to four characters in length.
RESGROUP
(Optional.) The name of the resource definition group to which this definition is to be automatically added.
SecurityName
For APPC and LU6.1 links only, this is the security name of the remote system.

The security name (or USERID on the sessions definition) must be a valid RACF userid on your system.

SingleSess
specifies whether the definition is for an APPC terminal on a single session APPC link to CICS.
NO
The definition is not for a single session APPC link to CICS.
YES
The definition is for an APPC terminal on a single session APPC link to CICS.
N/A
The SingleSess value does not apply to this definition and should not be validated by CICSPlex SM.
Usedfltuser (APPC and MRO only)
specifies the action that is taken when an inbound FMH5 does not contain the security information implied by the ATTACHSEC attribute.
NO
The attach request is rejected, and a protocol violation message is issued.
YES
Use the default user ID specified in the DFLUSER SIT parameter for the CICS system.
N/A
The Usedfltuser value does not apply to this definition and should not be validated by CICSPlex SM.
For more information, see CICS RACF® Security Guide and CICS RACF Security Guide.
User data
(Optional.) Three 8-character fields provided for any site-specific data related to the connection. CICSPlex SM makes no use of this user data.
Version
(Optional.) Specify an integer in the range 1 through 15. Specify 0 or leave blank for CICSPlex SM to assign the first available version id in the range 1 through 15.
XlnAction
for APPC and IRC links on systems running the CICS TS for OS/390, specifies the action to be taken when a new logname is received from the partner system.
FORCE
The predefined decisions for in-doubt UOWs (as defined by the indoubt attributes of the transaction definition) are implemented, before any new work with the new logname is started. CICS also deletes any information retained for possible resolution of UOWs that were in-doubt at the partner system.
KEEP
Recovery information is kept, and no action is taken for in-doubt units of work.
N/A
The XlnAction value does not apply to this definition and should not be validated by CICSPlex SM.

Related concepts
Connection resource definitions
CICS Resource Definition Guide
Related tasks
Defining connections using BAS
Installing BAS connection definitions
CICS Resource Definition Guide using CEDA
[[ Contents Previous Page | Next Page Index ]]