This modification relates to an LTAC, i.e. to a local application transaction code for a service in a partner application.
You must pass the name of the LTAC to UTM in the identification area (kc_name8 in the union kc_id_area).
In the data area you must pass the data structure kc_ltac_str with the new values of the properties.
Possible modifications
You can modify the maximum time which UTM will wait to access a session when requesting a remote service. To do this, specify the following in kc_ltac_str:
Field name
Meaning
accesswait_sec[5]
Specify in accesswait_sec the time in seconds which UTM at most is to wait after the LTAC call to reserve a session or to establish an association.
When specifying the time, you should remember that the actual transport connection to the partner application may still have to be established.In asynchronous LTACs, accesswait_sec
!=
0 means that the job is always entered in the local message queue for the partner application.Wait time accesswait_sec=0 means:
In dialog LTACs, the local service that is calling the remote service is immediately continued with the appropriate return code if no session or association to the partner application is free or if the local application is the “contention loser” (see kc_lpap_str "kc_lpap_str - Properties of LU6.1 partner applications"; field contwin).
In asynchronous LTACs, the asynchronous job is rejected with a return code at the FPUT call if no connection to the partner application exists. If there is a connection to the partner application, the message is entered in the message queue.Minimum value: '0'; maximum value: '32767'
Period of validity / transaction management: type GPR ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
You can modify the maximum time which UTM will wait for a reply from a remote service. To do this, specify the following in kc_ltac_str:
Field name
Meaning
replywait_sec[5]
Specify in replywait_sec the maximum time in seconds which UTM is to wait for a reply from the remote service.
By limiting the waiting time, it can be ensured that users do not have to wait indefinitely at the terminal.
replywait_sec = '0' means: wait without a time limit.
Minimum value: '0'; maximum value: '32767'Period of validity / transaction management: type GPR ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
You can disable the LTAC or release it again. Disabling an LTAC means that no further jobs are accepted from the local application for the remote service to which the LTAC is assigned. To do this, specify the following in kc_ltac_str:
Field name
Meaning
state='N'
The LTAC is to be disabled, UTM is to accept no further jobs for the associated remote service.
state='Y'
The (disabled) LTAC is to be released, i.e. the lock is to be cancelled.
Period of validity / transaction management: type GPR ("KC_MODIFY_OBJECT - Modify object properties and application parameters")