HP-UX SNAplus2 R7 Administration Guide

Managing SNAplus2 from NetView
Using UCF
to commands related to SNAplus2; subject to the restrictions in Section 10.3.2, Permitted Commands, any type of
command can be issued.
By using UCF, a remote operator can monitor activity on the SNAplus2 computer, diagnose problems, and in some
cases take corrective action.
You can specify whether SNAplus2 supports UCF by using the
define_rcf_access command (refer to HP-
UX SNAplus2 Administration Command Reference). If the configuration specifies that UCF is supported, SNAplus2
starts the UCF daemon program when the node is started. The UCF daemon processes HP-UX commands from the
UCF by starting a new HP-UX shell for each command and running the command in that shell. If UCF support is
not included, SNAplus2 does not start this program.
The configuration specifies the name of the UCF user, which must be a valid login name on the SNAplus2 computer.
The UCF shell is started using the shell program, login ID, permissions, and .login or .profile specified for
that user. (If no shell program is specified, /bin/sh is used.) This means that the normal HP-UX system security
features can be used to restrict the UCF user’s access to files and commands, and therefore to limit the range of
commands available from UCF.
For more information about setting up the UCF configuration, refer to the description of the define_rcf_access
command in HP-UX SNAplus2 Administration Command Reference.
10.3.1 UCF Command Syntax
The syntax of a UCF command is as follows:
runcmd sp=spname, appl=unix, unix_command
NetView uses the runcmd utility to send a command to a remote system. The command includes the following
parameters:
sp=spname
Specify spname, which is the name of your service point as defined at NetView. The host NetView person-
nel can give you this information.
appl=unix
Instruct NetView to send the command to the UCF daemon program on the SNAplus2 computer associated
with the service point name spname.
unix_command
Supply the HP-UX operating system command. This command is entered as you would enter it on the HP-UX
command line, except for the escape characters to indicate uppercase letters or square bracket characters (as
described in Section 10.1.3, Overview of RCF Command Syntax).
The escape characters you would normally use on the HP-UX command line, to prevent the HP-UX shell
from interpreting special characters, are not required with UCF. For example, do not use escape characters
with strings containing the characters * or $, as you would when entering them on the HP-UX command line.
10.3.2 Permitted Commands
The UCF is designed for use with commands that complete (whether or not any output is produced) without any
further interaction from the user. For example, you can issue the command cat filename, which completes after
displaying the contents of filename,ormv filename1 filename2, which completes with no output unless an
error occurs.
Output generated by a UCF command is returned to UCF when the HP-UX operating system command completes.
This leads to the following restrictions:
• Any output generated after the command completes is not returned to UCF. For example, if you issue a command
followed by & to run it in the background, UCF receives the operating system message giving the process ID
140