Last time, I presented the three Server Support APIs capable of Starting and Ending the IBM i NetServer as well as retrieving information about the IBM i NetServer (“Server Support APIs Providing NetServer Management Facilities,” August 25, 2011, article ID 66153 at SystemiNetwork.com). Today’s installment of APIs by Example focuses on the Server Support APIs available to change the NetServer configuration information on your IBM i. Whereas a single API is responsible for retrieving the NetServer configuration details, no less than three APIs are required to change the three different categories of NetServer information, into which this information was divided when the associated change APIs were designed.
The three APIs in question are the Change Server Guest (QZLSCHSG) API, which lets you change the user profile used by the IBM i NetServer when an unknown user requests access to shared resources on the system; the Change Server Name (QZLSCHSN) API, which can alter server name information by which the IBM i NetServer is known on the network; and the Change Server Information (QZLSCHSI) API, which provides access to updating the general configuration information for the IBM i NetServer. I’ve packaged all three APIs into the Change NetServer Attributes (CHGNETATR) CL command, offering the context of employing the mentioned APIs in this APIs by Example.
In addition to the CHGNETATR command, for completeness, I also wrote a Change TCP Server Autostart (CHGTCPSVRA) command, which provides an interface to update the autostart setting of any of the TCP servers available on the IBM i, including the IBM i NetServer, of course. I’ve added the function key F10 to the Display NetServer Attributes (DSPNETATR) command’s display panel to provide a shortcut to the CHGTCPSVRA command. The DSPNETATR command was presented in the previous installment of this column, and I’ve included a link to that article below.