|
|
|
|
SNAP-IX includes a remote command facility (RCF) that operates in conjunction with the NetView program at a host computer, enabling a NetView operator to issue commands from the host NetView program to the SNAP-IX computer. (For a brief overview of NetView and RCF commands, see Using the Host NetView Program.)
The SNAP-IX RCF provides the following two functions:
Service point command facility (SPCF) enables a NetView operator to issue SNAP-IX administration commands from NetView using the same syntax as for the command-line administration program snaadmin. This facility is described in Using SPCF.
UNIX command facility (UCF) enables a NetView operator to issue Solaris operating system commands from NetView. This facility is described in Using UCF.
Both of these functions can be accessed from the NetView console in the same way, and the overall syntax for issuing the commands is the same.
In addition, SNAP-IX includes a NetView Distribution Manager (NetView DM) agent that enables a NetView DM operator at the host to manage files on the Solaris computer using NetView DM commands. This application is described in Using NetView DM Agent.
The SNAP-IX RCF operates in conjunction with the NetView program at a host computer. The host must be running NetView Version 1 Release 2, or a later version; SNAP-IX does not support NetView Version 1 Release 1.
To use the NetView program, you need the following:
Login ID and password for the host NetView program (contact your host personnel for this information)
Service point name for SNAP-IX, defined at the host for the NetView program (contact your host personnel for this information)
DLC, port, and link station to access the host computer on which the NetView program is running
You may want to test the RCF function by using 3270 emulation to access NetView from SNAP-IX instead of accessing it directly from the host. In this case, you also require the following:
3270 LU configured at the host
3270 session using this LU
Consult your host administrator to obtain the necessary configuration information.
To access the NetView program, follow these steps:
Ensure that the SNAP-IX software is started, using
a node configuration file that includes a definition of RCF access parameters
(the
If you are accessing the NetView program using 3270 emulation, start the 3270 emulation program and activate the session to the host. (Refer to SNAP-IX 3270 User's Guide if necessary.)
Follow the instructions given to you by the host administrator for starting NetView and logging on. (The sequence of operations may vary with different versions of NetView.)
Issue SPCF or UCF commands as required.
If you are using 3270 emulation to access NetView, follow the instructions in your 3270 documentation (SNAP-IX 3270 User's Guide) for ending 3270 emulation when you have finished issuing commands.
The layout of the NetView screen varies with different versions of NetView at different hosts. A typical layout is shown in Example of a NetView Screen.
The display includes an input area at the bottom of the screen; this is the area into which you can type commands. The line ??? divides the main screen area (where NetView displays responses to your commands) from the input area.
By default, the input area is one line, but for some of the longer commands you need more than one line. On some versions of NetView, you can specify an input area of one, two, or three lines by using the input command. To do this, type the following command:
input n
In this command, n is 1, 2, or 3, indicating the number of lines you want. If this command does not work on the version of NetView you are using, contact your NetView support personnel.
Both SPCF and UCF commands use the RCF command syntax:
runcmd sp=spname, appl= component, commandtext
NetView uses the runcmd utility to send a command string to a remote system. The command includes the following parameters:
Indicate the service point name (defined at NetView) that corresponds to the SNAP-IX node. The host NetView personnel can give you this information.
Indicate the name of the SNAP-IX component to which NetView should send the command, as follows:
The SNAP-IX node associated with the service point name spname (for SPCF commands)
The UCF daemon program running on the SNAP-IX computer associated with the service point name spname (for UCF commands)
Supplies the text of the command being issued. For SPCF, this is a command issued to the SNAP-IX command-line administration program. For UCF, it is a command for the Solaris operating system. For more information about the commands that can be used, see Restrictions on Administration Commands Used with SPCF or Permitted Commands.
Although Solaris distinguishes between uppercase and lowercase alphabetic characters, the NetView program does not. Instead, it translates all characters into uppercase before sending them to the Solaris computer. Because RCF cannot determine whether an alphabetic character received from the host was originally uppercase or lowercase, it assumes that received characters are intended to be lowercase. Also, the host character set may not support the square bracket characters [ and ], which are required in some commands.
RCF provides support for uppercase characters and square bracket characters using the backslash character \, as follows:
To include an uppercase character in the command string, include a backslash character before it. Any alphabetic character not preceded by a backslash is interpreted as lowercase.
To include the square bracket characters [ and ], use the sequences \( and \), respectively.
To include the backslash character \ itself, type it twice.
If a single backslash is followed by any other nonalphabetic character, the backslash is ignored and the character is left unchanged.
Some examples are shown in Using Escape Characters in RCF Commands.
| Characters to Produce | Input |
| ABcd | \a\bcd |
| [ ] | \( \) |
| \a | \\a |
| \[ | \\\( |
The escape characters you would normally use on the Solaris command line,
to prevent the Solaris shell from interpreting special characters, are not
required with RCF. For example, do not use escape characters with strings
containing the characters * or $, as
you would when entering them on the Solaris command line. Also, when using
SPCF to issue administration commands, be aware that constant names such as
|
|
|
 |
|