Customizing for Certain Applications › Customize CICS Transaction Server › CICS RDO TYPETERM Parameters

CICS RDO TYPETERM Parameters

The following TYPETERM parameters affect this product's execution:

TYPETERM(typeterm-name)

Name of this TYPETERM definition. Note that for Autoinstall, CICS searches through TYPETERM names alphanumerically and sometimes selects an existing TYPETERM for a virtual terminal before TYPETERM. Therefore, it may be necessary to name the TYPETERM so that it is alphanumerically in front of any of your other TYPETERM definitions.

Note: For more information, see the CICS Resource Definition Guide.

GROUP(TPX)

Groups definitions together. You can specify any name, but if possible, specify one that indicates these are CA TPX definitions.

DEVICE(LUTYPE2)

This parameter must be specified as LUTYPE2 for all virtual terminals.

TERMMODEL(2)

This parameter must be specified as 2 for all virtual terminals.

DEFSCREEN(24,80)

The primary screen size for the virtual terminal. This should always be 24,80.

ALTSCREEN(x,y)

The alternate screen size of the virtual terminal. This will vary depending on the logmode used to log on to CICS. For example, for a model 2, this would be 24,80.

QUERY(ALL)

Indicates whether the terminal supports the Read Partition Query data stream. This allows CICS to query the terminal to see what extended options the terminal supports, such as EXTENDEDDS, COLOR, and HILIGHT. For this product, all virtual terminals that use a logmode ending in E can be queried. Specify this parameter as N if the terminal cannot be queried. Specify this parameter as Y if the terminal can be queried.

SENDSIZE(0)

Indicates the maximum size of data that CICS should send to the virtual terminal. Always specify this value as 0, which causes CICS to use the appropriate RUSIZE from the logmode entry used to log on to CICS. If you do specify a value other than 0, it must match the appropriate RUSIZE in the logmode entry.

RECEIVESIZE(0)

Indicates the maximum size of data that CICS will receive from the virtual terminal. Always specify this value as 0, which causes CICS to use the appropriate RUSIZE from the logmode entry used to log on to CICS. If you do specify a value other than 0, it must match the appropriate RUSIZE in the logmode entry.

LOGMODE(0)

Determines the BIND parameters used by CICS when starting a session with the virtual terminal. Always specify this value as 0, which causes CICS to use the values from the logmode used by the virtual terminal. If you do specify a logmode name, it should match the name used by the virtual terminal. If you specify this parameter as all blanks, CICS will build a BIND image on its own.

AUTOCONNECT(NO)

Tells CICS whether the terminal should be logged on to CICS automatically when CICS starts up. This parameter must be specified as NO for virtual terminals.

ATI(YES)

Tells CICS whether transactions can be automatically initiated at this virtual terminal. Specify YES for this parameter, especially if LOGONMSG(YES) is also specified for this virtual terminal. LOGONMSG(YES) causes the CICS good morning transaction (CSGM) to be initiated automatically at logon.

TTI(YES)

Tells CICS whether transactions can be initiated by typing in the transaction ID from the terminal. Always specify YES, or users will not be able to start any CICS transactions from this virtual terminal.

CREATESESS(NO)

Tells CICS whether it should try to start a session with this virtual terminal if none exists, but a transaction has been started using ATI. You must specify NO for virtual terminals.

RELREQ(NO)

Tells CICS whether it should release this virtual terminal upon receipt of a RELREQ request from another VTAM application. Specify NO for virtual terminals.

DISCREQ(YES)

Tells CICS whether it should allow the virtual terminal to disconnect from CICS. Specify YES, so that a CESF (or CSSF) LOGOFF will allow the session with the virtual terminal to end.

LOGONMSG(YES)

Tells CICS whether it should send the good morning message to the virtual terminal when it first logs on to CICS. This causes the CICS good morning transaction (CSGM) to be initiated by ATI, which also requires that you specify ATI(YES). Always specify YES, unless you always want the user to enter data first to CICS.

IOAREALEN(1920,4096)

Tells CICS the size of the area used to hold data received from the terminal. The first value is the minimum size of the area CICS will acquire on input from a terminal. If the data received from the terminal is longer than the first value, CICS will use the second value to get storage for the data. If the data is longer than the second value, the transaction will abend. These two values are dependent on your applications and terminals.