Session definitions - SESSDEF

The Session definition (SESSDEF) views display information about the logical links between systems that communicate using intersystem communication (ISC) or multiple region operation (MRO).

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > Session definitions

Table 1. Views in the supplied **Session definitions** (SESSDEF) view set
View	Notes
Session definitions EYUSTARTSESSDEF.ADDTOGRP	Add one or more session definitions to a resource group.
Session definitions EYUSTARTSESSDEF.CREATE	Create a session definition and add it to the data repository.
Session definitions EYUSTARTSESSDEF.DETAILED	Detailed information about a selected session definition.
Session definitions EYUSTARTSESSDEF.REMOVE	Remove a session definition from the data repository.
Session definitions EYUSTARTSESSDEF.TABULAR	Tabular information about all session definitions for the current context.

Actions

Table 2. Actions available for SESSDEF views
Action	Description
ADDTOGRP	Add one or more session definitions to a resource group.
CREATE	Create a session definition and add it to the data repository.
CSDCOPY	Copy a CICS CSD resource definition.
REMOVE	Remove a session definition from the data repository.
UPDATE	Update a session definition in the data repository.

Fields

Table 3. Fields in SESSDEF views
Field	Attribute name	Description
Autoconnect option	AUTOCONNECT	Specifies how connections are to be established. For a APPC VTAM-connected system that has Autoconnect set to YES or ALL on the connection definition: NO - CICS does not attempt to bind any sessions when the connection is established. YES or ALL - A contention-winner session is established (that is, BIND is performed) during CICS initialization, or when communication with VTAM is started using the CEMT SET VTAM OPEN command. For a APPC VTAM-connected system that has Autoconnect set to NO on the CONNECTION definition: ALL - All sessions, not just contention winners, are established when the connection is acquired by issuing CEMT SET CONNECTION(name) ACQUIRED, or when the remote system itself initiates communication. NO - CICS does not attempt to bind any sessions when the connection is established. YES - Contention-winner sessions are established when the connection is acquired by issuing CEMT SET CONNECTION(sysid) ACQUIRED, or when the remote system itself initiates communication For LU6.1 sessions: NO - The connection is not established at initialization or CEDA install. YES - The connection is established at initialization or CEDA install.
Chain assembly required	BUILDCHAIN	Specifies whether CICS is to perform chain assembly before passing the input data to the application program: NO - Any terminal input/output area (TIOA) received by an application program from this logical unit contains one request unit (RU). YES - Any TIOA received by an application program from this logical unit contains a complete chain.
Last modification agent	CHANGEAGENT	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 - Resource was last changed by a CICSPlex SM API command.
Last modification agent release	CHANGEAGREL	The CICS release level of the agent that made the last modification.
Last modification time	CHANGETIME	The local date and time when the definition was last changed.
Last modification user ID	CHANGEUSRID	The user ID that made the last modification.
Connection definition name	CONNECTION	The name of the connection definition to be used with this session definition. The name can be up to four characters in length.
Time created	CREATETIME	The local date and time when the definition was created.
CSD group	CSDGROUP	The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version	DEFVER	The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page	DESCCODEPAGE	The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description	DESCRIPTION	A description of the session definition.
Honor disconnect reqeusts	DISCREQ	Specifies whether disconnect requests are to be honored. DISCREQ applies to LUTYPE6.1 ISC sessions, but not to MRO sessions where CICS is not dealing with VTAM devices.
Session inservice	INSERVICE	For LU 6.1 ISC sessions on systems running CICS/MVS 2.1.2 or CICS/ESA 3.3, specify YES or NO to indicate whether the session can be used for communication. If the definition is not for an LU 6.1 ISC session or will not be used on a CICS/MVS 2.1.2 or CICS/ESA 3.3 system, specify N/A.
Minimum terminal input output area (TIOA) size	IOAREALEN	The minimum size, in bytes, of the terminal input/output area to be used for processing messages transmitted on the MRO link.
Alternate terminal input output area (TIOA) size	IOAREALEN2	The length, in bytes, of the terminal input/output area to be used for processing messages transmitted on the MRO link. If the alternative TIOA value is not specified, or is less than the minimum TIOA value (IOAREALEN) , it defaults to the value of the minimum TIOA.
Maximum number of contention winner sessions	MAXCTWIN	The maximum number of sessions that are to be supported as contention winners. This value can be in the range 0 to 999. The default is 0. Note that this operand has no meaning for a single session connection. This value must be less than the maximum number of sessions in the group (MAXINGRP).
Maximum number of sessions in the group	MAXINGRP	The maximum number of sessions in the group. This value can be in the range 1 through 999. The default is 1. This value must be more than the maximum number of contention winner sessions (MAXTWIN).
Mode name	MODENAME	The name that identifies a group of sessions for use on an APPC connection. The name can be up to eight characters in length, and must be the name of a VTAM LOGMODE entry defined to VTAM (APPC only).
Name	NAME	The name of the session definition.
Network error program transaction class	NEPCLASS	The transaction class for the node error program: 0 - This results in a link to the default node error program module. value - The transaction class for the node error program module. The value can be in the range 1 through 255 If you leave these fields blank, CICSPlex SM uses the default values for your CICS environment, if there are any.
Name IMS system uses to identify session	NETNAMEQ	The name by which the remote IMS system knows this particular session. This is used for CICS-IMS sessions.
Operator identifier	OPERID	A 3-character operator ID to be associated with the sessions.
Operator priority	OPERPRIORITY	The operator priority to be used in determining task processing priority for each transaction attached to the sessions, in the range 0 through 255. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
Operator resource security keys	OPERRSL	The preset resource security keys for the sessions. Specify one or more decimal values in the range 1 through 24. If you do not want to identify any resource security keys, specify 0.
Operator transaction security keys	OPERSEC	The preset transaction security keys for the device by specifying one or more decimal values in the range 1 through 64.
Partner code page	PARTCODEPAGE	The code of the partner, in the range 0 through 65534.
Intercommunication link protocol	PROTOCOL	The type of protocol that is to be used for an intercommunication link (ISC or MRO): APPC (LUTYPE6.2) - Advanced program-to-program communication (APPC) protocol. Specify this for CICS-CICS ISC. EXCI - The external CICS interface. Specify this to indicate that the sessions are for use by a non-CICS client program using the external CICS interface. If you specify EXCI, you must leave SENDCOUNT blank. LU61 - LUTYPE6.1 protocol. NOTAPPLIC - The session does not represent an intercommunication link.
Receive count	RECEIVECOUNT	For MRO, and VTAM LU6.1 sessions, and for sessions with EXCI clients, specifies the number of sessions that normally receive before sending.
Receive prefix	RECEIVEPFX	A 1-or 2-character prefix that CICS is to use as the first one or two characters of the receive session names (the names of the terminal control table terminal entries (TCTTEs) for the sessions).
Receive buffer size	RECEIVESIZE	The maximum VTAM request unit (RU) size that the session is capable of receiving. The value must be between 1 and 30720 for LU61 sessions, or 256 and 30720 for APPC sessions. The default is 4096.
XRF recovery notification option	RECOVNOTIFY	Specifies the type of recovery for sessions in a CICS region running with XRF.
Recovery option	RECOVOPTION	Specifies the type of recovery for sessions in a CICS region running with VTAM persistent sessions.
Honor release requests	RELREQ	Specifies whether CICS is to release the logical unit upon request by another VTAM application program.
Send count	SENDCOUNT	For MRO, and VTAM LU6.1 sessions, and for sessions with EXCI clients, specifies the number of send sessions; that is, sessions that normally send before receiving.
Send prefix	SENDPFX	A 1-or 2-character prefix that CICS is to use as the first one or two characters of the send session names (the names of the terminal control table terminal entries (TCTTEs) for the sessions). The prefix you select must not result in any duplicate session or terminal names.
Send buffer size	SENDSIZE	The maximum VTAM request unit (RU) size that these sessions are capable of sending, in the range 1 through 30720 for LU 6.1 sessions, or 256 through 30720 for APPC sessions.
Session name	SESSNAME	The symbolic identification to be used as the local half of a session qualifier pair in a CICS intercommunication parallel session. The name can be up to four characters in length.
Session priority	SESSPRIORITY	The terminal priority - this decimal value (0 through 255) is used in establishing the overall transaction processing priority. (Transaction processing priority is equal to the sum of the terminal priority, transaction priority, and operator priority; this must not exceed 255.) If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
Transaction to be initiated from device	TRANSACTION	The 1- to 4-character ID of the transaction to be initiated from this device.
User area size	USERAREALEN	The length, in bytes, of the user area for this session, in the range 0 through 255. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
User data area 1	USERDATA1	Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2	USERDATA2	Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3	USERDATA3	Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User signon ID	USERID	A user identifier used for sign-on (SEC=YES or MIGRATE) and referred to in security error messages, security violation messages, and the audit trail. The name can be up to eight characters in length.