This modification relates to a session for distributed processing using the LU6.1 protocol.
In the identification area you must pass the session name (LSES name from KDCDEF generation) to UTM (kc_name8 in the union kc_id_area).
In the data area you must pass the data structure kc_lses_str with the new values of the properties.
Possible modifications
Establish a transport connection to the partner application for the session.
Field name
Meaning
connect_mode='Y'
con,
pronam,
bcamapplA transport connection is to be established for the session.
If a specific transport connection is to be established for a session, then you must unambiguously specify this transport connection in con, pronam, bcamappl. To do this, you must specify the following information:
in con, the name of the connection defined at creation or generation of the CON object
in pronam the name of the computer on which the partner application is running
in bcamapp the name of the local UTM application (BCAMAPPL name) through which the connection to the partner application is established.
If you do not specify con, pronam, bcamappl, then UTM establishes any of the transport connections configured dynamically or generated for the partner application with the KDCDEF control statement CON.
A connection cannot be established if the associated LPAP partner is disabled (see KC_LPAP state ='N' in chapter "obj_type=KC_LPAP").
If the LPAP partner is disabled, it must be released with an explicit KC_MODIFY_OBJECT call before the connection is established (KC_LPAP with state='Y').Period of validity / transaction management: type A ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
Shut down the transport connection that exists for the session.
You can instruct UTM to shut down the connection immediately or you can assign the property QUIET to the connection. QUIET means that UTM shuts down the connection to the partner application as soon as the session is no longer occupied by jobs (dialog or asynchronous jobs). No further new dialog jobs are accepted. New asynchronous jobs are accepted, but no longer sent; they remain in the output queue.
Field name
Meaning
connect_mode='N'
The connection to the partner application that exists for the session is to be shut down immediately.
Shutting down the connection with connect_mode = 'N' takes immediate effect, with the result that services or conversations may be terminated abnormally. It is better to shut down the connection with quiet_connect = 'Y'.Period of validity / transaction management: type A ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
Field name
Meaning
quiet_connect='Y'
Set the property QUIET for the connection to the partner application.
The property QUIET is cancelled with connect_mode='Y'.Period of validity / transaction management: type IR ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
No other field in the data structure can be occupied at the same time as connect_mode='N'. In particular, connect_mode and quiet_connect cannot be set simultaneously.
If a connection which has previously been set to QUIET is now set to connect_mode='N', the connection is shut down immediately. The property QUIET is overwritten by connect_mode='N'.
