Terminal definition attributes

Read syntax diagramSkip visual syntax diagram
>>-TERMINAL(name)--GROUP(groupname)--+-------------------+------>
                                     '-DESCRIPTION(text)-'   

   .-AUTINSTMODEL(NO)-------------------------------------.   
>--+------------------------------------------------------+----->
   '-+-AUTINSTMODEL(ONLY)-+--+--------------------------+-'   
     '-AUTINSTMODEL(YES)--'  '-AUTINSTNAME(autinstname)-'     

                          .-SOLICITED(NO)--.   
>--+-------------------+--+----------------+-------------------->
   '-CONSNAME(console)-'  '-SOLICITED(YES)-'   

   .-INSERVICE(YES)-.                                         
>--+----------------+--+------------+--+------------------+----->
   '-INSERVICE(NO)--'  +-NATLANG(E)-+  '-NETNAME(netname)-'   
                       '-NATLANG(K)-'                         

>--+----------------+------------------------------------------->
   '-POOL(poolname)-'   

>--+--------------------------------------------------------------------------------------------+-->
   |                       .-PRINTERCOPY(NO)--.                                                 |   
   '-+------------------+--+------------------+--+--------------------------------------------+-'   
     '-PRINTER(printer)-'  '-PRINTERCOPY(YES)-'  |                      .-ALTPRINTCOPY(NO)--. |     
                                                 '-ALTPRINTER(printer)--+-------------------+-'     
                                                                        '-ALTPRINTCOPY(YES)-'       

>--+-----------------------+------------------------------------>
   '-REMOTESYSNET(netname)-'   

>--+---------------------------------------------------+-------->
   '-REMOTESYSTEM(connection)-+----------------------+-'   
                              '-REMOTENAME(terminal)-'     

                                   .-TASKLIMIT(NO)-----.   
>--+----------------------------+--+-------------------+-------->
   '-SECURITYNAME(securityname)-'  '-TASKLIMIT(number)-'   

   .-TERMPRIORITY(0)--------.                                 
>--+------------------------+--+--------------------------+----->
   '-TERMPRIORITY(priority)-'  '-TRANSACTION(transaction)-'   

>--TYPETERM(typeterm)--+----------------+----------------------->
                       +-USERID(userid)-+   
                       +-USERID(*EVERY)-+   
                       '-USERID(*FIRST)-'   

>--| APPC attributes |-----------------------------------------><

APPC attributes

   .-ATTACHSEC(LOCAL)------.  .-BINDSECURITY(NO)--.   
|--+-----------------------+--+-------------------+------------->
   +-ATTACHSEC(IDENTIFY)---+  '-BINDSECURITY(YES)-'   
   +-ATTACHSEC(MIXIDPE)----+                          
   +-ATTACHSEC(PERSISTENT)-+                          
   '-ATTACHSEC(VERIFY)-----'                          

                           .-USEDFLTUSER(NO)--.   
>--+--------------------+--+------------------+-----------------|
   '-MODENAME(modename)-'  '-USEDFLTUSER(YES)-'   

ALTPRINTCOPY({NO|YES})
specifies whether the hardware COPY feature is to be used to satisfy a print request on the printer named in the ALTPRINTER attribute. For further details, see the PRINTERCOPY attribute.
NO
CICS® should use the hardware COPY feature.
YES
CICS should not use the hardware COPY feature.
ALTPRINTER(printer)
specifies the name of a 3270 printer to be used, if the printer named in the PRINTER attribute of this terminal definition is unavailable. The name may be up to four characters in length. For further details, see the PRINTER attribute. If you specify an ALTPRINTER without specifying a PRINTER, ALTPRINTER is ignored.

The printer you name must be owned by the same CICS system that owns this terminal definition.

If you want to specify the hardware COPY feature for the alternative printer, specify YES for ALTPRINTCOPY on this terminal definition.

ATTACHSEC({LOCAL|IDENTIFY|VERIFY| PERSISTENT|MIXIDPE}) (APPC only)
specifies the level of attach time user security required for the connection. PERSISTENT and MIXIDPE are valid only with VTAM® as the access method and when APPC is being used.
LOCAL
The authority of the user is taken to be that of the link itself, and you rely on link security alone to protect your resource.
IDENTIFY
Incoming attach requests must specify a user identifier. Specify IDENTIFY when the connecting terminal has a security manager.
MIXIDPE
A connection is able to support attaches using either or both of the IDENTIFY and PERSISTENT security types. The security type used depends on the incoming attach.

As in previous releases, IDENTIFY implies a degree of trust between the two systems that allows this system to accept the sign-on logic of the other system. In effect, this is a distributed security manager, with one system doing the sign-on and the other doing the security check.

PERSISTENT
This involves a user sign-on to a remote system that persists over multiple conversations until the user signs off from the remote system. In this way, the user's ID and password are passed only on the first (sign-on) attach. Subsequent attach requests require only the user's ID.
VERIFY
Incoming attach requests must specify a user identifier and a user password. Specify VERIFY when the connecting terminal has no security manager and therefore requires verification.
AUTINSTMODEL({NO|YES|ONLY})
specifies whether this terminal definition can be used as a model terminal definition for autoinstall. For more information on autoinstall and model terminal definitions, see Autoinstalling VTAM terminals.
NO
This definition is not used as a model for autoinstall. It is used only as a definition for a specific device that is not autoinstalled.
ONLY
This definition is used only as a model for autoinstall. It is not used as a definition for a specific device.
YES
This definition is used for a specific device that is not autoinstalled. The definition is also used as a model for automatic installation.
AUTINSTNAME(autinstname)
specifies the name by which this model definition is known in the autoinstall control program. The name can be up to eight characters in length.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.

You need specify this only if AUTINSTMODEL is YES or ONLY. You can let it default to the terminal name followed by four blanks, as long as this is acceptable to the autoinstall control program. For more information about autoinstall models, autoinstall names, and the autoinstall control program, see Autoinstall control program.

BINDPASSWORD
This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. For more information, see Obsolete attributes.
BINDSECURITY({NO|YES}) (APPC only)
specifies whether an external security manager (ESM) is being used for bind-time security.
NO
No external bind-time security is required.
YES
If security is active and the XAPPC system initialization parameter is set to YES, CICS attempts to extract the session key from RACF® in order to carry out bind-time security. If no RACF profile is available, the bind fails.
Start of changeCONSOLE({NO|number})End of change
Start of changeThis attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. See Obsolete attributes retained for compatibility for more information.End of change
CONSNAME(console)
Using CONSNAME, you can install a CICS console definition without having an existing console, and without the console being previously defined in the CONSOLnn member of the MVS SYS1.PARMLIB. However, before you can use the console, you must define the name to MVS, either in the CONSOLnn member of SYS1.PARMLIB or by dynamic allocation. The length of CONSNAME must be 2–8 characters and must begin with an alphabetic character or one of #, @, or $. It uniquely identifies the console device within a CICS region, regardless of the MVS image to which it is connected; that is, you cannot install two console definitions with the same CONSNAME. The CONSNAME corresponds to the name defined for the console in the MVS SYS1.PARMLIB member, CONSOLnn.

To define a TSO user as a console device, specify CONSNAME(name), where name is the TSO userid. This enables a TSO user authorized to use the TSO CONSOLE command to initiate CICS transactions. The TSO userid does not have to be defined in the CONSOLnn member of SYS1.PARMLIB member.

The equivalent of CONSOLE(00) is CONSNAME(INTERNAL) or CONSNAME(INSTREAM), depending on the service level of CICS and the release of MVS being used; specify this if you want to initiate a CICS transaction and issue a command to it in a JCL statement. For guidance about using JCL to issue CICS commands, see the CICS Operations and Utilities Guide.

DESCRIPTION(text)
You can provide a description of the resource you are defining in this field. The description text can be up to 58 characters in length. There are no restrictions on the characters that you can use. However, if you use parentheses, ensure that for each left parenthesis there is a matching right one. If you use the CREATE command, for each single apostrophe in the text, code two apostrophes.
GROUP(groupname)
Every resource definition must have a GROUP name. The resource definition becomes a member of the group and is installed in the CICS system when the group is installed.
Acceptable characters:
A-Z 0-9 $ @ #
Any lower case characters you enter are converted to upper case.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters. Do not use group names beginning with DFH, because these characters are reserved for use by CICS.

INSERVICE({YES|NO})
specifies the status of the terminal that is being defined.
YES
Transactions may be initiated and messages may automatically be sent to the terminal.
NO
The terminal can neither receive messages nor transmit input.
MODENAME(modename) (APPC single session terminals only)
specifies the name that is passed to VTAM as the LOGMODE name. The name may be up to eight characters in length, but may not have the reserved name SNASVCMG. The name follows assembler language rules. It must start with an alphabetic character.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.

For further guidance on the LOGMODE name, see the CICS Transaction Server for z/OS® Installation Guide.

NATLANG({blank|E|K})
specifies the language in which all NLS-enabled messages are displayed for this terminal.
Use only one character, which can be A-Z 1-9.
blank
If you leave this blank and do not supply a value, CICS uses the system default as specified in the system initialization table (SIT).
E
English
K
Japanese
NETNAME(netname)
specifies the network name that identifies the terminal to ACF/VTAM. The name may be up to 8 characters in length. The name follows assembler language rules. It must start with an alphabetic character.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.

If you do not specify a name, the NETNAME defaults to the TERMINAL name.

The NETNAME must be unique except in the case of a remote terminal. That is, you cannot install two local terminals with the same NETNAME, or a local terminal and any connection with the same NETNAME. However, the NETNAME for a remote terminal can be the same as the NETNAME for any other terminal or the NETNAME for any connection.

If the CICS region supports VTAM dynamic LU alias (that is, LUAPFX=xx is specified on the CICS region's APPL statement), the terminal with this NETNAME is assumed to be in the same network as the CICS region. If the terminal is in another network, it must be defined to VTAM on a CDRSC definition with a predefined LUALIAS (LUALIAS=netname) to override VTAM dynamic allocation. In this case, netname on the LUALIAS parameter must match the NETNAME defined on this terminal resource definition.

OPERID
This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. For more information, see Obsolete attributes.
OPERPRIORITY
This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. For more information, see Obsolete attributes.
OPERRSL
This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. For more information, see Obsolete attributes.
OPERSECURITY
This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS. For more information, see Obsolete attributes.
POOL(poolname)
specifies the pool name for a 3600 or 3650 pipeline terminal pooled with other pipeline terminals.

When you define a 3600 pipeline logical unit, you generate a TCTTE that is associated with a pool of TCTTEs. A pool of pipeline TCTTEs can be used by one pipeline logical unit, or it can be shared by a number of pipeline logical units.

The pool name is used only as a method of identifying the related TERMINAL definitions on the CSD file. It is not used within the active CICS system. The name can be up to 8 characters in length.

Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.

For a pipeline terminal, you must specify a TYPETERM with SESSIONTYPE(PIPELINE) specified. You must specify a TASKLIMIT on at least one of the pool of pipeline terminals. You must name the same group for each of the pipeline terminals in a pool.

An example of the definitions for a pool of pipeline terminals follows.
DEFINE TERMINAL(ttt1) GROUP(g) POOL(poolid)
       TYPETERM(xxxxxxxx) NETNAME(nnnnnnn1)...
DEFINE TERMINAL(ttt2) GROUP(g) POOL(poolid)
       TYPETERM(xxxxxxxx) NETNAME(nnnnnnn2)...
DEFINE TERMINAL(ttt3) GROUP(g) POOL(poolid)
       TYPETERM(xxxxxxxx) NETNAME(nnnnnnn3)...
DEFINE TERMINAL(ttt4) GROUP(g) POOL(poolid)
       TASKLIMIT(nn) TYPETERM(xxxxxxxx)
       NETNAME(nnnnnnn4)...
DEFINE TYPETERM(xxxxxxxx) GROUP(g)
       DEVICE(3650) SESSIONTYPE(PIPELINE)
PRINTER(printer)
specifies the name of the primary 3270 printer to be used to respond to an ISSUE PRINT command, or a PRINT request from an operator pressing a program access (PA) key. The name may be up to four characters in length. The name is the TERMINAL name on the definition for the printer. If you name a PRINTER here, the TYPETERM referenced by this TERMINAL definition must have PRINTADAPTER(NO).

The printer you name must be owned by the same CICS system that owns this TERMINAL definition.

You can name a PRINTER if this TERMINAL definition is for one of the following:
  • A 3270 display without the printer-adapter feature
  • A 3270 display attached to a 3274 control unit
  • A 3276 control unit display station
  • A 3790 in 3270 compatibility mode

If you want to specify the hardware COPY feature, specify PRINTERCOPY(YES) on this TERMINAL definition.

Note that SNA character string (SCS) printers accept only 3790 data streams; they do not accept 3270 data streams. They therefore cannot be used to print the contents of a display unit's buffer.

If you use a program attention key (for example, PA1) to print the contents of the screen on an associated VTAM printer, the screen size of the printer is chosen according to the SCRNSIZE operand as defined in the CICS-supplied default profile DFHCICST. This profile is defined with SCRNSIZE(DEFAULT) and, if you want to use the alternate screen size of the printer, you have to change the profile entry for transaction CSPP.

PRINTERCOPY({NO|YES})
specifies whether the hardware COPY feature is to be used to satisfy a print request on the printer named in the PRINTER attribute of this terminal definition.

CICS uses the hardware COPY feature of the 3270 to perform the print, unless a task is currently attached to the display.

You need not specify COPY(YES) on the typeterm definition, because this is implied by PRINTERCOPY(YES) on the terminal definition.

If you have named an ALTPRINTER as well as a PRINTER, you may specify ALTPRINTCOPY(YES).

To use the COPY feature, both the printer and the display terminal must be on the same 3270 control unit. Otherwise, either the COPY may fail, raising an error condition or, if the display device address is valid for the printer's control unit, copying might be performed from a different display.

Do not specify PRINTERCOPY(YES) if, in a networking environment, the 3270 control unit is connected to a TCAM system in one domain, and a CICS system in another domain has access to the control unit via VTAM. This is because the hardware COPY address is not available to CICS and cannot therefore be used by terminals attached to such a control unit.

The COPY command is invalid for a 3270 compatibility mode display.

REMOTENAME(terminal)
specifies the name by which the terminal is known in the system or region that owns the terminal. The name can be up to four characters in length.
Acceptable characters:
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >
For information about entering mixed case information, see Entering mixed case attributes.
REMOTESYSNET(netname)
specifies the network name (APPLID) of the region that owns the terminal. The name can be up to eight characters in length. It follows assembler language rules, and must start with an alphabetic character.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.
REMOTESYSNET is used where there is no direct link between the region in which this definition is installed and the terminal-owning region. You do not need to specify REMOTESYSNET if either of the following is true:
  • You are defining a local terminal (that is, REMOTESYSTEM is not specified, or specifies the sysid of the local system).
  • REMOTESYSTEM names a direct link to the terminal-owning region. However, if the terminal-owning region is a member of a VTAM generic resources group and the direct link is an APPC connection, you may need to specify REMOTESYSNET. REMOTESYSNET is needed in this case if the NETNAME specified on the CONNECTION definition for the direct link is the generic resource name of the TOR (not the applid).
REMOTESYSTEM(connection)
specifies the name that identifies the intercommunication link to the system that owns the terminal. The name can be up to 4 characters in length.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.

This is the CONNECTION name on the CONNECTION definition for the intercommunication link. If it is not specified, or if it is specified as the sysid of the local system, this terminal is local to this system. If the name is that of another system, the terminal is remote. You can therefore use the same definition for the terminal in both the local system and a remote system.

If there are intermediate systems between this CICS and the terminal-owning region, REMOTESYSTEM should specify the first link in the path to the TOR. If there is more than one possible path, it should specify the first link in the preferred path.

REMOTESYSTEM is ignored if you specify AUTINSTMODEL(YES) or (ONLY).

SECURITYNAME(securityname)
specifies the security name of the remote system.

In a CICS system with security initialized (SEC=YES or MIGRATE), the security name is used to establish the authority of the remote system.

Note: If USERID is specified in the session definition (DEFINE SESSIONS command) associated with the connection definition, it overrides the userid specified in the SECURITYNAME attribute, and is used for link security.

The security name (or USERID on the sessions definition) must be a valid RACF userid on your system. Access to protected resources on your system is based on the RACF user profile and its group membership.

For further information on defining security for MRO, LUTYPE6.1, and APPC connections, see Intercommunication security.

SOLICITED(NO|YES)
specifies whether CICS messages issued to a console should be treated by NetView as solicited or unsolicited.
NO
CICS messages are to be treated as unsolicited
YES
CICS messages are to be treated as solicited. When SOLICITED(YES) is specified for a console, CICS adds the console name or the console identification number, and a command and response token to each console message.
The SOLICITED attribute applies only to consoles; it is ignored for other TERMINAL definitions.
TASKLIMIT({NO|number})
specifies the number of concurrent tasks allowed to run in a pipeline session or in a pool of pipeline sessions.
NO
No concurrent tasks are allowed.
number
The number of concurrent tasks allowed to run, in the range 1 through 32767.

When you define a 3600 pipeline logical unit, you generate a TCTTE that is associated with a pool of TCTTEs. As messages enter CICS from the 3600 pipeline logical unit, a task is attached to process this message, using as an anchor block one of the TCTTEs from the pool. In this way, consecutive messages sent via the pipeline logical unit can be processed concurrently, the number of concurrent transactions being limited by the number of TCTTEs in the pool. The number of TCTTEs in the pool should represent the high-water mark of inquiry activity. In this way, the pipeline facility allows fewer TCTTEs to be defined to CICS than the total number of pipeline inquiry terminals.

TERMINAL(name)
specifies the terminal identifier. For a terminal, the name can be up to four characters in length.
Acceptable characters:
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >
For information about entering mixed case information, see Entering mixed case attributes.
For an APPC LU6.2 single session terminal, the valid characters are A-Z 0-9 $ @ #. If the name supplied is fewer than four characters, it is left-justified and padded with blanks up to four characters. You should not have a TERMINAL definition and a CONNECTION definition with the same name.
Note: If you use a comma (,) in a name, you will be unable to use those commands such as
CEMT INQUIRE TERMINAL(value1,value2)
CEMT SET     TERMINAL(value1,value2)
where the comma serves as a list delimiter. See CICS Supplied Transactions for information about using lists of resource identifiers.
Also, if you are allowing CICS to generate automatically session names, or terminal IDs for consoles, avoid using any of the following symbols as the first Start of changeor fourthEnd of change character in the terminal name:
-
The hyphen is used by CICS for automatically generated terminal names for APPC sessions
> and <
The > (greater than) and < (less than) symbols are used by CICS for automatically generated terminal names for IRC sessions
¬
The ¬ (logical not) symbol is used by CICS for automatically generated terminal names for MVS consoles.

The name specified becomes the name of the TCT entry, when this TERMINAL definition is installed. For this reason, the TERMINAL name should be unique (note that the value CERR is reserved for the identification generated for the error console). If you specify AUTINSTMODEL(ONLY), you need not worry about making the TERMINAL name unique, because it is not used as the name of a TCT entry. If you specify AUTINSTMODEL(YES), the TERMINAL name is used as the name of the TCT entry that is installed in the TCT when the TERMINAL definition is installed; the names of the TCT entries for the autoinstalled terminals are determined by the autoinstall user program.

If the terminal is to be associated with a transient data destination, the terminal name and the destination identification in the DCT must be the same.

TERMPRIORITY({0|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, not exceeding 255.)
TRANSACTION(transaction)
specifies a 1-to 4-character name of the transaction that is to be initiated each time input is received from the terminal when there is no active task.
Acceptable characters:
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >
For information about entering mixed case information, see Entering mixed case attributes.
For VTAM non-3270 devices, a TRANSACTION name of fewer than four characters requires a delimiter.

For information on what happens when a transaction is initiated, see the CICS Application Programming Guide.

If you specify this operand for a 3270 display, the only CICS functions the operator can invoke, other than this transaction, are paging commands and print requests.

You are unlikely to specify the TRANSACTION attribute for a 3270 display or SCS printer. It is optional for 3601 logical units, but is mandatory for 3614 logical units.

If this operand is specified for a 3790 Communication System, and multiple sessions are used to connect the same 3791, specify the same TRANSACTION name for all sessions.

TYPETERM(typeterm)
specifies the name of the TYPETERM definition to be associated with this TERMINAL definition. The name can be up to eight characters in length.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.

The TYPETERM definition specifies many attributes for a number of similar terminals. For more information, see TYPETERM definition attributes and How resources are defined. This attribute is mandatory for all TERMINAL definitions.

The TYPETERM definition should already be installed when you install this TERMINAL definition.

USEDFLTUSER ({NO|YES})      (APPC only)
specifies the kind of security checking that will take place for each inbound attach FMH.
NO
Indicates that each inbound attach FMH will be checked for the presence of those fields required by the ATTACHSEC option and if the required fields are not present a protocol violation message will be issued and the attach will fail. NO is the default.
YES
Indicates that some checks on the validity of the attach FMH are bypassed. This provides the same level of security as in releases of CICS prior to CICS/ESA 4.1. See the CICS RACF Security Guide.
USERID({name|*EVERY|*FIRST})
specifies a user identifier used for sign-on and referred to in security error messages, security violation messages, and the audit trail. It must be a valid userid defined to the security manager.

This is the only way to specify a user identifier for devices such as printers that are unable to sign on using CESN. You can also specify USERID for a display device; if so, the display is permanently signed on. Operators are unable to sign on. All access to protected resources depends on the authorizations permitted by RACF for the specified USERID.

For an APPC single session terminal, this USERID overrides any SECURITYNAME that you have specified for the connection.
name
This can be up to eight characters in length.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.
*EVERY
This is a special operand for autoinstalled consoles only. It means that CICS is to use the userid passed on the MVS MODIFY command every time a MODIFY command is received. The console is signed on using the MVS userid as the preset userid for the console being autoinstalled. The console remains signed on with this userid until the console is deleted or another MODIFY is received with another userid. If a MODIFY command is received without a userid, CICS signs on the default CICS userid until a MODIFY command is received that has a valid userid. For non-console terminals, or if security is not enabled, this value is ignored.
*FIRST
This is a special operand for autoinstalled consoles only. It means that CICS is to use the userid passed on the first MVS MODIFY command that requires the console to be autoinstalled. The console is signed on with the MVS userid as the preset userid. The console remains signed on with this userid until the console is deleted. If a MODIFY command is received without a userid, CICS signs on the default CICS userid. For non-console terminals, or if security is not enabled, this value is ignored.
Note:
  1. If this terminal definition defines a console, the userid must be authorized to the appropriate profile in the CONSOLE general resource class, (see the CICS RACF Security Guide for information about preset security on consoles and terminals).