HPlogo HP SNA Products Remote System Configuration Guide: HP 3000 MPE/iX Computer Systems > Chapter 3 CICS Configuration

CICS Macro and Operand Descriptions

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

This section describes CICS operands for the macros DFHTCT TYPE=TERMINAL and DFHTCT TYPE=SYSTEM.

WARNING! The configuration values HP's SNA products require are in the tables that precede this section. Discussion of a specific value in the following pages does not imply that a particular HP SNA product can support that value.

DFHTCT TYPE=TERMINAL Macro

The DFHTCT TYPE=TERMINAL macro defines the characteristics of an IBM 3270 LU and the CICS options that apply to the device supported by the LU. One DFHTCT TYPE=TERMINAL macro is coded for each LU.

ACCMETH

The value ACCMETH=VTAM specifies that a VTAM TCT terminal entry (TCTTE) is to be generated.

BUFFER

Specifies the size of the buffer that the remote LU uses to receive a Request Unit (RU) from CICS. Messages longer than the size of BUFFER are segmented into a number of RUs that are chained together for recovery purposes.

Default: 256

Range: 810-1536

CHNASSY

Specifies whether chains are to be assembled on input by terminal control before any processing is performed on any part of the chain.

Default for LU.T2: YES

Default for LU.T1 and LU.T3: NO

ERRATT

Specifies attributes of the error message line.

Default: NO

FEATURE

Code this operand with the features that apply to the LU being emulated. The features found in tables 3-1 through 3-3 are described below.

AUDALARM IBM 3270 audible alarm feature.

COLOR value specifies the extended color feature which allows colors to be selected for each field or character.

EXTDS specifies extensions to the IBM 3270 data stream.

HILIGHT extended highlighting feature. This enables fields or characters to be displayed in reverse-video, underline mode, or blink.

SELCTPEN Selector Pen feature—allows the Cursor Select feature. Not used by CICS—simply provides information to application programs that require information about a particular device's available features.

FF

Specifies whether the LU supports the SCS Forms Feed (FF) control character.

Default: NO

GMMSG

Specifies whether the CICS "good morning" message will be displayed when the logical unit is signed on to VTAM. If you have specified ERRATT=LASTLINE, the "good morning" message will not overwrite the error message line.

Default: NO

HF

Specifies whether the LU supports the SCS Horizontal Format (HF) feature.

Default: NO

NETNAME

Specifies a one-to-eight character symbolic name, which is the LUname specified for this LU in the NCP/VTAM generation. The value of NETNAME must match the network name of the LU specified at the start of the LU macro.

Default: The value of TRMIDENT padded with four trailing blanks.

PGESTAT

Indicates the type of paging activity that occurs at a given terminal. AUTOPAGE that a number of pages can be sent as a chain, without a response from the LU after each page.

Default: AUTOPAGE

RELREQ

The first field specifies whether CICS can release the LU if it is not currently active in a transaction. The second field indicates whether CICS honors a disconnect request from the LU. A CSSF LOGOFF or GOODNIGHT from the terminal will also cause disconnection if YES is specified in the second field.

Default for first field: NO

RUSIZE

Specifies the size of the RU that can be sent from the LU to CICS.

Default: 256

Range: 10-256

TCTUAL

Specifies a user area length for this terminal. The TCT user area is initialized to zeros at system initialization time. System dependent, this operand may be used by application and/or system level routines as required at your IBM installation.

TIOAL

Used in conjunction with CHNASSY=YES. Specifies a normal chain size and a maximum chain size. DFHZCP initially acquires a TIOAL of normal chain size to satisfy a transaction RECEIVE request. If the normal chain size is not large enough, a larger TIOAL will be acquired, limited by the value of maximum chain size.

TRMIDNT

Specifies a unique four-character symbolic identifier (name) for each terminal. The value of NETNAME defaults to the value of TRMIDNT padded with four trailing blanks.

TRMMODL

Specifies the model number of the terminal. A number of other operands, such as DEFSCRN and ALTSCRN, default to the screensize value associated with TRMMODL.

TRMTYPE

This operand must be coded with the keyword that specifies the kind of device the LU supports.

TRMSTAT

The value for this operand specifies the types of activity that may occur at a terminal. TRANSCEIVE that a given terminal can initiate transactions and receive messages. RECEIVE a terminal can receive messages, but cannot accept input. Default: TRANSCEIVE

VF

Specifies whether the LU supports the SCS Vertical Format (VF) feature. Default: NO

DFHTCT TYPE=SYSTEM Macro

The DFHTCT TYPE=SYSTEM macro is used to define the characteristics of an LU type 6.2 and the CICS options that apply to the application supported by the LU. One DFHTCT TYPE=SYSTEM macro is coded for each LU type 6.2.

ACCMETH

The value ACCMETH=VTAM specifies that a VTAM TCT terminal entry (TCTTE) is to be generated.

BUFFER

Specifies the size of the buffer that the remote LU uses to receive an RU from CICS. CICS messages longer than the size of BUFFER are segmented into a number of RUs that are chained together for recovery purposes.

Default: 256 Range: 10-1536

FEATURE

Specifies applicable features for a given device. SINGLE specifies that an LU type 6.2 terminal is supported on a single session with CICS. Coding this value causes CICS to generate a DFHTCT TYPE=TERMINAL macro which is automatically combined with the DFHTCT TYPE=SYSTEM macro.

NETNAME

Specifies a one-to-eight character symbolic name, which is the LUname specified for this LU in the NCP/VTAM generation. NETNAME must match the network name of the LU specified at the start of the LU macro.

Default: The value of SYSIDNT, padded with four trailing blanks.

RUSIZE

Specifies the maximum size RU that can be sent from the LU to CICS.

Default: 256

SYSIDNT

Specifies a unique four-character symbolic identifier for each terminal. If you do not supply a NETNAME, then NETNAME defaults to SYSIDNT. SYSIDNT must in turn satisfy the requirements of NETNAME.

TRMTYPE

Specifies the type of system being connected to CICS. LUTYPE62 specifies that this is an LU type 6.2 intercommunication link.

TRMSTAT

Specifies the types of transactions that can occur at a given terminal. TRANSCEIVE that the terminal can initiate transactions, and that it can receive messages.

Default: TRANSCEIVE

Resource Definition Online

Resource Definition Online (RDO) allows a system programmer to interactively define resources to CICS. The system programmer can install RDO definitions as CICS system tables, by specifying a list of definitions at system initialization time. The system programmer can also install these definitions while CICS is running, so that they can be used immediately. Table 3-5 lists the macros and operands used to define resources in a Terminal Control Table, and lists the corresponding RDO keywords used to define those resources.

Table 3-5 TCT Macro to RDO Keyword Cross-Reference

DFHTCT Operand

DFHTCT Type=

Resource Definition

RDO Attribute

ACCMETH=VTAM SYSTEM/TERMINAL Connection ACCESSMETHOD
BUFFER SYSTEM/MODESET/TERMINAL Sessions SENDSIZE
BUFFER SYSTEM/MODESET/TERMINAL Typeterm SENDSIZE
CHNASSY=YES SYSTEM/TERMINAL Sessions BUILDCHAIN
CHNASSY=YES SYSTEM/TERMINAL Typeterm BUILDCHAIN
ERRATT=BLINK TERMINAL Typeterm ERRHILIGHT
ERRATT=REVERSE TERMINAL Typeterm ERRHILIGHT
ERRATT=UNDERLINE TERMINAL Typeterm ERRHILIGHT
ERRATT=COLORTERMINAL Typeterm ERRCOLOR
ERRATT=INTENSIFY TERMINAL Typeterm ERRINTENSIFY
ERRATT=LASTLINE TERMINAL Typeterm ERRINTENSIFY
FEATURE=AUDALARMTERMINAL Typeterm AUDIBEALARM
FEATURE=COLORTERMINAL Typeterm COLOR
FEATURE=EXTDS TERMINAL Typeterm EXTENDEDDS
FEATURE=HILIGHT TERMINAL Typeterm HILIGHT
FEATURE=SELCTPEN TERMINAL Typeterm LIGHTPEN
FEATURE=SINGLE SYSTEM Connection SINGLESESS(YES)
FF TERMINAL Typeterm FORMFEED
GMMSG TERMINAL Typeterm LOGONMSG
HF TERMINAL Typeterm HORIZFORM
MAXSIZE MODESET Sessions MAXIMUM
MODENAME SYSTEM Sessions MODENAME
NETNAME SYSTEM/TERMINAL Connection NETNAME
NETNAME SYSTEM/TERMINAL Sessions NETNAME
PGESTAT=AUTOPAGE TERMINAL Typeterm AUTOPAGE
RELREQ TERMINAL Sessions DISCREQ
RELREQ TERMINAL Typeterm DISCREQ
RUSIZESYSTEM/MODESET/TERMINAL Sessions RECEIVESIZE
RUSIZE SYSTEM/MODESET/TERMINAL Typeterm RECEIVESIZE
SYSIDENT SYSTEM/MODESET/TERMINAL Sessions CONNECTION
TCTUAL SYSTEM/MODESET/TERMINAL Sessions USERAREALEN
TCTUAL SYSTEM/MODESET/TERMINAL Typeterm USERAREALEN
TIOAL SYSTEM/TERMINAL Sessions IOAREALEN
TIOAL SYSTEM/TERMINAL Typeterm IOAREALEN
TRMIDNT TERMINAL Sessions SESSNAME
TRMIDNT TERMINAL Terminal TERMINAL
TRMMODL TERMINAL Typeterm TERMMODEL
TRMSTAT=RECEIVE SYSTEM/TERMINAL Typeterm ATI(YES) and TTI(NO)
TRMSTAT=TRANSCEIVESYSTEM/MODESET/TERMINAL Typeterm ATI(NO) and TTI(YES)
TRMTYPE=LUTYPE62 SYSTEM/TERMINAL Sessions PROTOCOL(APPC)
TRMTYPE=LUTYPE62 SYSTEM/TERMINAL Connection PROTOCOL(APPC)
VF TERMINAL Typeterm VERTICALFORM