CONNECT Resource Table

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

The Primary key field for this resource class 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.
Start of changeFORCECANCELEnd of change
Start of changeCancel all AIDs, including system AIDs, queuing for the connection.End of change
Start of changeFORCEPURGEEnd of change
Start of changeForce purge all transactions running on sessions on the connected system.End of change
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.

These actions require no unique parameter data.

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

Note:
In a CICS/VSE environment, the attribute value for RECOVSTATUS(NRS) does not match the CVDA value returned by CICS. The value returned by CICS conflicts with CVDA values in other CICS environments. In order to retain the attribute's uniqueness, CICSPlex SM adds 9000 to the value returned by CICS.
Length
328
Usage
API or EVALDEF
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Object type
CICS Resource
Copybook identifier
EYUt0006 or CONNECT
Valid API operations
GET SET and PERFORM

API Actions

DISCARD
Discard

Parameters: None

BACKOUT
Back out

Parameters: None

COMMIT
Commit

Parameters: None

RESYNC
Resynchronize

Parameters: None

FORCE
Force

Parameters: None

ACQUIRE
Acquire

Parameters: None

INSERVICE
Set to In Service

Parameters: None

NOTPENDING
Set to Not Pending

Parameters: None

OUTSERVICE
Set to Out of Service

Parameters: None

PURGE
Purge

Parameters: None

CANCEL
Cancel

Parameters: None

RELEASE
Release

Parameters: None

ENDAFFINITY
End affinity

Parameters: None

NORECOVDATA
Override the normal resynchronization process

Parameters: None

FORCEPURGE
Force Purge

Parameters: None

KILL
Kill

Parameters: None

Unsupported releases: E530

FORCECANCEL
Force Cancel

Parameters: None

Table 52. CONNECT resource table attributes
Name Datatype Source Len Sum Set Description Get Invalid Set Invalid Attr ID
EYU_CICSNAME CHAR CPSM 8 N/A CICS System Name
EYU_CICSREL CHAR CPSM 4 N/A CICS Release
EYU_RESERVED CHAR CPSM 4 N/A Reserved
 NAME-1  CHAR INQ 4 DIF Connection ID 1
PROTOCOL CVDAS INQ 4 LIKE Connection protocol 2
PROTOCOL Output Valid Values EXCI LU61 APPC NOTAPPLIC
TYPE EYUDA CPSM 4 LIKE Connection type 3
TYPE Output Valid Values LU61 LU62 INDIRECT MRO NETBIOS TCPIP
ACCESSMETHOD CVDAS INQ 4 LIKE Access method 4
ACCESSMETHOD Output Valid Values VTAM IRC INDIRECT XM XCF NETBIOS TCPIP
CONNSTATUS CVDAS INQ 4 LIKE yes Connection status 5
CONNSTATUS Input/Output Valid Values RELEASED ACQUIRED
CONNSTATUS Output Valid Values OBTAINING FREEING AVAILABLE NOTAPPLIC
AUTOSTATUS CVDAS INQ 4 LIKE Autoconnect option 6
AUTOSTATUS Output Valid Values AUTOCONN NONAUTOCONN ALLCONN
EXITTRACING CVDAS INQ 4 LIKE yes Exit Tracing status 7
EXITTRACING Input/Output Valid Values EXITTRACE NOEXITTRACE
EXITTRACING Output Valid Values NOTAPPLIC
NETNAME CHAR INQ 8 DIF Net name 8
SERVSTATUS CVDAS INQ 4 LIKE yes Service status 9
SERVSTATUS Input/Output Valid Values INSERVICE OUTSERVICE
SERVSTATUS Output Valid Values GOINGOUT
PENDSTATUS CVDAS INQ 4 LIKE yes Pending status 10
PENDSTATUS Input/Output Valid Values NOTPENDING
PENDSTATUS Output Valid Values PENDING NOTAPPLIC
XLNSTATUS CVDAS INQ 4 LIKE Exchange lognames (XLN) status 11
XLNSTATUS Output Valid Values XOK XNOTDONE NOTAPPLIC
ZCPTRACING CVDAS INQ 4 LIKE yes ZCP tracing 12
ZCPTRACING Input/Output Valid Values ZCPTRACE NOZCPTRACE
ZCPTRACING Output Valid Values NOTAPPLIC
AIDS BINARY STAT 2 AVG Number of automatic initiator descriptors (AIDs) 13
NONSPECAIDS BINARY STAT 2 AVG Number of AIDs waiting for a session 14
CONCURBIDS BINARY STAT 2 AVG Number of bids currently in progress 15
MAXSECOND BINARY STAT 2 AVG Peak number of secondaries in use at one time 16
MAXBIDS BINARY STAT 2 AVG Maximum number of concurrent bids 17
OUTSALLOC BINARY STAT 2 AVG Peak number of outstanding allocate requests 18
ATISBPRI BINARY STAT 4 AVG Number of ATIs satisfied by primary sessions 19
ATISBSEC BINARY STAT 4 AVG Number of ATIs satisfied by secondary sessions 20
BIDSSENT BINARY STAT 4 AVG Total number of bids sent 21
ALLOCATES BINARY STAT 4 AVG Total number of allocate requests 22
QUEDALLOCATE BINARY STAT 4 AVG Number of queued allocate requests 23
FAILINKALLOC BINARY STAT 4 AVG Number of allocate requests with link failure 24
FAILEDOTHERS BINARY STAT 4 AVG Number of allocate requests with other failure 25
FCFUNCSHIP BINARY STAT 4 AVG Number of File Control function ships 26
ICFUNCSHIP BINARY STAT 4 AVG Number of Interval Control function ships 27
TDFUNCSHIP BINARY STAT 4 AVG Number of Transient Data function ships 28
TSFUNCSHIP BINARY STAT 4 AVG Number of Temporary Storage function ships 29
DLIFUNCSHIP BINARY STAT 4 AVG Number of DL/I function ships 30
TERMSHAREREQ BINARY STAT 4 AVG Number of terminal sharing requests 31
MAXPRIMARIES BINARY STAT 2 AVG Peak number of primary sessions in use 32
MAXQTPURGCNT BINARY STAT 2 AVG Number of allocates purged due to MAXQTIME value 33
EXIT_REJALLC BINARY STAT 4 AVG Allocates rejected because QUEUELIMIT reached 34
CONNTYPE CVDAS INQ 4 LIKE External CICS interface type 35
CONNTYPE Output Valid Values SPECIFIC GENERIC
RECEIVECOUNT CODEDBIN INQ 4 AVG Number of defined receive sessions 36
SENDCOUNT CODEDBIN INQ 4 AVG Number of defined send sessions 37
MAXQTIME BINARY STAT 2 AVG Maximum queue time 38
ALLOCQLIMIT Start of changeCODEDBINEnd of change STAT 2 AVG Allocate queue limit (QUEUELIMIT) 39
XZIQREJS BINARY STAT 4 AVG Number of allocates rejected by XZIQUE exit 40
XZIQPRGCNT BINARY STAT 2 AVG Number of queue purges requested by XZIQUE exit 41
XZIQALLCPRG BINARY STAT 2 AVG Number of allocates purged by XZIQUE exit 42
MAXQTALLCPRG BINARY STAT 2 AVG Number of allocates purged when MAXQTIME exceeded 43
RECOVSTATUS CVDAS INQ 4 LIKE yes Recovery status 45
RECOVSTATUS Input/Output Valid Values NORECOVDATA
RECOVSTATUS Output Valid Values RECOVDATA NRS NOTAPPLIC
REMOTESYSTEM CHAR INQ 4 DIF Remote connection name 46
REMOTESYSNET CHAR INQ 8 DIF Net name of the owning TOR 47
REMOTENAME CHAR INQ 4 DIF Connection name in remote system 48
LINKSYSTEM CHAR INQ 4 DIF Name of real link towards TOR 49
GMTCREATIME TIMESTP STAT 8 MAX GMT connection create time 50
CONNCREATIME TIMESTP STAT 8 MAX Local connection create time 51
GMTDELETIME TIMESTP STAT 8 MAX GMT connection delete time 52
CONNDELETIME TIMESTP STAT 8 MAX Local connection delete time 53
PRICURRUSED BINARY STAT 2 AVG Number of primaries currently in use 54
SECCURRUSED BINARY STAT 2 AVG Number of secondaries currently in use 55
GRNAME CHAR INQ 8 DIF APPC generic resource 56
MEMBERNAME CHAR INQ 8 DIF Member name of connected LU 57
DPLFUNCSHIP BINARY STAT 4 AVG Number of Distributed Program Link function ships 58
NQNAME CHAR INQ 17 DIF Network qualified name E530 59
ESTPCCHNL BINARY STAT 4 AVG Program Control FS LINK requests with channels E620 and E630 61
ESTPCCHNSENT BINARY STAT 8 AVG Bytes sent on LINK channel requests E620 and E630 62
ESTPCCHNRCVD BINARY STAT 8 AVG Bytes received on LINK channel requests E620 and E630 63
ESTICCHNL BINARY STAT 4 AVG Interval Control FS start requests with channels E620 and E630 64
ESTICCHNSENT BINARY STAT 8 AVG Number of bytes sent on START channel requests E620 and E630 65
ESTICCHNRCVD BINARY STAT 8 AVG Number of bytes received on START channel requests E620 and E630 66
ESTTCCHNL BINARY STAT 4 AVG Number of terminal sharing channel requests E620 and E630 67
ESTTCCHNSENT BINARY STAT 8 AVG Bytes sent on terminal sharing channel requests E620 and E630 68
ESTTCCHNRCVD BINARY STAT 8 AVG Bytes received on terminal sharing channel requests E620 and E630 69
[[ Contents Previous Page | Next Page Index ]]