SOFTPC(1) COMMAND REFERENCE SOFTPC(1) NAME SoftPC - invoke the IBM PC emulator For UTek 4300 series products only. 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. Printed 5/19/88 1
SOFTPC(1) COMMAND REFERENCE SOFTPC(1) 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 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 Printed 5/19/88 2
SOFTPC(1) COMMAND REFERENCE SOFTPC(1) 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 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 Printed 5/19/88 3
SOFTPC(1) COMMAND REFERENCE SOFTPC(1) 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 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 Printed 5/19/88 4
SOFTPC(1) COMMAND REFERENCE SOFTPC(1) /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 5/19/88 5
%%index%% na:288,129; sy:417,246; de:663,2376;3399,4301;8060,4201;12621,2080; fi:14701,844;15905,290; se:16195,341; %%index%%000000000139