Session definition attributes

The session definition attribute descriptions are:

Autoconnect
specifies how connections are to be established. What you have to specify for LU6.1 and APPC sessions is discussed below:
APPC sessions
For a 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 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.
LU6.1 sessions
NO
The connection is not established at initialization or CEDA install.
YES
The connection is established at initialization or CEDA install.
Build Chain
specifies whether CICS is to perform chain assembly before passing the input data to the application program.
NO
Any TIOA received by an application program from this logical unit contains one request unit (RU).
YES
Any terminal input/output area (TIOA) received by an application program from this logical unit contains a complete chain.
Connection
specifies the name of the connection definition that you want to use with this session definition. The name can be up to four characters in length.
Description
(Optional.) Specifies a 1- to 30-character description of the resource.
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.
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.
IOarea Length
specifies the length, in bytes, of the terminal input/output area to be used for processing messages transmitted on the MRO link.
value1
Value1 specifies the minimum size of a terminal input/output area to be passed to an application program when a RECEIVE command is issued.
value2
If value2 is not specified, or is less than value1, it defaults to the value of value1.

You can specify value2 as greater than or equal to value1. In this case, when the size of an input message exceeds value1, CICS uses a terminal input/output area (TIOA) value2 bytes long. If the input message size also exceeds value2, the node abnormal condition program sends an exception response to the terminal.

If you leave these fields blank, CICSPlex® SM uses the default values for your CICS environment, if there are any.

Maximum (APPC only)
specifies the maximum number of sessions that are to be supported for the modeset. Value1 must be greater than or equal to value2.
1|value1
The maximum number of sessions in the group. This value can be in the range 1 through 999. The default is 1.
0|value2
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. (For further information on the effects of the MAXIMUM option, see the CICS Intercommunication Guide.)

If you leave these fields blank, CICSPlex SM uses the default values for your CICS environment, if there are any.

Modename (APPC only)
specifies 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.
Name
Specify a 1- to 8-character name for the session definition.
NEP class
specifies 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.

NetNameQ
specifies the name by which the remote IMS™ system knows this particular session. This is used for CICS-IMS sessions.
Operid
This attribute applies only to systems running CICS/MVS 2.1.2. Specify a 3-character operator ID to be associated with the sessions.
Oper Priority
This attribute applies only to systems running CICS/MVS 2.1.2. Specify 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.
Oper RSL
This attribute applies only to systems running CICS/MVS 2.1.2. Identify the preset resource security keys for the sessions by specifying one or more decimal values in the range 1 through 24. If you do not want to identify any resource security keys, specify 0.
Oper Security
This attribute applies only to systems running CICS/MVS 2.1.2. Identify the preset transaction security keys for the device by specifying one or more decimal values in the range 1 through 64.
Protocol
specifies 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.
Recov Notify
For systems running CICS/MVS 2.1.2 or CICS/ESA 3.3, specify how a terminal user should be notified of an XRF takeover:
NONE
No notification is given.
MESSAGE
A message is displayed, provided the terminal is defined with ATI(YES) and is capable of displaying a BMS map.
TRANSACTION
The transaction specified in the RMTRAN system initialization parameter is initiated, provided the terminal is defined with ATI(YES).
N/A
The Recov Notify field does not apply to this definition and should not be validated.
Recov Option
This option applies to the recovery of sessions in a CICS region running with VTAM persistent sessions, or with XRF.
Recv/Send count
Specify the number of MRO, LU type 6.1, or EXCI sessions that usually either receive before sending (Recv) or send before receiving (Send):
value1
Recv count:
blank
These sessions can send only; there are no receive sessions.
number
The number of receive sessions on connections that specify LU61, EXCI, or NOTAPPLIC in the Protocol field of the connection definition (CONNDEF).

CICS uses the number to generate the last two or three characters of the session names. If you are using the default receive prefix (<), or your own 1-character prefix, specify a number in the range 1 through 999. If you specify a 2-character receive prefix, the number is restricted to the range 1 through 99.

value2
Send count:
blank
These sessions can receive only; there are no send sessions.

The Send count field must be blank when the sessions are on an EXCI connection.

number
The number of send sessions on connections that specify LU61 or NOTAPPLIC in the Protocol field of the connection definition (CONNDEF).

CICS uses the number to generate the last two or three characters of the session names. If you are using the default send prefix (>), or your own 1-character prefix, specify a number in the range 1 through 999. If you specify a 2-character send prefix, the number is restricted to the range 1 through 99.

Recv/Send prfx
Specify a 1- or 2-character prefix that CICS is to use as the first 1 or 2 characters of the receive and 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.
value1
Recv prefix:
<
For MRO or EXCI sessions you are advised to use < and > as receive and send prefixes to avoid duplicate session names being created. CICS creates the last three characters using A-Z and 1-9. These 3-character identifiers begin with the letters AAA, and continue in ascending sequence until the number of session entries reaches the limit set by the Recv/Send count value. Receive session names are generated after the send session names, and they follow in the same sequence.

For example, if the last session name generated for the send sessions is >AAJ, using the send prefix ">", CICS generates the receive session names as <AAK, <AAL, <AAM, and so on. ( This method of generating session identifiers is the same as for APPC sessions, except for the initial prefix symbol.)

prefix
Specify your own 1- or 2-character prefix. A hyphen (-) is not supported for LU 6.1 sessions on the host.
value2
Send prefix:
>
For MRO or EXCI sessions you are advised to use < and > as receive and send prefixes to avoid duplicate session names being created. CICS creates the last three characters using A-Z and 1-9. These 3-character identifiers begin with the letters AAA, and continue in ascending sequence until the number of session entries reaches the limit set by the Recv/Send count value. Receive session names are generated after the send session names, and they follow in the same sequence.

For example, if the last session name generated for the send sessions is >AAJ, using the send prefix ">", CICS generates the receive session names as <AAK, <AAL, <AAM, and so on. ( This method of generating session identifiers is the same as for APPC sessions, except for the initial prefix symbol.)

prefix
Specify your own 1- or 2-character prefix. A hyphen (-) is not supported for LU 6.1 sessions on the host.
Notes:
  1. If you are creating a SESSDEF for an MRO SYSLINK, you should use "<" and ">" for the receive and send prefixes. If you specify different values for the prefixes you must specify a different SESSDEF for each SYSLINK to avoid duplicate session names being created.
Recv/Send size
Specify the maximum VTAM request unit (RU) size that these sessions are capable of receiving and sending, in the range 1 through 30720 for LU 6.1 sessions, or 256 through 30720 for APPC sessions. If you leave these fields blank, CICSPlex SM uses the default values for your CICS environment, if there are any.
Relreq
specifies whether CICS is to release the logical unit upon request by another VTAM application program.
RESGROUP
(Optional.) Specify the name of an existing resource group to which the definition is to be automatically added.
SessName
specifies 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
specifies 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
For systems running CICS/MVS 2.1.2, specify the 1- to 4-character ID of the transaction to be initiated from this device.
Userarealen
Specify 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
(Optional.) Three 8-character fields provided for any site-specific data related to the session. CICSPlex SM makes no use of this user data.
Userid
specifies 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.

Version
(Optional.) Specify an integer in the range 1 through 15. Specify 0 or leave blank for CICSPlex SM to assign the first available version id in the range 1 through 15.

Related concepts
Session resource definitions
CICS Resource Definition Guide
Related tasks
Accessing BAS session definitions
Working with the SESSDEF view
Defining sessions using BAS
[[ Contents Previous Page | Next Page Index ]]