ISC/MRO connection definitions - CONNDEF

The Connection definition (CONNDEF) views display the remote systems that a CICS system communicates with using intersystem communication (ISC) or multiple region operation (MRO).

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > ISC/MRO connection definitions

Table 1. Views in the supplied ISC/MRO connection definitions (CONNDEF) view set
View Notes
ISC/MRO connection definitions

EYUSTARTCONNDEF.ADDTOGRP

Add one or more connection definitions to a resource group.
ISC/MRO connection definitions

EYUSTARTCONNDEF.CREATE

Create a connection definition and add it to the data repository.
ISC/MRO connection definitions

EYUSTARTCONNDEF.DETAILED

Detailed information about a selected connection definition.
ISC/MRO connection definitions

EYUSTARTCONNDEF.INSTALL

Install a connection definition in an active system.
ISC/MRO connection definitions

EYUSTARTCONNDEF.REMOVE

Remove a connection definition from the data repository.
ISC/MRO connection definitions

EYUSTARTCONNDEF.TABULAR

Tabular information about all MRO connection definitions for the current context.

Actions

Table 2. Actions available for CONNDEF views
Action Description
ADDTOGRP Add one or more connection definitions to a resource group.
CREATE Create a connection definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
INSTALL Install a connection definition in an active system.
REMOVE Remove a connection definition from the data repository.
UPDATE Update a connection definition in the data repository.

Fields

Table 3. Fields in CONNDEF views
Field Attribute name Description
Access method ACCESSMETHOD The access method to be used for this connection:
  • APPC - advanced program-to-program communication.
  • EXCI - connection is for use by a program using the external CICS interface.
  • INDIRECT - communication between the local CICS system and the system defined by this connection definition is through the system named in the Intermediate system name field.
  • IRC - connection uses the interregion communication program DFHIRP. This is the access method for MRO.
  • NETBIOS - connection uses the NETBIOS LAN protocol
  • VTAM - VTAM intersystem communication.
  • XM - MVS cross-memory services.
Level of attach-time security ATTACHSEC 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 sessions for VTAM AUTOCONNECT Indicates whether sessions with this connection are to be bound when CICS is initialized or whenever communication with VTAM is started:
  • ALLCONN - Associated sessions are bound. The associated modename is generally also specifed as ALLCONN.
  • AUTOCONN - Associated sessions are bound.
  • NONAUTOCONN - Associated sessions are not bound.
Bind password BINDPASSWORD (APPC only) A password of up to 16 hexadecimal characters (0 - 9, A - F).
Bind time security BINDSECURITY Indicates whether an external security manager (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.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification time CHANGETIME The local time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification.
Connection priority CONNPRIORITY (CICS for OS/2 only) Specify the connection priority, in the range 0 through 255. (The default is 86.)
Nature of connection CONNTYPE The nature of the connection for external CICS interface (EXCI) connections:
  • 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.
Time created CREATETIME The local time when the connection was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Data stream type DATASTREAM 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.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the connection definition.
Intermediate system name INDSYS 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 can name an intermediate system only if you specify INDIRECT in the Access method field.
Connection status INSERVICE For connections using either the APPC or MRO protocol, the status of the connection as one of the following:
  • ACQUIRED - The connection is acquired, which means the partner LU has been contacted and the initial CNOS exchange has been done.
  • AVAILABLE - The connection is acquired, but there are currently no bound sessions.
  • FREEING - The connection is being released.
  • NOTAPPLIC - The connection is not a CICS-to-CICS MRO or an APPC connection.
  • OBTAINING - The connection is being acquired.
  • RELEASED - The connection is released.
TCP/IP local host name LOCLHOSTNAME (CICS for OS/2 only) For a TCP/IP connection, specify a 1- to 40-character host name (or equivalent IP address) for the local system. If you specify an asterisk (*), TCP/IP chooses which adapter to use.
Local logical unit alias name LUALIAS For APPC connections, the name of VTAM logical unit (LU) alias.
Maximum queue time MAXQTIME The maximum 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 Queue limit field, and then the time limit is applied only when the queue length has reached the queue limit value. Options are:
  • NO - There is no limit on the 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.

Communication mode name MODENAME The name used to identify the session when the definition is installed in the active system.
Name NAME The name of the connection definition.
NETBIOS logical LAN adapter NETBIOSADAPT (CICS for OS/2 only) For a NetBIOS connection, identify the logical LAN adapter to be used for the remote system. Valid values are 0, 1, or B (for both).
Network name NETNAME The intercommunication link to the system that owns the connection. The name can be up to eight characters in length.
Partner code page PARTCODEPAGE (CICS for OS/2 only) Specify the 1- to 5-digit code page of the remote system. (The default is 37.)
Partner logical unit alias name PARTLUALIAS (CICS for OS/2 only) For an APPC connection, specify the 1- to 8-character name used by Communications Manager/2 to refer to the partner logical unit.
Protocol PROTOCOL For connections with an access method of VTAM, indicates which SNA protocol is in use, either LUTYPE6.1 (LU61) or Advanced Program-to-Program Communication (APPC). A value of EXCI means this connection uses the External CICS Interface. A value of NOTAPPLIC means this connection is not a VTAM connection.
Persistent session recovery 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 value does not apply to this definition and should not be validated.
Queue limit QUEUELIMIT 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.
Record format RECORDFORMAT 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.
Connection name in remote system REMOTENAME 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.
Net name of the owning TOR REMOTESYSNET The network name (APPLID) of the system that owns the connection. The name can be up to four characters in length.
Remote connection name REMOTESYSTEM The intercommunication link to the system that owns the connection. The name can be up to four characters in length.
NETBIOS remote system application ID REMSYSAPPLID (CICS for OS/2 only) For a NetBIOS connection, specify the 1- to 8-character name of the remote CICS system. This name must match the Local System Appl ID in the remote system's SIT.
TCP/IP remote host name REMTHOSTNAME (CICS for OS/2 only) For a TCP/IP connection, specify the 1- to 40-character host name (or equivalent IP address) of the remote system.
TCP/IP remote host port REMTHOSTPORT (CICS for OS/2 only) For a TCP/IP connection, identify the TCP port on the remote system:
  • value - A port number, in the range 1 through 65535. (The default is 1435.)
  • * (asterisk) - The value from the TCP/IP SERVICES file is used.
Security name for remote system 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 user ID on your system.
Maximum session buffer size SESSBUFFSIZE The maximum size of the session buffer for the connection in the range 256 - 30720.
Number of concurrently active sessions SESSCOUNT The number of sessions currently in use.
APPC terminal on single session APPC link SINGLESESS Identifies 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 value does not apply to this definition and should not be validated by CICSPlex SM.
Use default user ID USEDFLTUSER 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 value does not apply to this definition and should not be validated by CICSPlex SM
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
Exchange lognames (XLN) action XLNACTION The status of the exchange lognames (XLN) process.


eyua7cp4.html | Timestamp icon Last updated: Sunday, 4 June 2017