KDCLTERM - Change the properties of LTERM partners

KDCLTERM allows you to change the properties of LTERM partners for clients, printers and LTERM pools. You can disable and enable the LTERM partners and shut down or establish connections to clients and printers.

Effect in UTM cluster applications

The effect in UTM cluster applications is described in the sections devoted to the individual operands since some of the changes made with KDCLTERM apply locally to the node whereas others take effect globally in the cluster.

Period of validity of the change

All changes remain in force after the application has terminated.

---

KDCLTERM    LTERM={ ltermname | (ltermname_1,ltermname_2,...,ltermname_10) }

           [ ,ACTION={ CON| DIS } ]

           [ ,STATUS={ ON| OFF } ]

           [ ,PRIMARY=primary-lterm]

---

For administration using message queuing you must enter KDCLTRMA.

LTERM=(ltermname_1,...,ltermname_10)
		Name of the LTERM partner to be administered.  For each call from KDCLTERM you can enter a maximum of 10 LTERM names. If you only enter one LTERM partner ltermname LTAC name you do not need to key in the parentheses. For ltermname_1,...,ltermname_10 you can also enter the names of LTERM partners assigned to an LTERM pool. To do this, enter the full name of this LTERM partner, i.e. the LTERM prefix of the LTERM pool and the serial number.  However, you cannot disable the LTERM partners assigned to LTERM pools, nor can you establish any connections to them. In other words, the only entry you can make for them is ACTION=DIS (connection shutdown).
ACTION=		Establishes or shuts down connections to the LTERM partners In UTM cluster applications, the operand applies locally in the node.
	CON	This causes connections to be established to the specified LTERM partners.  For LTERM partners in an LTERM pool, ACTION=CON is not permitted. In UTM applications running on Unix, Linux or Windows systems this function is only available for printers, andTS applications.
	DIS	Connections to the specified LTERM partners are shut down (DISabled).  Connections are shut down immediately, which means that processes cannot be terminated.
STATUS=		Disable or enable the LTERM partner. In UTM cluster applications, the operand applies globally in the cluster.
	ON	Enable the LTERM partner
	OFF	Disable the specified LTERM partner. The block operates as follows: A connection request is executed. The connection is established and the following message is issued: K027 LTERM partner ltermname disabled - inform administrator or enter KDCOFF An existing connection remains established. Every input with the exception of KDCOFF is acknowledged with the following message: K027 LTERM partner ltermname disabled - inform administrator or enter KDCOFF The block does not take effect until this connection has reached a synchronization point (end of transaction). KDCOFF BUT operates for disabled LTERM partners like KDCOFF. LTERM partner in an LTERM pool cannot be disabled.
PRIMARY=primary-lterm
		Name of a normal LTERM or a primary LTERM of an LTERM group (seeopenUTM manual “Generating Applications”). The PRIMARY operand is only permitted in standalone UTM applications. The LTERM must be an alias LTERM of an LTERM group. Specifying PRIMARY= causes it to become an alias LTERM of the LTERM group with the primary LTERM primary-lterm. If primary-lterm is already the primary LTERM of an LTERM group, the LTERM is assigned to this group. If no alias LTERMs have previously been assigned to primary-lterm, and new LTERM group is now created with the primary-lterm as the primary LTERM and ltermname (LTERM=) as the alias LTERM. If primary-lterm is a normal LTERM, it must meet the following conditions: A PTERM with the PTYPE APPLI or SOCKET must be assigned to it. It must not be a slave LTERM of an LTERM bundle. It must have been generated with USAGE=D.

Output from KDCLTERM

The new and old properties of the LTERM partner (NEW, OLD) are displayed on the administrator terminal. The output 'POOL LTERM' indicates that the client is connected by means of an LTERM pool.

LTERM      STATUS            CONNECTION
           NEW      OLD      NEW        OLD
ltermname  ON|OFF   ON|OFF   CON|DIS|W  CON|DIS|W [POOL LTERM]

Explanation of the output

LTERM	Name of the LTERM partner
STATUS	The LTERM partner is disabled (OFF) or not disabled (ON).
CONNECTION
	Connection to the LTERM partner is established (CON) or shut down (DIS), or openUTM is currently trying to establish a connection (W = waiting for a connection).