Change Server Guest (QZLSCHSG) API
Required Parameter Group:
| 1 | Guest user profile | Input | Char(10) |
| 2 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Change Server Guest (QZLSCHSG) API changes the user profile used by the IBM® i Support for Windows® Network Neighborhood (IBM i NetServer™) server when an unknown user requests access to shared resources on the system. The changes made with this API do not take effect until the server is restarted.
A user profile with any special authority cannot be specified as the guest profile.
Authorities and Locks
To use this API, you must have both *IOSYSCFG and *SECADM special authorities.
- Guest user profile
- *USE
Required Parameter Group
- Guest user profile
- INPUT; CHAR(10)
The user profile for the IBM i Support for Windows Network Neighborhood server access by unknown users. If this field is blank, unknown users will not have access to resources on the system.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPFA0D4 E | File system error occurred. |
| 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. |
| CPFB686 E | Error configuring IBM i Support for Windows Network Neighborhood (IBM i NetServer). |
| CPFB687 E | Cannot find the guest user profile &3. |
| CPFB68C E | Requested guest user profile &2 has incorrect authority. |
| CPIB685 E | Error occurred on IBM i Support for Windows Network Neighborhood (IBM i NetServer) request. |
API introduced: V4R2