SOFTPC(1) COMMAND REFERENCE SOFTPC(1)
NAME
SoftPC - invoke the IBM PC emulator
SYNOPSIS
SoftPC
SoftPC &
DESCRIPTION
The SoftPC (or SoftPC &) command invokes the emulation of an
IBM PC. The SoftPC emulator is object code compatible with
an 8086-based processor.
Note that if you have a Tektronix 4310 or 4320/4330 series
workstation the X window system must be running before you
can invoke SoftPC. Type:
xinit
to start the X window system.
For a single session of SoftPC, type:
SoftPC
For running multiple SoftPC sessions or to run any UTek
process you must type:
SoftPC &
For more information, refer to the SoftPC User manual
(Tektronix order number 070-6725-xx).
SoftPC emulates a hard disk drive (either a Color Graphics
Adapter or a Monochrome Display Adapter), 640Kbytes of
read/write memory, a 5 1/4 inch floppy diskette drive, the
MicroSoft Bus Mouse, and the MicroSoft Bus Mouse driver.
The right button of the mouse invokes a pop up menu with the
following options:
Set Up Panel Display the Set Up Panel. The Set Up Panel
allows you to change the configuration of
the emulated IBM PC. For more information
on the Set Up Panel, refer to the Set Up
Panel section in this command description.
Freeze Stop the emulator so that it consumes
negligible resources. Many PC-based
programs, including DOS, have a busy wait
loop that consumes CPU resources even while
the emulator is waiting to execute. While
in the wait loop, this option temporarily
Printed 4/6/89 1
SOFTPC(1) COMMAND REFERENCE SOFTPC(1)
suspends the emulation, but the clock
continues running.
UnFreeze Restart a previously suspended SoftPC
process.
Attach Mouse Map mouse movements from the physical mouse
to the emulated IBM PC mouse. Once the
mouse is attached to a SoftPC window it can
only move within that window. The left and
middle physical mouse buttons are mapped to
the left and right mouse buttons of the
MicroSoft mouse, respectively.
Detach Mouse Terminate the Attach Mouse mode and return
the mouse to the UTek windowing system.
Switch Sound On Enable the IBM PC sound facilities which
are disabled by default.
Switch Sound Off Disable the IBM PC sound facilities that
the Switch Sound On option enabled.
Attach Floppy Allow attachment of the floppy diskette to
a specific SoftPC session; SoftPC can have
multiple windows active at any one time,
but the computer system has only one
physical floppy diskette drive. Thus, two
IBM PC's accessing the same floppy diskette
simultaneously would have disastrous
results. Therefore, only one SoftPC session
can access the floppy diskette drive at any
one time.
Detach Floppy Release control of the physical floppy that
the Attach Floppy option asserts.
Flush Comms Port Clear output that is pending on the
emulated serial ports. The serial
communications ports on the emulated IBM PC
can connect to a number of different
logical devices within the UTek system
(refer to the Set Up Panel section in this
command description for more information on
configuring logical devices). If the
SoftPC session is connected to the line
printer spooler, no output appears on the
port until the port is cleared.
Reset Cause a soft reset of the IBM PC emulator
(a reboot). A reset is necessary when there
is no other way to exit a particular IBM PC
Printed 4/6/89 2
SOFTPC(1) COMMAND REFERENCE SOFTPC(1)
application (for example, MicroSoft's
Flight Simulator).
Exit SoftPC Exit a SoftPC session.
When the mouse is located on the emulated IBM PC On/Off
switch, the left button of the emulated mouse is used to
toggle between the Freeze and UnFreeze states.
Set Up Panel
The Set Up Panel option on the main SoftPC menu displays a
Set Up Panel. The Set Up Panel allows you to change the
configuration of the emulated IBM PC. To exit Set Up Panel,
choose either:
Confirm Save the changes made.
Cancel Abort any changes made and restore the
previous settings. The configuration
selected is stored in the executable file
$HOME/.SoftPC as the user's own set of
default values. Cancel and Confirm are
also available in the Reset and Exit SoftPC
options.
When invoked, the Set Up Panel displays options for Disk,
Display, and Comms. The Disk panel has the following
prompts:
Hard disk file name
Specify the full path name of the PC hard
disk image; the default hard disk is
/usr/lib/SoftPC/hard_disk.
Unix file name Specify the full path name of the user; the
general path name is /u/usr_name.
Create new hard disk
Allows creation of a new hard disk image.
You are prompted for the path name of the
new disk and its size in megabytes.
The Display panel allows selection between the Color
Graphics Adapter (CGA) and the Monochrome Display Adapter
(MDA). Changing the display adapter causes a soft reset of
the emulated IBM PC.
The Comms panel allows mapping of the two IBM PC serial
ports (COM_PORT_1 and COM_PORT_2) to various types of UTek
objects. The simplest use of these options is to map
COM_PORT_1 to /dev/ttya and COM_PORT_2 to /dev/ttyb. To map
Printed 4/6/89 3
SOFTPC(1) COMMAND REFERENCE SOFTPC(1)
communication ports one and two, type in the full path name
to the device in response to the Com1 Destination and Com2
Destination prompts, respectively; this allows use of the
physical serial devices for connecting IBM PC peripherals
(for example, modems and printers). Remember to remove any
logins from the device and set the special file /dev/... to
be readable and writable for any users of SoftPC.
You can also type in a file name for the mapping
destination. In this case, any output directed to the
communications ports appears in the designated UTek file.
To connect a communications port to a pipe, type: |
process. Any output directed to the communications port is
then piped to the named process. For example, the command
| lpr pipes output to the line printer.
FILES
/usr/lib/SoftPC/font.40/*
Fonts used in 40 column mode
/usr/lib/SoftPC/font.80/*
Fonts used in 80 column mode
/usr/lib/SoftPC/hard_disk
Default IBM PC hard disk image
/usr/lib/SoftPC/.SoftPC
Data base of IBM PC configurations
$HOME/.SoftPC Data base of IBM PC configurations
/usr/lib/SoftPC/SoftPCkeymap
SoftPC application program in
executable form
SEE ALSO
MS DOS Technical Reference manual
MS DOS User Guide
SoftPC User manual (Tektronix order number 070-6725-xx)
Printed 4/6/89 4
%%index%%
na:288,87;
sy:375,246;
de:621,2533;3514,4415;8289,3960;12609,992;
fi:13601,894;
se:14495,308;
%%index%%000000000127