| 1 | Server name | Input | Char(15) |
| 2 | Domain name | Input | Char(15) |
| 3 | Text description | Input | Char(50) |
| 4 | Error code | I/O | Char(*) |
| 5 | Allow system name | Input | Char(1) |
The Change Server Name (QZLSCHSN) API changes the name by which the IBM® i Support for Windows® Network Neighborhood (IBM i NetServer™) server is known on the network. The changes made with this API do not take effect until the server is restarted.
To use this API, you must have *IOSYSCFG special authority.
The name by which the system is known in the Windows Network Neighborhood.
The domain name (or workgroup) in which the server appears.
The description of the system that appears on the network.
The structure in which to return error information. For the format of the structure, see Error code parameter.
Whether the server allows clients to connect using the system name found in the System i™ network attributes. Possible values are:
| 0 | Do not allow access to the server using the TCP/IP system name. |
| 1 | Allow access to the server using the TCP/IP system name. |
If the allow system name parameter is omitted, the API assumes that no change is requested and the current value remains unchanged.
| Message ID | Error Message Text |
|---|---|
| CPF3C1E E | Required parameter &1 omitted. |
| CPF3C3A E | Value for parameter &2 for API &1 not valid. |
| 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). |
| CPFB68B E | Character is not valid for value &3. |
| CPIB685 E | Error occurred on IBM i Support for Windows Network Neighborhood (IBM i NetServer) request. |