CICS Macro and Operand Descriptions [ HP SNA Products Remote System Configuration Guide ] MPE/iX 5.0 Documentation
HP SNA Products Remote System Configuration Guide
CICS Macro and Operand Descriptions
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.
AUDALARMspecifies the IBM 3270 audible alarm
feature.
COLORspecifies the extended color feature which
allows colors to be selected for each field or
character.
EXTDSspecifies extensions to the IBM 3270 data
stream.
HILIGHTspecifies the extended highlighting feature.
This enables fields or characters to be displayed
in reverse-video, underline mode, or blink.
SELCTPENspecifies the 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. AUTOPAGEindicates 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.
TRANSCEIVEspecifies that a given terminal can
initiate transactions and receive messages.
RECEIVEindicates that 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. TRANSCEIVEindicates 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-5lists 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 | RDO Attribute |
| | | Definition | |
| | | | |
-------------------------------------------------------------------------------------
| | | | |
| 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=COLOR | TERMINAL | Typeterm | ERRCOLOR |
| | | | |
| ERRATT=INTENSIFY | TERMINAL | Typeterm | ERRINTENSIFY |
| | | | |
| ERRATT=LASTLINE | TERMINAL | Typeterm | ERRINTENSIFY |
| | | | |
| FEATURE=AUDALARM | TERMINAL | Typeterm | AUDIBEALARM |
| | | | |
| FEATURE=COLOR | TERMINAL | 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 |
| | | | |
-------------------------------------------------------------------------------------
Table 3-5. TCT Macro to RDO Keyword Cross-Reference (cont.)
-------------------------------------------------------------------------------------
| | | | |
| DFHTCT Operand | DFHTCT Type= | Resource | RDO Attribute |
| | | Definition | |
| | | | |
-------------------------------------------------------------------------------------
| | | | |
| 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 |
| | | | |
| RUSIZE | SYSTEM/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=TRANSCEIVE | SYSTEM/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 |
| | | | |
-------------------------------------------------------------------------------------
MPE/iX 5.0 Documentation