KDCLTAC - Change the properties of LTACs

The properties of LTACs can be changed with the aid of KDCLTAC. LTACs are the local TAC names for services in partner applications for distributed processing.

Effect in UTM cluster application

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

Period of validity of the changes

The changes only apply for the duration of the current application run.

---

KDCLTAC     LTAC={ ltacname | (ltacname_1,...,ltacname_10) }

           [ ,STATUS={ ON| OFF } ]

           [ ,WAITTIME=(accesswait_sec[,replywait_sec]) ]

---

For administration using message queuing you must enter KDCLTACA.

LTAC=(ltacname_1,...,ltacname_10)
		Names of the LTACs to be administered. For ltacname_1,...,ltacname_10, enter the names of LTACs created dynamically by means of KC_CREATE_OBJECT for the object type KC_LTAC or using the KDCDEF control statement LTAC. For each call from KDCLTAC you can enter a maximum of 10 LTAC names.  If you only enter one LTAC name you do not need to key in the parentheses.
STATUS =		Disable LTACs or lift the blocks
	OFF	The specified LTACs are disabled and no more jobs are accepted for this LTAC.
	ON	The lock is lifted: jobs for the specified LTACs are accepted once again.
WAITTIME
		Replaces the wait times specified by the generation or administration and replaces them by values specified in accesswait_sec and replywait_sec.
	accesswait_sec
		Maximum time in seconds that the system should wait for a session to be reserved (possibly including the establishment of a connection) or for the establishment of an association. A wait time of accesswait_sec != 0 for asynchronous TACs indicates that the job is always entered in the message queue for the partner application. A wait time of accesswait_sec=0 indicates the following:  In dialog TACs, the service continues in the local application immediately with an appropriate return code if no session or association is available or because the local application is a contention loser (see the KDCDEF control statement SESCHA, LPAP or OSI-LPAP, operand CONTWIN). With asynchronous TACs, the asynchronous job is rejected with a return code at the FPUT call stage if no logical connection to the partner application exists. If there is a logical connection to the partner application, the message is entered in the output queue.
	replywait_sec
		Maximum time in seconds that UTM can wait for an answer from the remote service of the partner application.  Restricting the wait time helps to ensure that the wait time for users on the terminal cannot go on indefinitely. replywait_sec=0 indicates that the system will wait for unrestricted periods of time. Minimum value: WAITTIME = (0.0) (see above for meaning)  Maximum value: WAITTIME = (32767.32767)

Output from KDCLTAC

The new and old properties of the specified LTACs are output to the administrator terminal.

LTAC          STATUS        ACCESSWAIT       REPLYWAIT
            NEW    OLD      NEW     OLD      NEW     OLD
ltacname   ON|OFF ON|OFF    seconds seconds  seconds seconds

Explanation of the output

LTAC	TAC name of the remote services
STATUS	LTAC disabled (OFF) or not (ON)
ACCESSWAIT	Wait time until a session or association is reserved.
REPLYWAIT	Wait time for a response to the service program in the partner application