KDCPOOL - Administer LTERM pools

KDCPOOL allows you to redefine the number of enabled and/or disabled clients for an LTERM pool.

Effect in UTM cluster applications

In UTM cluster applications, KDCPOOL applies globally to the cluster.

Period of validity of the change

The change remains in force after the application has terminated.

---

KDCPOOL

LTERM=ltermprefix [ ,STATUS=( { ON| OFF }, number_clients ) ]

---

For administration using message queuing you must enter KDCPOOLA.

LTERM=ltermprefix
		LTERM prefix of the LTERM pool, as generated in the KDCDEF control statement TPOOL. If you enter ltermprefix, the LTERM pool to be administered is identified uniquely.
STATUS=
		Defines the number of clients able to connect via the LTERM pool at the same time. The maximum number of clients able to connect via the LTERM pool at the same time is defined during KDCDEF generation (NUMBER in the control statement TPOOL). Using the administration function you can reduce this number or increase a number that has previously been reduced back to the maximum number.
	(ON,number_clients)
		number_clients defines the number of approved LTERM partners for the LTERM pool.
	(OFF,number_clients)
		number_clients defines the number of disabled LTERM partners in the LTERM pool, i.e. the maximum number of LTERM partners defined during KDCDEF generation is reduced by number_clients. Locks assigned to LTERM partners in an LTERM pool operate as follows: UTM rejects a connection request from a client if the permissible number of LTERM partners for that LTERM pool has already been reserved by other clients. If, at the time the command is processed, more connections to the LTERM pool exist than the permissible number of LTERM partners, then all existing connections are initially retained.  The lock only takes effect after the connection has been shut down if a client has placed a new communication request.  If terminal users sign off with KDCOFF BUI they can sign back on with KDCSIGN even if, at this time, more than the permissible number of LTERM partners in the LTERM pool are still reserved. Minimum value of number_clients: 0 Maximum value of number_clients:  The maximum number of clients specified for KDCDEF generation which can connect at the same time through this LTERM pool. If, when clients are approved (ON,number_clients) number_clients is greater than the maximum value, UTM automatically reduces the value for number_clients to the maximum value.

Output from KDCPOOL

The new and old number of clients enabled for the LTERM pool is output to the administrator terminal in the following form.
The output depends on whether a short or a long host name is assigned to a LTERM pool object. In the case of a long host name, the information on a LTERM pool object is output in two screen lines.

POOL        PRONAM   BCAMAPPL  PTYPE  STA=ON
                                      NEW    OLD
ltermprefix proname  applname  ptype  number number
ltermprefix long.processor.name
                     applname  ptype  number number

Explanation of output

POOL	LTERM prefix generated for the LTERM pool
PRONAM	Name of the computer to which the LTERM pool was assigned
BCAMAPPL	Name of the UTM application assigned to the LTERM pool during KDCDEF generation
STA=ON	Number of LTERM partners approved for the LTERM pool before the command was processed (OLD) and the number of LTERM partners currently approved for the LTERM pool (NEW).