CONNECTRecordType

CONNECT Record

Fields

Aids (Long)

The current number of automatic initiator descriptors (AIDs) in the AID chain.

This is obsolete from CICS TS Version 5 Release 5.

Aidsf (Long)

The current number of automatic initiator descriptors (AIDs) in the AID chain.

CICSRelease (String)
PeakAids (Long)

The peak number of automatic initiator descriptors (AIDs) in the AID chain.

accessmethod (String)

The access method in use for this connection (VTAM, IRC, INDIRECT, XCF, XM, NETBIOS, TCPIP or NOTAPPLIC).

allocates (Long)

The total number of allocate requests against this system.

allocqlimit (NaLongType)

The value of the QUEUELIMIT parameter as specified on the CONNECTION definition. If this value is reached, then allocate queue requests are rejected. If the CONNECTION is defined with a QUEUELIMIT of NO, N/A will be displayed.

atisbpri (Long)

The number of ATI requests satisfied by primary (contention loser) sessions.

atisbsec (Long)

The number of ATI requests satisfied by secondary (contention winner) sessions.

autostatus (String)

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.
  • AUTOCONN - Associated sessions are bound.
  • NONAUTOCONN - Associated sessions are not bound.
  • NOTAPPLIC - The connection is the local system entry.
basdefinever (Long)

The BAS version number of this definition.

bidssent (Long)

The total number of bids that were sent.

changeAgent (String)

The change agent identifier that made the last modification.

  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • AUTOINSTALL - The resource was last autoinstalled.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • DYNAMIC - The resource was installed dynamically.
  • NOTAPPLIC - This is not applicable for this resource.
  • OVERRIDE - Resource was last changed by resource overrides.
changeAgentRelease (String)

If the connection was installed using a CICSPlex SM SYSLINK definition, this is the CICS release level of the CICS system where the connection is installed. For connections not installed using SYSLINK this is the CICS release level of the agent that made the last modification to the connection definition.

changeTime (String)

If the connection was installed using a CICSPlex SM SYSLINK definition, this is the local date and time of the installation. For connections not installed using SYSLINK this is the local date and time when the connection definition was last changed.

changeUserID (String)

If the connection was installed using a CICSPlex SM SYSLINK definition, this is the user ID that requested the installation. For connections not installed using SYSLINK this is the user ID that made the last modification to the connection definition.

concurbids (Long)

The number of bids currently in progress.

conncreatime (String)

The local time when the connection was created

conndeletime (String)

The local time when the connection was deleted

conntype (String)

Indicates whether this connection is:

  • SPECIFIC - For communication from a non-CICS client program to the CICS system, and is an MRO link with one or more sessions dedicated to a single user in a client program.
  • GENERIC - For communication from a non-CICS client program to the CICS system, and is an MRO link with a number of sessions to be shared by multiple external CICS interface users.
  • NOTAPPLIC - Not an external CICS interface connection.
defineSource (String)

The source of the definition, depending on which agent made the last change.

defineTime (String)

If the connection was installed using a CICSPlex SM SYSLINK definition, this is the local date and time of the installation. For connections not installed using SYSLINK this is the local date and time when the connection definition record was created on DFHCSD or EYUDREP.

dlifuncship (Long)

The number of DL/I requests for function shipping.

dplfuncship (Long)

The number of Distributed Program Link (DPL) requests that have been function shipped across this connection.

esticchnl (Long)

Number of Interval Control FS start requests with channels

esticchnrcvd (Long)

The number of bytes received on START channel requests

esticchnsent (Long)

The number of bytes sent on START channel requests

estpcchnl (Long)

Number of program control FS LINK requests with channels

estpcchnrcvd (Long)

Number of bytes received on LINK channel requests

estpcchnsent (Long)

Number of bytes sent on LINK channel requests

esttcchnl (Long)

The number of terminal sharing channel requests.

esttcchnrcvd (Long)

Number of bytes received on terminal sharing channel requests

esttcchnsent (Long)

Number of bytes sent on terminal sharing channel requests

exit_rejallc (Long)

The total number of allocates rejected due to the QUEUELIMIT value being reached.

exittracing (String)

Controls the terminal exit program's tracing activity for the sessions associated with this connection. A value of NOTAPPLIC means this connection is either not an LU6.1 or APPC connection, or it is a remote connection.

Input Values: EXITTRACE, NOEXITTRACE

failedothers (Long)

The number of allocate requests that failed due to a session not being currently available for use.

failinkalloc (Long)

The number of allocate requests that failed due to the connection being released, out of service, or with a closed mode group.

fcfuncship (Long)

The number of file control requests for function shipping.

gmtcreatime (String)

The time when the connection was created in Greenwich Mean Time (GMT) format

gmtdeletime (String)

The time when the connection was deleted in Greenwich Mean Time (GMT) format

grname (String)

For an APPC connection to a generic resource when this system is also a generic resource, this field contains the 8-character generic resource name of the connected LU. Otherwise, the field is blank.

icfuncship (Long)

The number of interval control requests for function shipping.

installAgent (String)

The install agent identifier that made the installation.

  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • AUTOINSTALL - The resource was autoinstalled.
  • DYNAMIC - The resource was installed dynamically.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
installTime (String)

The local date and time when the definition was installed.

installUserID (String)

The user ID that installed the resource definition.

linksystem (String)

The 4-character name of the connection that is the real link towards the TOR for a remote or indirect system entry, if it is available. It is not set if some connection definitions in the chain from the remote or indirect entry to the link system are missing.

maxbids (Long)

The maximum number of bids in progress at any one time.

maxprimaries (Long)

The maximum number of primary (contention loser) sessions in use at any one time.

maxqtallcprg (Long)

The number of allocates purged because the queue processing time would have exceeded the maximum queue time value.

maxqtime (NaLongType)

The maximum amount of time, in seconds, provided to process an allocate queue once the QUEUELIMIT value for the connection has been reached. If an allocate queue would take longer than this to process, the queue is purged.

maxqtpurgcnt (Long)

The number of times an allocate queue has been purged because its processing time would have exceeded the maximum queue time value.

maxsecond (Long)

The maximum number of secondary (contention winner) sessions in use at any one time.

membername (String)

For an APPC connection to a generic resource when this system is also a generic resource, this field contains the 8-character member name (applid) of the connected LU. Otherwise, the field is blank.

name (String)

The name of the installed connection.

netName (String)

The name by which the remote system is known to the network.

nonspecaids (Long)

The current number of automatic initiator descriptors (AIDs) that are waiting for a session to become available.

nqname (String)

The network qualified name if one was sent by VTAM at logon time.

outsalloc (Long)

The maximum number of allocate requests that were queued for this system.

pendingStatus (String)

For connections using the APPC and MRO protocol, indicates whether there are any units of work that require resynchronization after a session failure (PENDING or NOTPENDING).

pricurrused (Long)

The number of primary (contention loser) sessions currently in use

protocol (String)

For connections with an access method of VTAM, indicates which SNA protocol is in use, either LU61 or 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.

quedallocate (Long)

The current number of queued allocate requests against this system.

receivecount (NaLongType)

For MRO connections, the number of receive sessions defined in the SESSIONS definition.

recovstatus (String)

Indicates whether there is recovery information outstanding for the connection:

  • NORECOVDATA - The connection was quiesced and neither side of the connection has recovery information outstanding. Data integrity will be maintained for a cold start of the local CICS system.
  • RECOVDATA - The local CICS system has either in-doubt logical units of work or outstanding resynchronizations on the connection. Resynchronization will take place the next time the connection becomes active. Data integrity will not be maintained for a cold start of the local CICS system.
  • NRS - The connection is active and has completed the exchange of lognames. There may be logical units of work in-flight or in resynchronization.
regionName (String)
remotename (String)

The name by which this connection is known in a remote system.

remotesysnet (String)

The system ID of the owning TOR

remotesystem (String)

The name of the remotely connected system

seccurrused (Long)

The number of secondary (contention winner) sessions currently in use.

sendcount (NaLongType)

For MRO connections, the number of send sessions defined in the SESSIONS definition.

serviceStatus (String)

Indicates whether the system can receive and send data as follows:

  • INSERVICE - The connection is in service; the system can send and receive data.
  • OUTSERVICE - The connection is not in service; the system can not send or receive data.
  • GOINGOUT - An OUTSERVICE request was issued for the connection, but can not be processed until all current work is complete.
  • NOTAPPLIC - This is not applicable for this resource.
status (String)

For connections using either the APPC or MRO protocol, the status of the connection as one of the following:

  • ACQUIRED - The connection is acquired.
  • 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 APPC connection.
  • OBTAINING - The connection is being acquired.
  • RELEASED - The connection is released. Input Values: ACQUIRED, RELEASED
tdfuncship (Long)

The number of transient data requests for function shipping.

termsharereq (Long)

The number of transaction routing commands.

tsfuncship (Long)

The number of temporary storage requests for function shipping.

type (String)

The connection type. Values are: LU61, LU62, INDIRECT, MRO, NETBIOS, TCPIP or NOTAPPLIC

xlnstatus (String)

The status of the exchange lognames (XLN) process. A value of NOTAPPLIC means that the link is released, the link is MRO, LU6.1, or single-session APPC, or the link does not support synchronization level 2 conversations.

xziqallcprg (Long)

The number of allocates purged as a result of the XZIQUE exit requesting that queues be purged.

xziqprgcnt (Long)

The number of allocate queue purges requested by the XZIQUE exit.

xziqrejs (Long)

The number of allocates rejected by the XZIQUE exit.

zcptracing (String)

Indicates the status of the ZCP trace facility. A value of NOTAPPLIC means this connection is not LU6.1 or APPC.

Input Values: ZPTRACE, NOZPTRACE