CONNDEF Resource Table

A CICS® Definition that describes an ISC or MRO connection between CICS and a remote system.

The First key field for this resource is NAME. A connection name can be only 4 characters long. The remainder of the 8-character NAME field should be padded with blank spaces.

The Second key field for this resource is DEFVER.

The Third key field for this resource is CSDGROUP.

The following actions are supported:
ADDTOGRP
Add to resource group
The parameter data for the ADDTOGRP action is: 
   PARM('RESGROUP(resgroup).')

     where:

     resgroup = The name of a RESGROUP definition.
CSDCOPY
Copy the CICS CSD resource definition in a CSD group into an different CSD group.
The parameter data for the CSDCOPY action is described in Managing CICS definitions in the CSD.
INSTALL
Install a Connection Definition.

The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.

External resource name(CMCI)
CICSDefinitionISCMROConnection
Object type
CICS Definition
Length
408
Usage
API, Batch Utility, WUI, CICS Management Client Interface(CMCI)
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Copybook identifier
EYUt3800
Security Class
OPERATE.CONNECT
CICS Commands subject to CICS Security
INQUIRE CONNECTION
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
CREATE   CSD No
    RESGROUP(value) No
GET   CICSGRP(value) No
    CICSSYS(value) No
    CSDGROUP(value) No
    RESGROUP(value) No
REMOVE   CSD No
UPDATE   CSD No
PERFORM SET, PERFORM OBJECT ADDTOGRP RESGROUP(value) Yes
  CSDCOPY AS_RESOURCE(value) No
    DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) No
    TO_CSDGROUP(value) No
  INSTALL FORCEINS(YES, NO) No
    MODE(value) No
    NOTIFY(NO, INACTIVE, RELEASE, FULL) No
    OVERRIDE No
    OVERTYPE(TARGET, RELATED, BOTH, NONE) No
    REFASSIGN(value) Yes
    RELATED(value) No
    STATECHK(YES, NO) No
    TARGET(value) Yes
    USAGE(LOCAL) Yes
Table 2. CONNDEF FEEDBACK error codes
Value Code Description
1 CONNDEF_INV_DATA Attribute data invalid
2 CONNDEF_REC_NOT_FOUND Requested resource not found
4 CONNDEF_REC_EXISTS Resource already exists
5 CONNDEF_REC_CHANGED Resource definition already changed
6 CONNDEF_INV_RESTYPE Invalid resource type
7 CONNDEF_INV_VER Invalid resource version
11 CONNDEF_NON_MP Maintenance point CMAS not available
12 CONNDEF_INV_CONTEXT Context not found
13 CONNDEF_INCONSISTENT_SET Inconsistent set condition
14 CONNDEF_INV_RESGROUP Resource group not found
21 CONNDEF_INV_ACTION Invalid action
22 CONNDEF_INV_RECADDR Invalid record address
23 CONNDEF_INV_RECLEN Invalid record length
24 CONNDEF_DIFF_VERSION Different version
25 CONNDEF_EARLY_NAMELIST_END Early name list end
26 CONNDEF_INV_NAMELIST Invalid name list
27 CONNDEF_INV_NAME Invalid name
28 CONNDEF_INV_MINNAME Invalid minor name
29 CONNDEF_NOTIFY Notify
30 CONNDEF_PARTIAL_INSTALL Partial install
31 CONNDEF_NOTHING_INSTALLED Nothing installed
32 CONNDEF_NO_TARGETS No targets
33 CONNDEF_NO_RELATED No related systems
34 CONNDEF_INV_TSCOPE Invalid target scope
35 CONNDEF_INV_RSCOPE Invalid related scope
36 CONNDEF_INV_USAGE Invalid usage
37 CONNDEF_INV_MODE Invalid mode
38 CONNDEF_INV_STATECHK Invalid state check
39 CONNDEF_INV_FORCEINS Invalid force install
40 CONNDEF_INV_NOTIFY Invalid notify
41 CONNDEF_INV_OVERTYPE Invalid over type
42 CONNDEF_INV_OVRBLOCK Invalid override block
43 CONNDEF_INV_ORSTRING Invalid override string
44 CONNDEF_INV_STRNGTERM Invalid string terminator
45 CONNDEF_INV_EMBEDTERM Invalid embedded terminator
46 CONNDEF_INV_ATTRIBUTE Invalid attribute
47 CONNDEF_INV_LITERAL Invalid literal
48 CONNDEF_INV_ORSTGNA Invalid override string
49 CONNDEF_SCOPE_REQUIRED Scope required
50 CONNDEF_USAGE_CONFLICT Usage conflict
51 CONNDEF_REFASSGN_REQ Referenced resource assignment required
52 CONNDEF_REFASSIGN_NOTFND Referenced resource assignment not found
53 CONNDEF_SESS_NOTINSTL Session not installed
54 CONNDEF_NODEFS_SELECTED No definitions selected
55 CONNDEF_MORE_THAN_1_RELSYS More than one related system
56 CONNDEF_MISSING_RELSYSID Missing related system identifier
57 CONNDEF_SCOPE_CONFLICT Scope conflict
58 CONNDEF_REFASSIGN_EMPTY Referenced resource assignment empty
59 CONNDEF_INV_CSDGROUP Invalid CSD group
60 CONNDEF_REC_NOT_REMOVED Record not removed
61 CONNDEF_INV_RESOURCE Invalid resource
62 CONNDEF_INV_CICS_RESTYPE Invalid CICS restype
63 CONNDEF_PARTIAL_ACTION Partial action
64 CONNDEF_NOTHING_ACTIONED Nothing actioned
65 CONNDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
66 CONNDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
67 CONNDEF_CSD_ERROR CSD access error
Table 3. CONNDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Get Invalid Offset
 NAME-1  CHAR CPSM 8 Yes DIFF Name       25
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15   24
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group       396
ACCESSMETHOD CVDAS CPSM 4 Yes LIKE Access method VTAM     36
ACCESSMETHOD Input/output valid values
  • VTAM
  • IRC
  • INDIRECT
  • XM
  • NETBIOS
  • TCPIP
ATTACHSEC EYUDA CPSM 4 Yes LIKE Level of attach-time security LOCAL     40
ATTACHSEC Input/output valid values
  • LOCAL
  • IDENTIFY
  • MIXIDPE
  • PERSISTENT
  • VERIFY
AUTOCONNECT EYUDA CPSM 4 Yes LIKE Autoconnect sessions for VTAM NO     44
AUTOCONNECT Input/output valid values
  • NO
  • ALL
  • YES
BINDPASSWORD HIDCHAR CPSM 16 No DIFF Bind password     E410+ 48
BINDSECURITY EYUDA CPSM 4 Yes LIKE Bind time security NO     64
BINDSECURITY Input/output valid values
  • YES
  • NO
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent       8
CHANGEAGENT Input/output valid values
  • CSDAPI
  • CSDBATCH
  • DREPAPI
  • N_A
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release       20
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time       0
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID       12
CONNPRIORITY CHAR CPSM 4 No DIFF Connection priority 86 0-255 EALL 152
CONNTYPE CVDAS CPSM 4 Yes LIKE Nature of connection NOTAPPLIC     68
CONNTYPE Input/output valid values
  • GENERIC
  • SPECIFIC
  • NOTAPPLIC
  • APPC
  • NETBIOS
  • TCPIP
CREATETIME DATETIME CPSM 8 Yes MAX Time created       176
DATASTREAM EYUDA CPSM 4 Yes LIKE Data stream type USER     72
DATASTREAM Input/output valid values
  • USER
  • LMS
  • SCS
  • STRFIELD
  • 3270
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999   392
DESCRIPTION CHAR CPSM 58 No DIFF Description       208
INDSYS CHAR CPSM 4 No DIFF Intermediate system name       76
INSERVICE EYUDA CPSM 4 Yes LIKE Connection status YES     80
INSERVICE Input/output valid values
  • YES
  • NO
LOCLHOSTNAME CHAR CPSM 40 No DIFF TCP/IP local host name     EALL 303
LUALIAS CHAR CPSM 8 No DIFF Local logical unit alias name     EALL 156
MAXQTIME CHAR CPSM 8 No DIFF Maximum queue time NO 0-9999   84
MAXQTIME Input/output valid values
  • NO
MODENAME CHAR CPSM 8 No DIFF Communication mode name     EALL 286
NETBIOSADAPT CHAR CPSM 1 No DIFF NETBIOS logical LAN adapter   0-1 EALL 294
NETBIOSADAPT Input/output valid values
  • B
NETNAME CHAR CPSM 8 No DIFF Network name       92
PARTCODEPAGE CHAR CPSM 6 No DIFF Partner code page 37 1-99999 EALL 280
PARTLUALIAS CHAR CPSM 8 No DIFF Partner logical unit alias name     EALL 164
PROTOCOL CVDAS CPSM 4 Yes LIKE Protocol APPC     100
PROTOCOL Input/output valid values
  • APPC
  • EXCI
  • LU61
  • NOTAPPLIC
  • N_A
PSRECOVERY EYUDA CPSM 4 Yes LIKE Persistent session recovery SYSDEFAULT     104
PSRECOVERY Input/output valid values
  • NONE
  • SYSDEFAULT
  • N_A
QUEUELIMIT CHAR CPSM 8 No DIFF Queue limit NO 0-9999   108
QUEUELIMIT Input/output valid values
  • NO
RECORDFORMAT EYUDA CPSM 4 Yes LIKE Record format U     116
RECORDFORMAT Input/output valid values
  • U
  • VB
REMOTENAME CHAR CPSM 4 No DIFF Connection name in remote system       120
REMOTESYSNET CHAR CPSM 8 No DIFF Net name of the owning TOR       124
REMOTESYSTEM CHAR CPSM 4 No DIFF Remote connection name       132
REMSYSAPPLID CHAR CPSM 8 No DIFF NETBIOS remote system application ID     EALL 295
REMTHOSTNAME CHAR CPSM 40 No DIFF TCP/IP remote host name     EALL 343
REMTHOSTPORT CHAR CPSM 6 No DIFF TCP/IP remote host port 1435 1-65535 EALL 383
REMTHOSTPORT Input/output valid values
  • *
SECURITYNAME CHAR CPSM 8 No DIFF Security name for remote system       136
SESSBUFFSIZE CHAR CPSM 6 No DIFF Maximum session buffer size 16384 512-40000 EALL 272
SESSCOUNT CHAR CPSM 2 No DIFF Number of concurrently active sessions 1 1-99 EALL 278
SINGLESESS EYUDA CPSM 4 Yes LIKE APPC terminal on single session APPC link NO     144
SINGLESESS Input/output valid values
  • YES
  • NO
  • N_A
USEDFLTUSER EYUDA CPSM 4 Yes LIKE Use default user ID N_A     268
USEDFLTUSER Input/output valid values
  • NO
  • YES
  • N_A
USERDATA1 CHAR CPSM 8 No DIFF User data area 1       184
USERDATA2 CHAR CPSM 8 No DIFF User data area 2       192
USERDATA3 CHAR CPSM 8 No DIFF User data area 3       200
XLNACTION EYUDA CPSM 4 Yes LIKE Exchange lognames (XLN) action N_A     148
XLNACTION Input/output valid values
  • KEEP
  • FORCE
  • N_A