Start of Content Area

Function documentation Option -H <hostname> [-P <password>]  Locate the document in its SAP Library structure

Use

This option has two uses:

  1. You can define the option when you start SAProuter:
    2.

    saprouter -r -H <hostname> (iSeries: saprouter '-r -H <hostname> ' ).

    This means that SAProuter only responds to the IP address of host <hostname> ; if option -S does not define any other value, this is default port 3299. If SAProuter is started without option -H , it responds to all IP addresses of this host. <hostname> can also be an IP address.

    Example

    The host myhost has two IP addresses: a1 and a2.

    The call saprouter -r (iSeries: saprouter '-r' ) causes SAProuter to respond to a1/3299 and a2/3299. The call saprouter -r -H a2 (iSeries: saprouter '-r -H a2' ) causes SAProuter to respond only to a2/3299.

    Caution

    If you started SAProuter with option H <hostname>, 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 <hostname> (iSeries: saprouter '-n -H <hostname>' ).

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

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 saprouter -l -H host_sr -P pass (iSeries: saprouter '-l -H host_sr -P pass ' ).

SAProuter checks whether its route permission table contains the entry

P myhost host_sr 3299 pass

or not, 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>.