ILB(1) Network Queuing Env. 3.3 Last changed: 4-13-98 NNAAMMEE iillbb - Executes a load-balanced interactive command SSYYNNOOPPSSIISS iillbb [--??] [--dd] [--ll _u_s_e_r_n_a_m_e] _c_o_m_m_a_n_d [_a_r_g_s] IIMMPPLLEEMMEENNTTAATTIIOONN IRIX systems UNICOS/mk systems UNICOS systems AIX systems Digital UNIX systems HP-UX systems Solaris systems DDEESSCCRRIIPPTTIIOONN The iillbb utility executes a command on a machine chosen by the Network Load Balancer (NLB). Enter the iillbb command, followed by the command you wish to execute. The NLB is then queried to determine the machine on which to log you in, using the HHOOSSTTSS policy which is based on system loads. Once the login process is complete, the command is executed, and I/O is connected to your terminal or pipeline. The iillbb utility accepts the following options: --?? Displays help message describing available options. This help information may describe options not described on this manual page if your site has modified the iillbb utility. --dd Enables debugging, which causes messages to be displayed during the login and execution process. These messages may assist support personnel and the user in resolving problems. Debugging is off by default. --ll _u_s_e_r_n_a_m_e Uses _u_s_e_r_n_a_m_e instead of your current user ID to log into the target system. _c_o_m_m_a_n_d [_a_r_g_s] Executes the specified command, together with its arguments, on the target host. The command may be quoted to prevent local command-line expansion. The iillbb utility uses the following environment variables: HHOOMMEE Indicates the location of the user's $$HHOOMMEE//..iillbbrrcc file. IILLBB__PPRROOMMPPTT Set to a regular expression, identifies the user's prompt on the remote system. The default is ""^^..**[[%%$$##::]] $$"". IILLBB__UUSSEERR Used as an alternate method of specifying the remote _u_s_e_r_n_a_m_e; see the --ll option for more information. This variable also alters the value of $$UUSSEERR. The default value is the value of $$LLOOGGNNAAMMEE or $$UUSSEERR that is set in the user's environment. LLOOGGNNAAMMEE Indicates the default _u_s_e_r_n_a_m_e when logging into a remote server. (Also see the UUSSEERR environment variable; some supported platforms use the UUSSEERR environment variable instead of the LLOOGGNNAAMMEE environment variable.) NNLLBB__SSEERRVVEERR Indicates the system used to query for target selection. This variable is normally retrieved from the //eettcc//nnqqeeiinnffoo file. UUSSEERR Indicates the default _u_s_e_r_n_a_m_e when logging into a remote server. (Also see the LLOOGGNNAAMMEE environment variable; some supported platforms use the LLOOGGNNAAMMEE environment variable instead of the UUSSEERR environment variable.) RREETTUURRNN VVAALLUUEESS Upon successful completion, an exit code of 00 is returned; otherwise, an exit code of 11 is returned. BBUUGGSS The type of terminal emulation used may affect the proper appearance of certain applications. EEXXAAMMPPLLEESS Examples of using the iillbb command follow. Example 1: The following command executes the uunnaammee command on the system chosen by the NLB and returns the output to the user's terminal: $ iillbb uunnaammee --aa Attempting connection to pendulum... ILB Info: Using /usr/bsd/rlogin to connect, based on PATH. Executing uname -a... IRIX pendulum 6.2 06101030 IP22 $ Example 2: The command iillbb vvii ..pprrooffiillee starts an interactive editing session using the user's ..pprrooffiillee on the target system chosen by the NLB. FFIILLEESS The ..iillbbrrcc file contains login and initialization information used during the automated login process. It resides in your home directory on the local host. The default system iillbbrrcc file resides in the NQE //eettcc directory. It contains information that the iillbb utility uses to establish connections to remote systems. There are two main groups of information contained in the iillbbrrcc file, LLOOGGIINN blocks and SSYYSSTTEEMM blocks. LLOOGGIINN blocks are used to define login methods. These blocks start with a line containing LLOOGGIINN <<_n_a_m_e>> and end with the line EENNDD LLOOGGIINN. There are three main directives in the LLOOGGIINN block: UUSSEERR, IINNVVOOKKEE, and SSYYSS. UUSSEERR The UUSSEERR directive is followed by either << or >> to specify whether a line is to be input from or output to the user's terminal, respectively. For example, the UUSSEERR>> directive indicates that the remainder of the line is printed to the user's terminal. The UUSSEERR<< directive must be followed by a temporary variable that indicates where the input will be stored. The UUSSEERR__QQUUIIEETT<< directive is used for non-echoing input so that passwords are not visible when entered. IINNVVOOKKEE The IINNVVOOKKEE directive is used to specify the application to be started to initiate a connection to a remote system. SSYYSS The SSYYSS>> and SSYYSS<< directives are similar to the UUSSEERR directives, but they send or receive data to the remote system in order to complete the connection. The following three variables, which may be used in LLOOGGIINN blocks, are set automatically by the iillbb utility: $$SSYYSS Stores the name of the system that the NLB selected for the session. $$UUSSEERR Stores the _u_s_e_r_n_a_m_e of the account to log into. The $$UUSSEERR variable is set with the --ll option or by reading the environment variables IILLBB__UUSSEERR and LLOOGGNNAAMMEE or UUSSEERR. $$PPRROOMMPPTT Specifies a user's prompt; the prompt $$PPRROOMMPPTT contains a regular expression and may be changed by setting the environment variable IILLBB__PPRROOMMPPTT. A SSYYSSTTEEMM block is the other main type of information in the iillbbrrcc file. SSYYSSTTEEMM blocks define options specific to machine names. The SSYYSSTTEEMM blocks begin with the line SSYYSSTTEEMM _n_a_m_e; _n_a_m_e is the name of a system or is DDEEFFAAUULLTT to define the fallback case. A SSYYSSTTEEMM block is ended with EENNDD SSYYSSTTEEMM. The CCOONNNNEECCTT attribute of the SSYYSSTTEEMM block defines which of the LLOOGGIINN blocks should be applied to a particular system. SSEEEE AALLSSOO llooggiinn(1), tteellnneett(1) for information about connecting to remote systems nnqqeeiinnffoo(5) for information on the nnqqeeiinnffoo file nnllbbppoolliiccyy(8) for information about querying an NLB server about a load-balancing policy This man page is available only online.