SESSDEF Resource Table

A CICS® Definition that describes a session, which is a logical link between connected systems.

The First key field for this resource is NAME.

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.

External resource name(CMCI)
CICSDefinitionSession
Object type
CICS Definition
Length
488
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
EYUt3810
Security Class
BAS.CONNECT
CICS Commands subject to CICS Security
INQUIRE SESSIONS
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
Table 2. SESSDEF FEEDBACK error codes
Value Code Description
1 SESSDEF_INV_DATA Attribute data invalid
2 SESSDEF_REC_NOT_FOUND Requested resource not found
4 SESSDEF_REC_EXISTS Resource already exists
5 SESSDEF_REC_CHANGED Resource definition already changed
6 SESSDEF_INV_RESTYPE Invalid resource type
7 SESSDEF_INV_VER Invalid resource version
11 SESSDEF_NON_MP Maintenance point CMAS not available
12 SESSDEF_INV_CONTEXT Context not found
13 SESSDEF_INCONSISTENT_SET Inconsistent set condition
14 SESSDEF_INV_RESGROUP Resource group not found
21 SESSDEF_INV_ACTION Invalid action
22 SESSDEF_INV_RECADDR Invalid record address
23 SESSDEF_INV_RECLEN Invalid record length
24 SESSDEF_DIFF_VERSION Different version
25 SESSDEF_EARLY_NAMELIST_END Early name list end
26 SESSDEF_INV_NAMELIST Invalid name list
27 SESSDEF_INV_NAME Invalid name
28 SESSDEF_INV_MINNAME Invalid minor name
29 SESSDEF_INV_CSDGROUP Invalid CSD group
30 SESSDEF_REC_NOT_REMOVED Record not removed
31 SESSDEF_INV_RESOURCE Invalid resource
32 SESSDEF_INV_CICS_RESTYPE Invalid CICS restype
33 SESSDEF_PARTIAL_ACTION Partial action
34 SESSDEF_NOTHING_ACTIONED Nothing actioned
35 SESSDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
36 SESSDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
37 SESSDEF_CSD_ERROR CSD access error
Table 3. SESSDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Get Invalid Offset GraphQL Field
 NAME-1  CHAR CPSM 8 Yes DIFF Name       25 name
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15   24 version
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group       480 CSDGroup
AUTOCONNECT EYUDA CPSM 4 Yes LIKE Autoconnect option NO     36 autoconnect
AUTOCONNECT Input/output valid values
  • YES
  • NO
  • ALL
BUILDCHAIN EYUDA CPSM 4 Yes LIKE Chain assembly required YES     40 buildchain
BUILDCHAIN Input/output valid values
  • YES
  • NO
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent       8 changeAgent
CHANGEAGENT Input/output valid values
  • CSDAPI
  • CSDBATCH
  • DREPAPI
  • N_A
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release       20 changeAgentRelease
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time       0 changeTime
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID       12 changeUserID
CONNECTION CHAR CPSM 4 Yes DIFF Connection definition name       44 connection
CREATETIME DATETIME CPSM 8 Yes MAX Time created       184 createTime
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999   476 desccodepage
DESCRIPTION CHAR CPSM 58 No DIFF Description       216 description
DISCREQ EYUDA CPSM 4 Yes LIKE Honor disconnect reqeusts NO     48 discreq
DISCREQ Input/output valid values
  • YES
  • NO
INSERVICE EYUDA CPSM 4 Yes LIKE Session inservice N_A   E330+ 148  
INSERVICE Input/output valid values
  • YES
  • NO
  • N_A
IOAREALEN CHAR CPSM 8 No DIFF Minimum terminal input output area (TIOA) size 0 0-32767   52 ioarealen
IOAREALEN2 CHAR CPSM 8 No DIFF Alternate terminal input output area (TIOA) size 0 0-32767   60 ioarealen2
MAXCTWIN CHAR CPSM 4 No DIFF Maximum number of contention winner sessions   0-999   72 maxctwin
MAXINGRP CHAR CPSM 4 No DIFF Maximum number of sessions in the group   0-999   68 maxingrp
MODENAME CHAR CPSM 8 No DIFF Mode name       76 modename
NEPCLASS CHAR CPSM 4 No DIFF Network error program transaction class 0 0-255   84 nepclass
NETNAMEQ CHAR CPSM 8 No DIFF Name IMS system uses to identify session       88 netnameq
OPERID CHAR CPSM 3 No DIFF Operator identifier     E330+ 180  
OPERPRIORITY CHAR CPSM 4 No DIFF Operator priority 0 0-255 E330+ 144  
OPERRSL CHAR CPSM 50 No DIFF Operator resource security keys     E330+ 274  
OPERSEC CHAR CPSM 150 No DIFF Operator transaction security keys     E330+ 324  
PARTCODEPAGE CHAR CPSM 8 No DIFF Partner code page 0 0-65534 EALL 160  
PROTOCOL CVDAS CPSM 4 Yes LIKE Intercommunication link protocol APPC     96 protocol
PROTOCOL Input/output valid values
  • APPC
  • EXCI
  • LU61
  • NOTAPPLIC
RECEIVECOUNT CHAR CPSM 4 No DIFF Receive count   1-999   100 receivecount
RECEIVEPFX CHAR CPSM 2 No DIFF Receive prefix       176 receivepfx
RECEIVESIZE CHAR CPSM 8 No DIFF Receive buffer size 4096 1-30720   104 receivesize
RECOVNOTIFY EYUDA CPSM 4 Yes LIKE XRF recovery notification option N_A   E410+ 116  
RECOVNOTIFY Input/output valid values
  • NONE
  • MESSAGE
  • TRANSACTION
  • N_A
RECOVOPTION EYUDA CPSM 4 Yes LIKE Recovery option SYSDEFAULT     112 recovoption
RECOVOPTION Input/output valid values
  • SYSDEFAULT
  • CLEARCONV
  • NONE
  • RELEASESESS
  • UNCONDREL
RELREQ EYUDA CPSM 4 Yes LIKE Honor release requests NO     120 relreq
RELREQ Input/output valid values
  • YES
  • NO
SENDCOUNT CHAR CPSM 4 No DIFF Send count   1-999   124 sendcount
SENDPFX CHAR CPSM 2 No DIFF Send prefix       178 sendpfx
SENDSIZE CHAR CPSM 8 No DIFF Send buffer size 4096 1-30720   128 sendsize
SESSNAME CHAR CPSM 4 No DIFF Session name       136 sessname
SESSPRIORITY CHAR CPSM 4 No DIFF Session priority 0 0-255   140 sesspriority
TRANSACTION CHAR CPSM 4 No DIFF Transaction to be initiated from device     E330+ 152  
USERAREALEN CHAR CPSM 4 No DIFF User area size 0 0-255   156 userarealen
USERDATA1 CHAR CPSM 8 No DIFF User data area 1       192 userdata1
USERDATA2 CHAR CPSM 8 No DIFF User data area 2       200 userdata2
USERDATA3 CHAR CPSM 8 No DIFF User data area 3       208 userdata3
USERID CHAR CPSM 8 No DIFF User signon ID       168 userid