Connecting clients via LTERM partners

If you wish to connect terminals, UPIC clients and TS applications individually, you will need to supply the following generation statements for each client:

• an LTERM statement for the logical connection point

• a PTERM statement for the physical client.

UPIC clients and TS applications may also require a BCAMAPPL statement. Limits, maximum values and parameters, which are to be set throughout the application for communication between clients and the UTM application, are defined in the MAX statement.

LTERMs and PTERMs may also be created dynamically (objects KC_LTERM and KC_PTERM). Moreover, the assignment of the client to the LTERM partner in the PTERM statement can be adapted dynamically at a later stage using administration functions. For example, you can assign another client (of the same type) to an LTERM partner during operation, or assign another LTERM partner – for which you may have defined different access rights – to a client. See also the openUTM manual “Administering Applications”.

LTERM statement in section "LTERM - define an LTERM partner for a client or printer" The most important properties for LTERM partners, via which clients can connect to an application, are defined with the following operands:

• ltermname

  Name of the LTERM partner. Logical name via which the client, to which the LTERM partner is assigned, is addressed by the program units of the application.

• KSET=

  Key set of the LTERM partner, i.e. an authorization profile that defines which parts of the application program (which TACs) are available to the client connecting to the application via this LTERM partner.

• LOCALE= (only BS2000 systems)

  LTERM-specific language environment of the clients that connect to the application via this LTERM partner. This language environment is also used by openUTM to output messages, as long as no user is signed on.

• LOCK=

  Lock code as system access control. The connection is only established when the client signs on to openUTM with a user ID, for which a key set was generated, using a key code corresponding to this lock code.

• USAGE=D

  Type of communication partner. In this case, dialog partners are connecting to the application via the LTERM partner. Messages can be exchanged in both directions.

• USER=

  The user ID under which the client is automatically signed on when a connection has been established, see "Automatic sign-on under a specific user ID". You are also able to define other characteristics for this user ID, see "Generating security functions".

PTERM statement in section "PTERM - define the properties of a client/printer and assign an LTERM partner" The most important properties for physical clients are defined with the following operands:

• ptermname

  Name of the client as generated in the system of the server application.

  BS2000 systems (without Socket application):
  The BCAM name of the client must be specified.

  Socket applications:
  If the connection is to be established from the local UTM application to the client, then any ptermname can be selected. Otherwise, the name must have the format PRTnnnnn.Here nnnnn means the port number used by the socket application to establish the connection.

  See "Providing address information" for more information.

• BCAMAPPL=

  Name of the local application via which the transport system establishes the connection between the client and the UTM application. This name must be defined in a BCAMAPPL statement or using MAX ...APPLINAME=. If you omit this operand, the name is taken from MAX ...APPLINAME=. Terminals may only use names that are defined in MAX ... APPLINAME=.

• ENCRYPTION-LEVEL=

  For UPIC clients you specify the minimum encryption level that must be maintained on the connection to the client. You can specify trustworthy for the client, which means that this client is permitted to work with the UTM application without encryption. See also "Message encryption on connections to clients" for more information on encryption.

• LTERM=

  The LTERM partner ltermname, via which the client connects to the UTM application, is assigned to the physical client as a logical connection point.

• PRONAM=

  Symbolic name of the processor on which the client resides.

• PTYPE=

  Type of client connected via the LTERM partner. Here you specify whether the client is a transport system application, a UPIC client or a terminal.

• T-PROT=, TSEL-FORMAT= (only on Unix, Linux and Windows systems),LISTENER-PORT= (with PTYPE=SOCKET also on BS2000 systems)

  Components of the transport address of a remote UPIC client or a TS application see "Providing address information".

• USAGE=D (only BS2000 systems)

  USAGE=D defines that the communication partner is a dialog partner. Messages can be exchanged between the UTM application and the client.

• USP-HDR=

  With a sockets applications that use the USP protocol, this parameter controls which of the output messages openUTM is to create a protocol header for, see "USP headers for outputmessages to socket connections".

BCAMAPPL statement in section "BCAMAPPL - define additional application names" It is possible to define additional application names for UPIC clients and TS applications.

• appliname

  Name of the local application used by the transport system to establish the connection between the client and the UTM application. If this name is used for socket applications, it may not be used by a different type of partner.

• SIGNON-TAC=

  Specifies if and when a sign-on service takes place, when a client attempts to sign on under this application name, see "Generating sign-on services for clients".

• TSEL-FORMAT=, LISTENER-ID= (only on Unix, Linux and Windows systems),LISTENER-PORT= (with PTYPE=SOCKET also on BS2000 systems)
  T-PROT=

  For information about the components of the transport address under which client contacts the UTM application, see "Providing address information".

MAX statement in section "MAX - define UTM application parameters" Default and maximum values, which are relevant for communication of clients with the UTM application, are defined with the following operands:

• CONN-USERS=

  Controls the utilization of the application. The operand defines the maximum number of users who can simultaneously work with the application. In the case of an application for which no user IDs are generated, CONN-USERS= defines the maximum number of clients that can simultaneously connect to the application via LTERM partners.

• LOCALE= (on BS2000 systems only)

  Defines the default language environment (locale) of the UTM application. The locale generated here is assigned to the clients connected via LTERM partners or LTERM- pools as the default value for the language environment. The default setting applies unless a specific locale is defined for these objects in the corresponding LTERM or TPOOL statements. See also "Defining the language environment - setting the locale".