kc_lses_str - LU6.1 sessions

The data structure kc_lses_str is defined for the object type KC_LSES. In the case of KC_GET_OBJECT, UTM returns the properties of sessions to LU6.1 partners of the application in kc_lses_str.

Sessions to LU6.1 partners can be dynamically created with KC_CREATE_OBJECT, deleted with KC_DELETE_OBJECT, or modified with KC_MODIFY_OBJECT.

A session is identified using the name specified in the LSES statement.

mod 1	Data structure kc_lses_str
-	char ls_name[8];
-	char lpap[8];
-	char rses[8];
-	char con[8];
-	char pronam[8];
-	char bcamappl[8];
x(A)	char connect_mode;
x(IR)	char quiet_connect;
-	char lses_user[8];
-	char ls_deleted;
-	char ls_used;
-	char ptc;
-	char node_name[8];
-	char pronam_long[64];

¹ The contents of the field can be modified using KC_MODIFY_OBJECT; see "obj_type=KC_LSES"

The fields in the data structure have the following meanings:

ls_name (locale session name)
	Contains the name of the session within the local application (local half-session name).
lpap	Specifies to which partner application the session is assigned. lpap contains the name of the LPAP partner via which the partner application is connected.
rses	(remote session name) Contains the name that the session has in the partner application (remote halfsession name).
con, pronam, bcamappl
	These parameters uniquely identify the transport connection that has been or will be established for this session. con Contains the name of the transport connection to the partner application defined at dynamic creation (KC_CREATE_OBJECT object type KC_CON) or during the KDCDEF generation in the CON statement. pronam The name of the computer on which the partner application is running. bcamappl Contains the name of the local UTM application (BCAMAPPL name) via which the connection to the partner application will be established.
pronam
	If the real computer name is longer than 8 characters: The pronam field contains a symbolic local name assigned for this computer by the transport system. If no connection was established yet, pronam contains blanks.
connect_mode
	Specifies if a transport connection is established for the session.
	'Y'	A transport connection to the partner application is established for the session.
	'N'	No transport connection is established for the session at the present time.
quiet_connect
	Specifies if the QUIET property is set for the connection. QUIET means that UTM closes the connection as soon as the session contains no more jobs. No more new dialog jobs are accepted for the partner application.
	'Y'	The QUIET property is set.
	'N'	The QUIET property is not set.
lses_user
	Name of the job submitter currently using the session. lses_user specifies who started the job-submitting service.  If the job-submitting service is running in the local application for a dialog job, then the user ID or LTERM partner of the client that started the service is specified in lses_user. If the job-receiving service is running in the local application for a dialog job, i.e. the local application is processing the job, then the local session name (ls_name) is output in lses_user. If asynchronous messages are transmitted in the session, then the local session name (ls_name) is output in lses_user in this case, too.
ls_deleted
	Indicates  whether the LSES object was deleted from the configuration dynamically.
	'Y'	The session is deleted.
	'N'	The session is not deleted.
ls_used
	Indicates whether or not the session is being used.
	'Y'	The session is being used.
	'N'	The session is not being used.
ptc	Indicates the state of the session.
	'Y'	The session is in the PTC state (prepare to commit).
	'N'	The session is not in the PTC state.
node_name
	Only in UTM cluster applications: Reference name of the node application to which the session is assigned.
pronam_long
	The name of the computer on which the partner application is running. The names in the con, pronam_long and bcamappl fields uniquely identify the transport connection that is or is to be established for this session.