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

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