CONNECT Resource Table

A CICS® Resource that describes an ISC or MRO connection in an active CICS system being managed by CICSPlex® SM.

The First key field for this resource is NAME.

The following actions are supported:
ACQUIRE
Acquire the connection.
BACKOUT
Back out shunted units of work associated with the connection.
CANCEL
Cancel the connection.
COMMIT
Commit shunted units of work associated with the connection.
DISCARD
Discard the connection.
ENDAFFINITY
End the connection's affinity with a VTAM® generic resource group.
FORCE
Force shunted units of work associated with the connection to commit or back out.
FORCECANCEL
Cancel all AIDs, including system AIDs, queuing for the connection.
FORCEPURGE
Force purge all transactions running on sessions on the connected system.
INSERVICE
Place the connection in service.
KILL
Kill all transactions running on sessions on the connected system.
Note: Kill can lead to unpredictable results and should be used only in exceptional circumstances.
NORECOVDATA
Override the normal resynchronization process.
NOTPENDING
Set the connection not pending.
OUTSERVICE
Place the connection out of service.
PURGE
Purge the connection.
RELEASE
Release the connection.
RESYNC
Resynchronize shunted units of work associated with the connection.

Some of these actions may be valid only for particular types of CICS connections. Refer to the appropriate CICS documentation for details.

Note: The value returned by CICS conflicts with CVDA values in other CICS environments. To retain the attribute's uniqueness, CICSPlex SM adds either 8000 or 9000 to the value returned by CICS. For more information about translating CVDA values, see TRANSLATE command.

External resource name(CMCI)
CICSISCMROConnection
Object type
CICS Resource
Length
400
Usage
API, WUI, CICS Management Client Interface(CMCI), EVALDEF
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Copybook identifier
EYUt0006
Security Class
OPERATE.CONNECT
CICS Commands subject to CICS Security
COLLECT STATISTICS
INQUIRE CONNECTION
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
SET   None N/A
PERFORM SET, PERFORM OBJECT ACQUIRE None N/A
  BACKOUT None N/A
  CANCEL None N/A
  COMMIT None N/A
  DISCARD None N/A
  ENDAFFINITY None N/A
  FORCE None N/A
  FORCECANCEL None N/A
  FORCEPURGE None N/A
  INSERVICE None N/A
  KILL None N/A
  NORECOVDATA None N/A
  NOTPENDING None N/A
  OUTSERVICE None N/A
  PURGE None N/A
  RELEASE None N/A
  RESYNC None N/A
Table 2. CONNECT resource table attributes
Name Datatype Source CICS Source CICS Field Len Sum Set Description Default Get Invalid Offset
EYU_CICSNAME CHAR CPSM     8 DIFF No CICS System Name     0
EYU_CICSREL CHAR CPSM     4 DIFF No CICS Release     8
EYU_RESERVED CHAR CPSM     4 N/A No Reserved     12
 NAME-1  CHAR INQ CONNECTION CONNECTION 4 DIFF No Connection ID     16
ACCESSMETHOD CVDAS INQ CONNECTION ACCESSMETHOD 4 LIKE No Access method     28
ACCESSMETHOD Output valid values
  • VTAM
  • IRC
  • INDIRECT
  • XM
  • XCF
  • NETBIOS
  • TCPIP
  • NOTAPPLIC
AIDHWM BINARY STAT DFHA14DS A14EAHWM 4 MAX No Peak automatic initiator descriptors (AIDs)   E710 396
AIDS BINARY STAT DFHA14DS A14EALL 2 AVG No Number of automatic initiator descriptors (AIDs)   E720+ 68
AIDSF BINARY STAT DFHA14DS A14EALL 4 MAX No Number of automatic initiator descriptors (AIDs)     392
ALLOCATES BINARY STAT DFHA14DS A14ESTAS 4 AVG No Total number of allocate requests     92
ALLOCQLIMIT CNUMERIC STAT DFHA14DS A14EALIM 2 AVG No Allocate queue limit (QUEUELIMIT)     154
ATISBPRI BINARY STAT DFHA14DS A14ES1 4 AVG No Number of ATIs satisfied by primary sessions     80
ATISBSEC BINARY STAT DFHA14DS A14ES2 4 AVG No Number of ATIs satisfied by secondary sessions     84
AUTOSTATUS CVDAS INQ CONNECTION AUTOCONNECT 4 LIKE No Autoconnect option     36
AUTOSTATUS Output valid values
  • AUTOCONN
  • NONAUTOCONN
  • ALLCONN
  • NOTAPPLIC
BASDEFINEVER BINARY CPSM   Calculated 1 AVG No BAS resource definition version 0   388
BIDSSENT BINARY STAT DFHA14DS A14ESBID 4 AVG No Total number of bids sent     88
CHANGEAGENT CVDAS INQ CONNECTION CHANGEAGENT 4 LIKE No Last modification agent     328
CHANGEAGENT Input/output valid values
  • CSDAPI
  • CSDBATCH
  • DREPAPI
  • OVERRIDE
  • DREPBATCH
  • AUTOINSTALL
  • CREATESPI
  • NOTAPPLIC
  • DYNAMIC
  • N_A
CHANGEAGREL CHAR INQ CONNECTION CHANGEAGREL 4 DIFF No Last modification agent release     340
CHANGETIME DATETIME INQ CONNECTION CHANGETIME 8 MAX No Last modification time     344
CHANGEUSRID CHAR INQ CONNECTION CHANGEUSRID 8 DIFF No Last modification user ID     332
CONCURBIDS BINARY STAT DFHA14DS A14EBID 2 AVG No Number of bids currently in progress     72
CONNCREATIME TIMESTP STAT DFHA14DS A14AICT 8 MAX No Local connection create time     200
CONNDELETIME TIMESTP STAT DFHA14DS A14AIDT 8 MAX No Local connection delete time     216
CONNSTATUS CVDAS INQ CONNECTION CONNSTATUS 4 LIKE Yes Connection status     32
CONNSTATUS Input/output valid values
  • RELEASED
  • ACQUIRED
CONNSTATUS Output valid values
  • OBTAINING
  • FREEING
  • AVAILABLE
  • NOTAPPLIC
CONNTYPE CVDAS INQ CONNECTION CONNTYPE 4 LIKE No External CICS interface type     140
CONNTYPE Output valid values
  • SPECIFIC
  • GENERIC
  • NOTAPPLIC
DEFINESOURCE CHAR INQ CONNECTION DEFINESOURCE 8 DIFF No Source of the resource definition     352
DEFINETIME DATETIME INQ CONNECTION DEFINETIME 8 MAX No Creation time     360
DLIFUNCSHIP BINARY STAT DFHA14DS A14ESTDL 4 AVG No Number of DL/I function ships     124
DPLFUNCSHIP BINARY STAT DFHA14DS A14ESTPC 4 AVG No Number of Distributed Program Link function ships     244
ESTICCHNL BINARY STAT DFHA14DS A14ESTIC_CHANNEL 4 AVG No Interval Control FS start requests with channels     288
ESTICCHNRCVD BINARY STAT DFHA14DS A14ESTIC_CHANNEL_RCVD 8 AVG No Number of bytes received on START channel requests     300
ESTICCHNSENT BINARY STAT DFHA14DS A14ESTIC_CHANNEL_SENT 8 AVG No Number of bytes sent on START channel requests     292
ESTPCCHNL BINARY STAT DFHA14DS A14ESTPC_CHANNEL 4 AVG No Program Control FS LINK requests with channels     268
ESTPCCHNRCVD BINARY STAT DFHA14DS A14ESTPC_CHANNEL_RCVD 8 AVG No Bytes received on LINK channel requests     280
ESTPCCHNSENT BINARY STAT DFHA14DS A14ESTPC_CHANNEL_SENT 8 AVG No Bytes sent on LINK channel requests     272
ESTTCCHNL BINARY STAT DFHA14DS A14ESTTC_CHANNEL 4 AVG No Number of terminal sharing channel requests     308
ESTTCCHNRCVD BINARY STAT DFHA14DS A14ESTTC_CHANNEL_RCVD 8 AVG No Bytes received on terminal sharing channel requests     320
ESTTCCHNSENT BINARY STAT DFHA14DS A14ESTTC_CHANNEL_SENT 8 AVG No Bytes sent on terminal sharing channel requests     312
EXITTRACING CVDAS INQ CONNECTION EXITTRACING 4 LIKE Yes Exit Tracing status     40
EXITTRACING Input/output valid values
  • EXITTRACE
  • NOEXITTRACE
EXITTRACING Output valid values
  • NOTAPPLIC
EXIT_REJALLC BINARY STAT DFHA14DS A14EALRJ 4 AVG No Allocates rejected because QUEUELIMIT reached     136
FAILEDOTHERS BINARY STAT DFHA14DS A14ESTAO 4 AVG No Number of allocate requests with other failure     104
FAILINKALLOC BINARY STAT DFHA14DS A14ESTAF 4 AVG No Number of allocate requests with link failure     100
FCFUNCSHIP BINARY STAT DFHA14DS A14ESTFC 4 AVG No Number of File Control function ships     108
GMTCREATIME TIMESTP STAT DFHA14DS A14GACT 8 MAX No GMT connection create time     192
GMTDELETIME TIMESTP STAT DFHA14DS A14GADT 8 MAX No GMT connection delete time     208
GRNAME CHAR INQ CONNECTION GRNAME 8 DIFF No APPC generic resource     228
ICFUNCSHIP BINARY STAT DFHA14DS A14ESTIC 4 AVG No Number of Interval Control function ships     112
INSTALLAGENT CVDAS INQ CONNECTION INSTALLAGENT 4 LIKE No Installation agent     384
INSTALLAGENT Input/output valid values
  • CSDAPI
  • CREATESPI
  • AUTOINSTALL
  • GRPLIST
  • DYNAMIC
INSTALLTIME DATETIME INQ CONNECTION INSTALLTIME 8 MAX No Installation time     376
INSTALLUSRID CHAR INQ CONNECTION INSTALLUSRID 8 DIFF No Installation user ID     368
LINKSYSTEM CHAR INQ CONNECTION LINKSYSTEM 4 DIFF No Name of real link towards TOR     188
MAXBIDS BINARY STAT DFHA14DS A14EBHWM 2 AVG No Maximum number of concurrent bids     76
MAXPRIMARIES BINARY STAT DFHA14DS A14E1HWM 2 AVG No Peak number of primary sessions in use     132
MAXQTALLCPRG BINARY STAT DFHA14DS A14EMQPC 2 AVG No Number of allocates purged when MAXQTIME exceeded     164
MAXQTIME CNUMERIC STAT DFHA14DS A14EMXQT 2 AVG No Maximum queue time     152
MAXQTPURGCNT BINARY STAT DFHA14DS A14EQPCT 2 AVG No Number of allocates purged due to MAXQTIME value     134
MAXSECOND BINARY STAT DFHA14DS A14E2HWM 2 AVG No Peak number of secondaries in use at one time     74
MEMBERNAME CHAR INQ CONNECTION MEMBERNAME 8 DIFF No Member name of connected LU     236
NETNAME CHAR INQ CONNECTION NETNAME 8 DIFF No Net name     44
NONSPECAIDS BINARY STAT DFHA14DS A14ESALL 2 AVG No Number of AIDs waiting for a session     70
NQNAME CHAR INQ CONNECTION NQNAME 17 DIFF No Network qualified name     248
OUTSALLOC BINARY STAT DFHA14DS A14ESTAM 2 AVG No Peak number of outstanding allocate requests     78
PENDSTATUS CVDAS INQ CONNECTION PENDSTATUS 4 LIKE Yes Pending status     56
PENDSTATUS Input/output valid values
  • NOTPENDING
PENDSTATUS Output valid values
  • PENDING
  • NOTAPPLIC
PRICURRUSED BINARY STAT DFHA14DS A14E1RY 2 AVG No Number of primaries currently in use     224
PROTOCOL CVDAS INQ CONNECTION PROTOCOL 4 LIKE No Connection protocol     20
PROTOCOL Output valid values
  • EXCI
  • LU61
  • APPC
  • NOTAPPLIC
QUEDALLOCATE BINARY STAT DFHA14DS A14ESTAQ 4 AVG No Number of queued allocate requests     96
RECEIVECOUNT CNUMERIC INQ CONNECTION RECEIVECOUNT 4 AVG No Number of defined receive sessions     144
RECOVSTATUS CVDAS INQ CONNECTION RECOVSTATUS 4 LIKE Yes Recovery status     168
RECOVSTATUS Input/output valid values
  • NORECOVDATA
RECOVSTATUS Output valid values
  • RECOVDATA
  • NRS
  • NOTAPPLIC
REMOTENAME CHAR INQ CONNECTION REMOTENAME 4 DIFF No Connection name in remote system     184
REMOTESYSNET CHAR INQ CONNECTION REMOTESYSNET 8 DIFF No Net name of the owning TOR     176
REMOTESYSTEM CHAR INQ CONNECTION REMOTESYSTEM 4 DIFF No Remote connection name     172
SECCURRUSED BINARY STAT DFHA14DS A14E2RY 2 AVG No Number of secondaries currently in use     226
SENDCOUNT CNUMERIC INQ CONNECTION SENDCOUNT 4 AVG No Number of defined send sessions     148
SERVSTATUS CVDAS INQ CONNECTION SERVSTATUS 4 LIKE Yes Service status     52
SERVSTATUS Input/output valid values
  • INSERVICE
  • OUTSERVICE
SERVSTATUS Output valid values
  • GOINGOUT
  • NOTAPPLIC
TDFUNCSHIP BINARY STAT DFHA14DS A14ESTTD 4 AVG No Number of Transient Data function ships     116
TERMSHAREREQ BINARY STAT DFHA14DS A14ESTTC 4 AVG No Number of terminal sharing requests     128
TSFUNCSHIP BINARY STAT DFHA14DS A14ESTTS 4 AVG No Number of Temporary Storage function ships     120
TYPE EYUDA CPSM   Calculated 4 LIKE No Connection type     24
TYPE Output valid values
  • LU61
  • LU62
  • INDIRECT
  • MRO
  • NETBIOS
  • TCPIP
  • NOTAPPLIC
XLNSTATUS CVDAS INQ CONNECTION XLNSTATUS 4 LIKE No Exchange lognames (XLN) status     60
XLNSTATUS Output valid values
  • XOK
  • XNOTDONE
  • NOTAPPLIC
XZIQALLCPRG BINARY STAT DFHA14DS A14EZQPC 2 AVG No Number of allocates purged by XZIQUE exit     162
XZIQPRGCNT BINARY STAT DFHA14DS A14EZQPU 2 AVG No Number of queue purges requested by XZIQUE exit     160
XZIQREJS BINARY STAT DFHA14DS A14EZQRJ 4 AVG No Number of allocates rejected by XZIQUE exit     156
ZCPTRACING CVDAS INQ CONNECTION ZCPTRACING 4 LIKE Yes ZCP tracing     64
ZCPTRACING Input/output valid values
  • ZCPTRACE
  • NOZCPTRACE
ZCPTRACING Output valid values
  • NOTAPPLIC