This operation relates to a client or printer for the application.
You must identify the client/printer unambiguously in the identification area. To do this, in the data structure kc_long_triple_str of the union kc_id_area, pass the name of the client printer, the name of the computer on which it is located, and the name of the UTM application via which the connection is to be established.
In the data area you must pass the data structure kc_pterm_str with the new values of the properties.
Possible modifications
Change the client/printer assignment to the LTERM partner.
In this way you can modify the logical properties of the client/printer. In particular, you can use them to assign a printer to a printer pool or to a printer control LTERM.
When the assignment is modified, neither the client/printer nor the LTERM partner to which the client/printer is assigned may be connected to the application.Restriction:
Reassignment of the LTERM partner is possible only for terminals and printers. For UPIC clients, TS applications (APPLI/SOCKET) generated as dialog partners, and clients that connect to the application using an LTERM pool, it is not possible to change the assignment to an LTERM partner defined at configuration.
When you assign a new LTERM partner to a terminal or printer, the LTERM partner must not be currently assigned or have been previously assigned to a client/printer of another protocol type. Distinctions are drawn here between the following four protocol types: terminals, TS applications, printers and RSO printers. It is not possible, for example,
to assign an LTERM partner that is or was assigned to a UPIC client or to a TS application to a terminal,
to assign an LTERM partner on a BS2000 system that is or was assigned to a normal printer to an RSO printer (and vice-versa).
Field name
Meaning
lterm[8]
Specify in lterm the name of the LTERM partner that is to be assigned to this client/printer.
This function is only permitted in standalone UTM applications.
The LTERM partner must exist in the application configuration.
It must not be an LTERM partner of an LTERM pool, a master or slave LTERM of an LTERM bundle or a group or primary LTERM of an LTERM group.
The maximum length of the name is 8 characters.For clients, the old assignment of this LTERM partner is implicitly cancelled.
Only printers that have been configured for output (usage_type='O') can be assigned to LTERM partners. For printers, the old assignment of LTERM partner specified in lterm is not cancelled if a printer was previously assigned to it. Both printers are combined into a printer pool. Any required number of printers may belong to a printer pool.
If the LTERM partner is assigned to a printer control LTERM, the printer must have a printer ID which is unique in the printer control LTERM area, otherwise the call is rejected.
connect_mode and lterm cannot be specified together in a single call.Period of validity / transaction management: type PD ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
Activate or deactivate automatic connection setup to the client/printer.
With automatic connection setup, UTM attempts to establish the connection to the client/printer automatically.
Exception:
Automatic connection setup cannot be achieved to clients which are connected to the application via an LTERM pool nor to UPIC clients. In both these cases, connection setup is always initiated by the client and not by the UTM application.
Specify the following in the data structure kc_pterm_str:
Field name
Meaning
auto_connect='Y'
As of the next application start, UTM is to establish the connection to the client/printer automatically, provided that the client/printer is available.
The client/printer must not be disabled (state='N').auto_connect='N'
As of the next application start, UTM is no longer to establish the connection to the client/printer automatically.
Period of validity / transaction management: type GPD ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
Disable a client or printer or cancel an existing lock.
You can disable only those clients and printers that have been entered explicitly and statically in the configuration, using a PTERM statement, or dynamically as an object of the type KC_PTERM. Clients which connect via an LTERM pool or a multiplex connection cannot be disabled.
Specify the following in kc_pterm_str in order to disable or release a client/printer:
Field name
Meaning
state='N'
Disable the client/printer.
A lock on a client does not take effect until the client next attempts to establish a connection to the UTM application. The connection request is then rejected by UTM. Any connection that exists at the time of disable operation is maintained.state='Y'
The client/printer lock is to be cancelled.
Period of validity / transaction management: type GPD ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
Set up or shut down t the connection to the client/printer.
Field name
Meaning
connect_mode='Y'
The connection to the client/printer is to be established.
Exception:
connect_mode='Y' cannot be specified for clients which are connected to the application via an LTERM pool, nor for UPIC clients.
The client/printer must not be disabled. A disabled client/printer must be released prior to setting up the connection (state='Y'). Releasing the client/printer and setting up the connection cannot be performed in a single call.connect_mode='N'
The connection to the client/printer is to be shut down immediately.
A connection shutdown initiated with connect_mode = 'N' takes immediate effect. If the connection is occupied by a job at that time, processing of the job is aborted.connect_mode='R'
Only on BS2000 systems:
May only be specified for clients which are connected to a UTM application on a BS2000 system through a multiplex connection.
connect_mode='R' (Release pending connections) instructs UTM to release a session in the DISCONNECT PENDING state once the timer has expired. The session cannot be released if the timer has not yet expired.
See openUTM manual “Generating Applications” in relation to the DISCONNECT PENDING state.connect_mode and lterm cannot be specified to together in a single call.
Period of validity / transaction management: type A ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
Change the maximum period for which UTM will wait for an entry from the client after the end of a transaction or after the sign-on. When the time is exceeded, the connection to the client is cleared down (only relevant in the case of dialog partners).
Specify the following in the kc_pterm_str data structure:
Field name
Meaning
idletime[5]
In idletime you specify the maximum period in seconds for which openUTM waits outside a transaction (i.e. after the end of a transaction or after signon) for an entry from the client.
When idletime=0 is specified, openUTM waits for an unlimited period.Maximum value: '32767'
Minimum value: '60'
In the case of values that are smaller than 60 but not equal to 0 then the value 60 is used.Period of validity / transaction management: type GPD ("KC_MODIFY_OBJECT - Modify object properties and application parameters")
The modification of the timer takes effect at the next end of transaction but not before the end of the program unit run (PEND) in which the call is processed.
KDCPTERM ("KDCPTERM - Change properties of clients and printers") with the exception of idletime