TCT - Terminal Control Table

Top  Previous  Next

This table defines names of the terminals allowed to connect to the application.

To define an entry in this table the directive define terminal is used. If a large set of terminals must be generated the directives define terminalset and define browserset can bu used.

define terminal

Defines a terminal entry in the XCICS/TS terminal table (TCT).

define terminal name=<value>,
device=<value>,
[type=(standard|printer|virtual|web|session|remote)],
netname=<value>],
[address=x.x.x.x],
[remote_name=<value>],
[remote_system=<value>];

 

name

This is the logical name of the terminal as expected from the user program; this name is mandatory and it is passed back to the user program in the EIBTRMID field of the EIB control block; it must be unique within the application

type

Different kind of terminals can be connected to XCICS:

Network terminals (standard)
Printers
SNA sessions
Remote terminals
Virtual terminals
WEB terminals

Network terminals come from the network, generated by a connection from X4J or XTND (both UNIX and Windows version).

The virtual terminals are used as resources by transactions generated by a START TRANSID command, or activated other background services (i.e. TCPIP services)

device

It is the device pool identifier of the terminal. This is the name that must be referred to when defining a connection in X4J or in the device attribute of the terminal element in the XTND configuration file.

More terminals can share the same device name: in such case XCICS assign the first terminal available with the requested device name.

If it is not defined, XCICS sets it equal to the netname. If also netname is not defined, the device is set equal to the terminal name.

physical

(deprecated) Alias name for device parameter.

IP address

It Is the network address of the terminal, specified in the format xxx.xxx.xxx.xxx (i.e. 10.1.1.50).

When set, XCICS reserves the terminal entry only for connection incoming from the IP address.specified.

netname

For session type terminals, netname corresponds to the LU alias used in APPC communication.

For other terminal types it may be specified according to user preferences, otherwhise XCICS automatically generates a netname for the terminal. If the terminal is served by an embedded tn3270 service (defined with "add tn3270server" command), the netname is also a constraint for the terminal connection.

remote_system

For remote terminals, specifies the name of the remote system from where the terminal can be used.

remote_name

For remote terminals, specifies the name the can be requested by remote systems. By default it is the same as the logical name.

define terminalgroup

Defines a group of size terminal with a fixed device name, a which logical name is composed by the character prefix and an hexadecimal counter (Pxxx). The maximum group size is 4096.

Syntax:

define terminalgroup        prefix=<value>
device=<value>,
[type=standard,]
size=<value>;

 

define terminalset

Defines a group of terminal with logical name prefixed by prefix, of the specified type and physical, in the nework net in the specified range.

Syntax:

define terminalset prefix="<2 chars prefix>",
physical=(WIN0-9|free),
net=x.x.x,
from=x,
to=x;

 

define browserset

Defines a slot of webterm entry coming from a specified webserver.

Syntax

define browserset webserver=x.x.x.x size=<value>;