After HP-UX, HP BASIC/UX, and HP SICL are installed, you are ready to use the system. As System Administrator, you are responsible for:
This chapter gives you an outline of the HP-UX system administration responsibilities and refers you to the System Administration Tasks manual for details. Device I/O is provided through the HP Standard Instrument Control Library (HP SICL). For more information on HP SICL, refer to Chapter 2.
Because BASIC/UX runs "on top of" HP-UX, you as System Administrator must deal with certain aspects of HP-UX. The files that BASIC/UX uses are located in various directories within the HP-UX file structure.
The following table lists some important files and directories that make up the BASIC/UX system.
File Name/Directory Name | Description |
---|---|
/opt/rmb/rmb8_0/bin | Directory containing executable rmb command and CSUB build utility. |
/opt/rmb/rmb8_0/bin/rmb8_0 | Core BASIC/UX executable file. |
/opt/rmb/rmb8_0/bin/rmbbuildc8_0 | CSUB creation utility. |
/opt/rmb/rmb8_0/lib | Directory containing librmb8_0.a and librmb8_0.sl libraries, which are useful in writing CSUBs. |
/opt/rmb/rmb8_0/bin/rmbclean8_0 | Cleans up shared memory. |
/opt/rmb/rmb8_0/bin/ipcclean8_0 | Cleans up lock files (used by rmbclean). |
/opt/rmb/rmb8_0/utils | Directory containing BASIC/UX CSUBs and their shared libraries, specific for revision 8.0. |
/opt/rmb/utils | Directory containing BASIC language utilities useful in all revisions. |
/etc/opt/rmb/rmb8_0rc | Default global environment file. |
/opt/rmb/rmb8_0/newconfig | Directory which contains default template files (used when you customize): rmbrc and d.Xdefaults. |
/opt/sicl | HP SICL directory. |
NOTE |
---|
All executables the user can invoke end in 8_0 (for example,
rmb8_0). For your convenience, we have provided symbolic links without
the 8_0 suffix in the same directory. Thus, if
/opt/rmb/rmb8_0/bin is in your $PATH, you can execute the symbolic
link name to execute the real executable. For example, if you execute:
This will automatically execute:
|
For information on utilities provided by BASIC/UX, see Chapter 5.
The System Administration Tasks manual discusses in detail the tasks you need to perform for your HP-UX system. Start by reading the "Introduction to System Administration" chapter. This chapter outlines the tasks you need to perform.
HP-UX administration can be complicated at times. You should have a good understanding of HP-UX before attempting many of the system administration tasks. Refer to A Beginner's Guide to HP-UX for beginning-level HP-UX concepts.
As System Administrator, most of your time will be spent on HP-UX system administration, rather than on BASIC/UX system administration. Other than tracking user errors (problems the users have with HP BASIC/UX), your BASIC/UX responsibilities are:
Whenever BASIC/UX terminates abnormally (for example, if power is lost or the BASIC/UX process is killed), system resources and lock files need to be cleaned up. The rmbclean utility cleans up the system and insures smooth BASIC/UX operation.
To execute rmbclean type (in HP-UX), execute:
/opt/rmb/rmb8_0/bin/rmbclean
Alternatively, you can use the -i option in the rmb command:
rmb -i
If a user who is not root runs rmbclean, only the unused lock files of that user are cleaned up. BASIC/UX runs rmbclean automatically if the system runs out of resources.
HP-UX time is the base time for all processes. BASIC/UX is an offset (or local) time relative to the HP-UX time. Thus, BASIC users can change time within BASIC/UX without affecting the time of other processes in the system. You must be logged in as root or superuser (su) to change HP-UX time.
You can be in either HP-UX or BASIC/UX to perform these tasks. If you are in BASIC/UX, use the EXECUTE command that includes the following HP-UX command (for example, EXECUTE "date 0311120094").
Command | Description | Example |
---|---|---|
date | Changes time and date. The example changes the date to March 11 at 12:00 noon, 1994. | date 0311120094 |
Each user can change the local BASIC/UX offset with these BASIC/UX commands:
Command | Description | Example |
---|---|---|
SET TIME | Changes time. The example changes the time to 12:00 noon. | SET TIME TIME( 12:00:00 ) |
SET TIMEDATE | Changes time and date. The example changes the time to March 11 at 12:00 noon. | SET TIMEDATE TIME( 12:00:00 ) = DATE( 11 Mar 1994 ) |
TIMEZONE IS | Changes timezone. The example changes the timezone to Mountain Standard. | TIMEZONE IS -7*3600 |
An HFS (Hierarchical File System) disk must be mounted on to the HP-UX file system, making it part of the file system.
Refer to the the following sources for details on how to set up an HFS file system:
NOTE |
---|
In a diskless system, make sure the appropriate procedures are performed on the computer to which the disk is physically connected, typically the diskless server. |
If you have a disk that's not listed in the HP-UX Installing Peripherals manual, you can calculate the Minor Number by following the instructions in the "Disk Drives" section in the "Setting Up Devices Using HP-UX Commands" chapter of HP-UX Installing Peripherals.
If you have trouble converting to hexadecimal, here's a table to help:
Decimal | Hexadecimal | Decimal | Hexadecimal | Decimal | Hexadecimal |
---|---|---|---|---|---|
0 | 0 | 11 | b | 22 | 16 |
1 | 1 | 12 | c | 23 | 17 |
2 | 2 | 13 | d | 24 | 18 |
3 | 3 | 14 | e | 25 | 19 |
4 | 4 | 15 | f | 26 | 1a |
5 | 5 | 16 | 10 | 27 | 1b |
6 | 6 | 17 | 11 | 28 | 1c |
7 | 7 | 18 | 12 | 29 | 1d |
8 | 8 | 19 | 13 | 30 | 1e |
9 | 9 | 20 | 14 | 31 | 1f |
10 | a | 21 | 15 | 32 | 20 |
LIF (Logical Interchange Format) disks can accessed by BASIC/UX only through a device special file. The device file may be located anywhere (it is typically located in /dev/rdsk), but you must establish an msvs-to-device-file mapping using a DISK statement in one of the BASIC/UX config files. (Refer to the section earlier in this manual titled, "Mapping BASIC Mass Storage Volume Specifiers to SCSI Device Files" for more information. The device special file must be a character device with a major number corresponding to the device driver and a minor number corresponding to the device's address.
You must determine the device special file name. For example:
/dev/rfloppy/c0t0d0
Before you can configure your LIF disk, you should collect the vital information about it. Record the vital information on the worksheet which is provided as a foldout at the end of the HP-UX Installing Peripherals manual.
mknod device_file c Major_Number Minor_Number
An internal SCSI floppy might use:
mknod /dev/rfloppy/c0t0d0 c 106 0x000000
To access the Series 700 SCSI device, first add the following DISK mapping statement to your local configuration file, ($HOME/.rmbrc):
DISK 702 = /dev/rfloppy/c0t0d0
Then, start BASIC/UX and change directories to that msvs. For example:
MSI ":,702"
For information on the msvs, refer to Using HP BASIC/UX.
If you have a disk that's not listed in the HP-UX Installing Peripherals manual, you can calculate the Minor Number by following the instructions in the section "Disk Drives" in the chapter "Setting Up Devices Using HP-UX Commands" of HP-UX Installing Peripherals.
If you are MSI'd to a LIF device, and wish to return to your HFS directory, execute:
MSI ":HFS"
You can set up printers and plotters only as spooled devices. Spooled devices eliminate the problem of more than one person or process accessing the printer at the same time.
For information on setting up spooled printers and plotters, refer to the following sources:
To access a printer, execute the command in BASIC/UX:
PRINTER IS "|lp"
(The | is an HP-UX feature called a "pipe." It allows BASIC/UX to send output to an HP-UX command, which in this case, sends output to the spooled printer.) Output may not be printed until you close the pipe by reassigning the PRINTER IS device with, for example:
PRINTER IS CRT
To access plotters, execute the PLOTTER IS command through an HP-UX command lp (running the output from a BASIC/UX command into an HP-UX command is called a "pipe"):
PLOTTER IS "|lp -dplotter1","HPGL", xmin, xmax, ymin, ymax
where xmin, xmax, ymin,ymax are the limit parameters for PLOTTER IS. (Use limit parameters because BASIC/UX treats any HPGL output directed through a pipe as a file. Plotter hard clip limits are not found when sent to the plotter.) The -dplotter1 is a parameter to the HP-UX lp command. It gives instructions to send the output to the destination "plotter1."
You must close the pipe to have the output plotted. For example, execute:
PLOTTER IS CRT,"INTERNAL"
Plotter hard clip limits can be found in plotter manuals for all HP plotters.
For more on the HP-UX lp command, see the HP-UX Reference manual.
You access instruments and other devices through the HP Standard Instrument Control Library (SICL). HP SICL takes care of creating and allocating device files needed to access the interfaces. To configure HP SICL on your computer, follow the instructions in Chapter 2.
The HP SICL configuration file will assign a Logical Unit (LU) number to the desired interface. This LU number corresponds to the select code number used to access the interface within BASIC/UX. For example, to use a device at:
you would type the following statement:
ASSIGN @pathname to 723
where pathname is an I/O pathname.
For details on I/O pathnames, see ASSIGN in the HP BASIC Language Reference.
To back up your system, you must follow the instructions in the chapter "Backing Up and Restoring Your Data" in the System Administration Tasks manual.
To back up individual files or groups of files:
Several template files are available for customizing your system.
Change directory to: /opt/rmb/rmb8_0/newconfig.
Listing this directory shows some files you can use for customizing your system (note those which can and cannot be edited in the BASIC EDIT mode):
rmbrc | Template for the global /etc/opt/rmb/rmbrc8_0 file. You can copy this file to /etc/opt/rmb and customize it in the EDIT mode. See "Customizing Your BASIC/UX Session" for more details. |
d.mwmrc | An example start-up default file for the X window manager mwm. You can copy this file into a $HOME directory as .mwmrc and customize it with an HP-UX editor. |
d.Xdefaults | An example default file for controlling the X Window System. You can copy this file into a $HOME directory as .Xdefaults and customize it with an HP-UX editor. |
xrmbcolormap | A file used to pre-allocate color map entries for using BASIC/UX in X. It is used by xinitcolormap to select appropriate default colors for BASIC/UX. |
xrmbgraymap | A file used to pre-allocate gray scale map entries for using BASIC/UX in X. It is used by xinitcolormap to select appropriate default shades of gray for BASIC/UX. |
rgb.rmb | An example file to add custom BASIC/UX colors to the default X Window System color database. |
gray.rmb | An example file to add custom BASIC/UX shades of gray to the default X Window System gray scale database. |
sys.vuewmrc | A example vuewmrc file that shows how to install a BASIC/UX icon in the front panel for drag and drop. |
See Using the X Window System for more on X configuration files. For more information about customizing X Windows, see the "Customizing Your Window Environment for HP BASIC/UX" section in the "Installing BASIC/UX on HP-UX" chapter.
This section explains how to change the BASIC/UX fonts.
You will find the fonts that are available in the VUE and X Windows environments in the directory:
/usr/lib/X11/fonts
The fonts that are supported by BASIC/UX are:
hp8.6x8 | US Roman 8 point font |
hp8.8x16 | US Roman 16 point font |
hp8.10x20 | US Roman 20 point font |
These fonts are located in the /usr/lib/X11/fonts/misc directory. To use these alternate fonts, use the -fn command line option, for example,
rmb -fn hp8.8x16 &
You may wish to change the fonts that BASIC/UX uses by default. Change the default fonts to match the environment in which you are running:
xrdb -query > my_resources
where my_resources is an example database filename.
xrdb -load my_resources
rmb*font: kana.10x20
The HP 700/RX terminal gains access and uses fonts in a different way than a standard client. To be able to use other fonts useful for BASIC/UX, use the xset command to make the needed fonts available.
For more information see the HP 700/RX Xstation User's Guide.
See the Using the X Window System manual for more information on selecting fonts in the X Window environment.