KDCLSES - Establish/shut down connections for LU6.1 sessions

With KDCLSES you can arrange for a transport connection to a session to be established or shut down.

Effect in UTM cluster application

In UTM cluster applications, KDCLSES applies locally in the node.

---

KDCLSES     LSES=lsesname 
            ,ACTION={ CON| DIS | QUIET }

                        BS2000 systems:
           [ ,CON=remote_applname,PRONAM=proname,BCAMAPPL=applname ]

                        Unix, Linux and Windows systems:
           [ ,CON=remote_applname [,PRONAM=proname ],BCAMAPPL=applname ]

---

For administration using message queuing you must enter KDCLSESA.

LSES=lsesname
		Indicates the name of the session requiring administration (local halfsession name). For lsesname, enter a name which was assigned by means of KC_CREATE_OBJECT for the object type KC_LSES during KDCDEF generation of an LSES statement.
ACTION=		Controls the establishment and termination of a session.
	CON	A transport connection is to be established for the session lsesname. With the operands CON, PRONAM and BCAMAPPL you can specify precisely which transport connection is to be established for the session. If you do not enter a transport connection for CON, PRONAM and BCAMAPPL, UTM tries to establish one of the transport connections generated for the relevant LPAP partner (KC_CREATE_OBJECT for the object type KC_CON or KDCDEF control statement CON).  If openUTM is not able to establish the connection specified in CON, PRONAM and BCAMAPPL, it tries to establish another of the connections generated for the relevant LPAP partner.
	DIS	The connection currently established for the session is shut down immediately.
	QUIET	Connection to the partner application is shut down if the session is no longer assigned by a job.
CON=remote_applname, PRONAM=proname, BCAMAPPL=applname
		Entry of this operand is only meaningful for ACTION=CON. With these operands you can specify the precise transport connection to be established. Your entries must uniquely identify the transport connection. To do so, you must if necessary enter all three operands and make the following entries: remote_applname  Name of the connection generated for the partner application (remote halfsession name assigned dynamically to the partner application by means of KC_CREATE_OBJECT for the object type KC_CON or with the KDCDEF statement CON). proname  Name of the computer on which the partner application is running.  This parameter is mandatory on BS2000 systems. applname  Name of the local application (BCAMAPPL name) via which the connection is established. For applname, enter the name that was defined for this application dynamically or in the CON statement during KDCDEF generation.

Output from KDCLSES

The new and old properties (NEW, OLD) of the specified session are output to the administrator terminal.

The output depends on whether a short or a long host name is assigned to a LSES object. In the case of a long host name, the information on a LSES object is output in two screen lines.

LSES     PRONAM   CON             BCAMAPPL  CONNECTION
                                            NEW         OLD
lsesname proname  remote_applname applname  CON|DIS A|Q CON|DIS A|Q
lsesname long.processor.name
                  remote_applname applname  CON|DIS A|Q CON|DIS A|Q

Explanation of the output

CONNECTION

1st column:
The connection has been established (CON) or shut down (DIS).

2nd column:
A (automatic) indicates that openUTM will try to establish a connection automatically when the application starts.
Q (quiet) indicates that the connection will be shut down and that no further dialog jobs will be accepted for this session.