End Server Session (QZLSENSS) API


  Required Parameter Group:

1 Workstation name Input Char(15)
2 Error code I/O Char(*)

  Optional Parameter:

3 Expanded workstation name Input Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The End Server Session (QZLSENSS) API ends a single session or all the sessions that were established from the specified workstation.


Authorities and Locks

To use this API, you must have *IOSYSCFG special authority.


Required Parameter Group

Workstation name
INPUT; CHAR(15)

The name of the workstation from which the session to the server was established. Special values of *SESSID and *EXPANDED can be specified for this field. When a special value is specified the associated input format must be specified on the expanded workstation name parameter.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Optional Parameter

Expanded workstation name
INPUT; CHAR(*)

When *SESSID is specified for the workstation name parameter, this parameter must be a BINARY(8). This allows the caller to end a single session. Allowable values are:

0 All sessions for the specified workstation name are ended. This is the default value when *SESSID is specified for the workstation name.
Session identifier The identified session is ended.

When *EXPANDED is specified for the workstation name parameter, this parameter must be a CHAR(50). The field can contain a workstation name, an IPv4 address, or an IPv6 address.


Error Messages

Message ID Error Message Text
CPF3C1E E Required parameter &1 omitted.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.
CPFB682 E API &1 failed with reason code &2.
CPFB683 E Data conversion failed for API &1.
CPFB684 E User does not have the correct authority for API &1.
CPFB68E E Error ending IBM i Support for Windows Network Neighborhood (IBM i NetServer) session.


API introduced: V4R2

[ Back to top | Server Support APIs | APIs by category ]