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