Show TOC

Specifying Host Name and Password: Option -HLocate this document in the navigation structure

With this option you can specify the host name and password. The option can be specified when the SAProuter is started, or sent to a running SAProuter.

At Startup:

Start SAProuter with the following option to specify a host name:

  • Windows/UNIX:saprouter ( '-r' '-H' '<host name>' )

  • IBM i:call saprouter ( '-R' '<path>' )

    Note
    • This causes SAProuter to "listen" to the IP address of host <hostname>. If nothing different is defined with option -S, SAProuter uses default port 3299. If SAProuter is started without option -H, it listens to all IP addresses owned by this host. <hostname> can also be an IP address.
    • If you started SAProuter with option -H <host name>, of course you also have to define the host name for administration. For example, if you want to use a new route permission table, you must enter saprouter -n -H <host name> (IBM i: call saprouter '-n -H <host name>').
When SAProuter is Running:

You can use this option in a running SAProuter to get SAProuter information from a remote host. A password may be required, which is then entered with option -P <password>(IBM i: Option '-P' '<password>') SAProuter then checks its route permission table to determine whether the route is allowed with this password, and if it is, it displays the information.

Example

Host myhost has two IP addresses: a1 and a2.

Call saprouter -r (IBM i: call saprouter ( '-r' )) causes SAProuter to listen to a1/3299 and a2/3299. The call to saprouter -r -H a2 (IBM i: call saprouter '-r -H a2') causes SAProuter to listen only to a2/3299.

Example

SAProuter is running on host_sr, port 3299 (default). You would like to display the SAProuter information (list of all SAProuter clients, for example) from the host myhost.

Enter the command niping saprouter -l -H host_sr -P pass (IBM i: call saprouter ( '-l' '-H' 'host_sr -P pass' )).

SAProuter checks whether its route permission table contains the entry

P myhost host_sr 3299 pass

Do_Destroy. If it does, the SAProuter information is displayed on your host myhost.

Integration

If the SAProuter is running on a port other than the default port 3299, you can specify this in the command line with option -S <service>.

Related Information