Change Server Name (QZLSCHSN) API
Required Parameter Group:
| 1 | Server name | Input | Char(15) |
| 2 | Domain name | Input | Char(15) |
| 3 | Text description | Input | Char(50) |
| 4 | Error code | I/O | Char(*) |
Optional Parameter:
| 5 | Allow system name | Input | Char(1) |
Default Public Authority: *USE
Threadsafe: No
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.
Authorities and Locks
To use this API, you must have *IOSYSCFG special authority.
Required Parameter Group
- Server name
- INPUT; CHAR(15)
The name by which the system is known in the Windows Network Neighborhood.
- Domain name
- INPUT; CHAR(15)
The domain name (or workgroup) in which the server appears.
- Text description
- INPUT; CHAR(50)
The description of the system that appears on the network.
- 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
- Allow system name
- INPUT; CHAR(1)
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.
Error Messages
| 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. |
API introduced: V4R2