hszterm(8) hszterm(8)
NAME
hszterm - control program for SY12/PXRC disk array controller
SYNOPSIS
hszterm [options] [commands]
DESCRIPTION
The hszterm command either starts a virtual terminal session with the
SY12/PXRC or sends commands to the SY12/PXRC with the output of those
commands going to stdout. All hszterm communication with the SY12/PXRC
is done over the SCSI bus.
To run hszterm a device representing one of the units on the SY12/PXRC
must be specified. This can be by using the -f option and providing
the the path to the device.
If no additional arguments are provided, hszterm starts a virtual ter-
minal session to the SY12/PXRC. The session and the program can be
ended by entering the EOF character.
If additional arguments are provided, hszterm will uses the remaining
arguments on the command line as commands to be passed to the HSZ. If
the command to be passed consists of multiple words, it must be sur-
rounded by quotes.
OPTIONS
-f special
Character special device name of an SY12/PXRC logical units. If
no logical units are defined, the bus and target number can be
specified instead.
-o logfile
Specifies the name of an optional log file. Messages sent to and
received from the SY12/PXRC are appended to this file.
-h Print a brief help message.
-v Set level of verbosity. hszterm can be made to perform its
actions with a great deal of, generally extraneous, output. This
option allows setting the level of verbosity of this extra out-
put.
-l Display all configuration-specific data relating to PXRC RAID
controllers or magnetic disks. This information should be saved
when the configuration is activated for the first time or
changed. The data should not be stored on the RAID system, as it
is needed to restore the current configuration, and thereby the
data, if both controllers are lost.
Page 1 Reliant UNIX 5.44 Printed 11/98
hszterm(8) hszterm(8)
RESTRICTIONS
The hszterm command restricts access to the SY12/PXRC programs that
can be used with the run command. The set of allowed commands can be
set using the environment variable HSZTERMRUN. This is a comma sepa-
rated list of the utilities the user would like to be able to run. If
no list is specified the default list will consist of CONFIG, FLS,
FMU, CLCP and CLONE. It will never allow running the utilities CFMENU,
VTDPY, DILX or TILX, even when they are included in the list specified
by HSZTERMRUN.
DIAGNOSTICS
Most error messages are preceded by the string HSZterm. The errors
message fall in three general categories; SCSI communication errors,
virtual terminal errors and other errors.
Getopt got confused
The library function getopt(3C) is used to parse the command
line. This message is printed when an unrecognized option is
used.
Can't open %s: %s.
If hszterm is unable to open the /dev/cam or the special device
file of the SY12/PXRC, this message is printed. The system mes-
sage corresponding to the error is provided.
Can't open %s for logging: %s.
If hszterm cannot open the log file, this message is printed.
Can't close %s: %s.
hszterm tries to close all the files it opens before it exits. If
one of the files cannot be closed, this message is printed with
the name of the file and system error message being given.
No device selected. Select a device and try again.
This message is printed when no device has been selected.
The following messages indicate errors in the virtual terminal proto-
col used to communicate with the SY12/PXRC.
Device does not support Virtual Terminal protocol.
Failed to send response to remote program.
Failed to receive message.
EXAMPLES
This example passes the command "show devices full" to the SY12/PXRC
that is expected to correspond to the special device
/dev/ios0/rsraid040.
# hszterm -f /dev/ios0/rsraid040 "show devices full"
Page 2 Reliant UNIX 5.44 Printed 11/98
hszterm(8) hszterm(8)
This example limits the run list to CONFIG, CLONE and FLS.
# setenv HSZTERMRUN CONFIG,CLONE,FLS
There can only be one hszterm session to an SY12/PXRC controller at a
any time.
Page 3 Reliant UNIX 5.44 Printed 11/98