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 iSeries Support for Windows Network Neighborhood 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 iSeries 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 iSeries Support for Windows Network Neighborhood (iSeries 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 iSeries Support for Windows Network Neighborhood (iSeries NetServer) request.


API introduced: V4R2
Top | Server Support APIs | APIs by category