In addition to the graphical user interfaces provided by Host Integration Server Setup and the SNA Manager, Host Integration Server offers a command-line interface. The command-line interface can be useful in certain situations, such as when you want to view a configuration setting quickly without starting the graphical interface, or when you want to store configuration commands in a command file so that they can be carried out easily in the future.
Before using the command-line interface, you must install Host Integration Server and run the SNA Manager at least once. This initializes important elements of the Host Integration Server configuration that cannot be controlled with the command-line interface.
You can use the command-line interface to modify an offline configuration file (as well as a regular on-site configuration file). However, when you work with an offline configuration file, validation of server names, link names, and user names cannot take place, and errors may result. For information about specifying the name of the configuration file to modify with the command-line interface, see Specify the Subdomain Configuration File.
Other actions are also not available from the command-line. For example, you cannot use the command-line interface to configure ranges of LUs.
Certain Host Integration Server commands must be used with great care if the /add option is used with them. With these commands snacfg server , snacfg link , and snacfg user the information you type must match existing information in your system or on the Windows domain.
|If you specify server names, link service names, adapter properties, or user names by using the /add option with snacfg server, snacfg link, or snacfg user, these names or properties must match existing names and properties in your installation, or a nonfunctioning configuration may result. To protect against errors with these commands, use the SNA Manager instead.|