Professional Documents
Culture Documents
44
44 OOOOO SSSSSS 222222
44 OOOOOOO SSSSSSSS 22222222
44 44 OO OO SS 22 22
44 44 OO OO SS 22
44 44 OO OO SSSSSS 222
444444444 OO OO SSSSSS 222
44444444 OO OO SS 222
44 OO OO SS 22
44 OOOOOOO SSSSSSSS 22222222
44 OOOOO SSSSSS 222222222
Version 2.51
Developed By
Rex Conn and Tom Rawson
Documentation By
Hardin Brothers, Tom Rawson, and Rex Conn
Published By
JP Software Inc.
P.O. Box 1470
East Arlington, MA 02174
U.S.A.
(617) 646-3975
fax (617) 646-0904
ACKNOWLEDGMENTS
Contents
Introduction...............................................1
How to Use This Manual.................................2
Customer Service and Technical Support.................3
Chapter 1 / Installation...................................4
Automated Installation.................................5
Manual Installation....................................6
Manual Installation for OS/2 Version 1.x...........7
Manual Installation for OS/2 Version 2.x...........7
4OS2 Files and Directories.........................8
Uninstalling 4OS2......................................9
Chapter 2 / General Concepts..............................10
Terminology...........................................10
OS/2 Sessions and Applications........................11
Sessions and Session Types........................11
Applications and Application Types................13
Starting Sessions and Applications................14
Creating and Configuring Desktop Objects..............15
OS/2 Version 1.x Objects..........................15
OS/2 Version 2.x Objects..........................16
Extended Attributes...................................17
Chapter 3 / Configuration.................................18
Creating and Configuring 4OS2 Objects.................18
4OS2 Command Line Options.............................19
16-Bit and 32-Bit Versions of 4OS2....................21
4OS2 Help.............................................22
Using 4START and 4EXIT................................24
Using STARTUP.CMD.....................................25
Index.....................................................26
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / i
INTRODUCTION
-------------------------------------------------------------------
INTRODUCTION
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 3
CHAPTER 1 / INSTALLATION
-------------------------------------------------------------------
CHAPTER 1 / INSTALLATION
Automated Installation
To begin the automated installation process, open an OS/2
windowed or full-screen session and put the distribution
diskette in drive A. (You can use drive B if you prefer, in
which case you should substitute "b" for "a" in the
instructions below.)
One of the files on the distribution diskette, README.1ST,
contains information that you should read before you install
4OS2 on your computer. Type:
type a:readme.1st | more
to view the file. If you want to print a copy of the file,
type:
copy a:readme.1st prn
After checking README.1ST, you can start the installation
process. Type:
a:install
and press the Enter key.
Once the installation program has started, just follow the
instructions on the screen and 4OS2 will install itself on
your system.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 5
CHAPTER 1 / INSTALLATION
-------------------------------------------------------------------
Manual Installation
The 4OS2 files are contained in a special library file on the
distribution diskette. You cannot simply copy the files from
the diskette onto your system. You must use the installation
program to extract and decompress the 4OS2 files if you want
to perform a manual installation, or if you need to replace a
damaged 4OS2 file on your hard disk.
If you want to install 4OS2 manually, first start the
automatic installation program using the instructions above.
Select the Extract all files option and extract the 4OS2 files
onto your hard disk (be sure to place the files in their own
directory).
If you're installing a downloaded copy of 4OS2, you will not
have an INSTALL program. Instead, use the appropriate
decompression program (for example, PKUNZIP) to extract the
files from your download into a new directory. Then follow
the instructions below to complete your installation. If you
are updating from a previous version, check the README.DOC
file for update instructions.
Once you've extracted the files, you can go through the Guided
Tour if you want to try 4OS2 before completing the
installation (see the separate Guided Tour documentation).
When you run the tour, the HELP command and F1 key, along with
the /? option for 4OS2 commands, may not work if the required
files are not accessible. You can activate these features
during the tour by following the instructions for 4OS2.INF and
4OS2H.MSG in the 4OS2 Files and Directories section below.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 6
CHAPTER 1 / INSTALLATION
-------------------------------------------------------------------
SET OS2_SHELL=D:\OS2\CMD.EXE
SET COMSPEC=D:\OS2\CMD.EXE
Change both of these lines so that they to point to 4OS2.EXE,
instead of to the CMD.EXE file. Be sure to enter the correct
path for the directory where you installed 4OS2. When you are
done, the lines should look like this:
SET OS2_SHELL=C:\4OS2\4OS2.EXE
SET COMSPEC=C:\4OS2\4OS2.EXE
Verify that the changes have been made correctly and then save
the CONFIG.SYS file. Exit from your editor, shut down OS/2,
and reboot your system.
Uninstalling 4OS2
We don't expect you to have any trouble using 4OS2, but we
know some people feel more comfortable knowing how to
uninstall a product as well as install it. Or, you may need
to remove 4OS2 from one system to move it to another system.
To temporarily remove 4OS2 from your system, use an ASCII
editor to edit your OS/2 CONFIG.SYS file. You will need to
edit both the SET COMSPEC line (all versions of OS/2) and
either the PROTSHELL line (OS/2 version 1.x) or SET OS2_SHELL
line (OS/2 version 2.x). In all cases, change the reference
to 4OS2.EXE to the complete path and filename of CMD.EXE.
Save the file, exit from your editor, shut down OS/2 and
reboot your system. You should be back up and running under
CMD.EXE. To switch back to 4OS2, edit CONFIG.SYS again to
restore the 4OS2 lines as described above, and shut down and
reboot.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 9
CHAPTER 2 / GENERAL CONCEPTS
-------------------------------------------------------------------
This chapter contains information about OS/2 and 4OS2. Some of the
information is general and introductory in nature; other parts of
this chapter are fairly detailed and technical. We encourage you
to at least scan through this chapter to see what is here and to
study the sections that appear to have relevance to your work with
4OS2 and OS/2.
Technical experts will recognize that some explanations are not
complete (for example, this chapter does not explore the
distinction between sessions and screen groups), but they should
serve as a useful introduction for many users.
Terminology
Throughout this manual, the term "desktop" refers to the
Presentation Manager in OS/2 version 1.x or the Workplace
Shell in OS/2 version 2.x.
The term "object" refers to a selectable item on your desktop,
whether or not the corresponding icon is actually visible (you
may have chosen to configure the desktop with only session
names visible, rather than the icons themselves). For
example, the standard desktop for all versions of OS/2
includes objects titled "OS/2 Window" and "OS/2 Full Screen,"
typically kept in the Main group (OS/2 1.x) or the Command
Prompts folder (OS/2 2.x).
The term "session" refers to the OS/2 session created by
selecting an object on the desktop. Sessions run a program or
sequence of programs. See below for more information on
sessions and session types. When you double-click on an
object or select it with the keyboard and press Enter, a new
session is started (or, for Presentation Manager programs, the
program is started in the PM session).
The term "process" refers to a single invocation of a
particular program within a session. Many sessions run only a
single process. However, multiple processes can run
simultaneously within the same session. For example, in a
4OS2 session which is running a character-mode text editor,
two processes are running: 4OS2 and the text editor.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 10
CHAPTER 2 / GENERAL CONCEPTS
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 12
CHAPTER 2 / GENERAL CONCEPTS
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 13
CHAPTER 2 / GENERAL CONCEPTS
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 14
CHAPTER 2 / GENERAL CONCEPTS
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 15
CHAPTER 2 / GENERAL CONCEPTS
-------------------------------------------------------------------
To create a new object, switch to the group where you want the
object to appear and choose the New selection on the File
menu. Then follow the selections in the dialog box to adjust
the object's properties.
To adjust the properties of an existing object, first select
it (click on the object once, or use the arrow keys on the
keyboard), then open the File Properties menu from the menu
bar. From within this menu you can modify the program name,
startup directory, command line parameters, and other
configuration data for the object. If you use an asterisk [*]
in the "Program Name" field for an object which starts an OS/2
full-screen or windowed session, that object will start the
OS/2 command processor named at the end of the PROTSHELL line
in CONFIG.SYS (typically 4OS2.EXE or CMD.EXE).
Extended Attributes
DOS allows a limited set of attributes for files; for example,
a file can have Read-Only, Hidden, System, or Archive
attributes (for more information about file attributes, see
Chapter 1 of your Reference Manual). OS/2 supports additional
information about files called "Extended Attributes" or "EAs."
The Extended Attributes for a file provide additional
information which is not part of the file's actual contents.
This information might include the icon to be displayed for
the file on the OS/2 desktop, or the type of data contained in
the file.
OS/2 supports Extended Attributes on both FAT (DOS-compatible)
and HPFS (High Performance File System) partitions. EAs for
the files on a FAT partition are stored in the file
"EA DATA. SF" in the partition's root directory. Like
CMD.EXE, 4OS2 preserves a file's EAs when copying or moving
the file, and makes the appropriate adjustments to EAs when a
file is deleted or renamed.
If you boot DOS and delete or otherwise manipulate files that
have Extended Attributes, you can face several unexpected
problems when you next boot under OS/2, because the EAs and
directories will no longer be synchronized. If you must
manipulate files with Extended Attributes during a DOS boot,
make sure you run OS/2's CHKDSK program the next time you boot
OS/2. (This problem does not occur when you manipulate files
with 4DOS or COMMAND.COM in a standard OS/2 VDM, but it can
occur if you copy or move files while running a specific
version of DOS, such as MS-DOS 3.3, under OS/2.)
For more information on Extended Attributes, see your OS/2
documentation.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 17
CHAPTER 3 / CONFIGURATION
-------------------------------------------------------------------
CHAPTER 3 / CONFIGURATION
This chapter explains how you can tune 4OS2 to make it as efficient
and as useful as possible in your computing environment. Nearly
everything in this chapter is for advanced users and those with
unusual needs. If 4OS2 works the way you want it to after
installation, you can skip this chapter. You may, however, want to
skim this material to see what options are available.
In this chapter, we assume that 4OS2 is set up as the default OS/2
command processor in your OS/2 CONFIG.SYS file. This is normally
done when you install 4OS2. See page 6 for information on making
these changes to CONFIG.SYS manually.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 18
CHAPTER 3 / CONFIGURATION
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 19
CHAPTER 3 / CONFIGURATION
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 20
CHAPTER 3 / CONFIGURATION
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 21
CHAPTER 3 / CONFIGURATION
-------------------------------------------------------------------
4OS2 Help
Complete on-line help for all 4OS2 commands and features is
provided with 4OS2. Help is invoked with the HELP command or
the F1 key.
4OS2's help text does not cover the OS/2 external commands
because they are included in OS/2's built-in Command
Reference. The OS/2 Command Reference is normally displayed
along with 4OS2's help when the HELP command or F1 key is
used. You can also use the 4OS2 HELP command for quick help
on 4OS2 commands, and for explanations of OS/2 error messages
(see below for details).
When you start the 4OS2 Help system, 4OS2 opens a new window
to run VIEW.EXE, the standard help program supplied with OS/2.
VIEW displays the 4OS2 Help and OS/2 Command Reference
information and lets you browse through it.
If you invoke VIEW from a windowed 4OS2 session, you will be
returned to that session when you are done with VIEW. If you
invoke VIEW from a full-screen session, you must manually
return to that session using standard OS/2 methods for
switching between sessions (this is due to the design of VIEW
and is not a limitation of 4OS2).
You can also keep the VIEW help window on the screen and
return to the 4OS2 session, switching between the two sessions
as needed. This may be useful when you are writing a batch
file, working on a complex command, or experimenting with
4OS2.
In order for the 4OS2 help system to work properly, both
VIEW.EXE and the help text file, 4OS2.INF, must be in their
proper locations. VIEW.EXE is normally stored in the \OS2
directory. This directory must be included in your PATH (as
it normally is) so that 4OS2 can find and start VIEW.
During automated installation, 4OS2.INF is copied to your 4OS2
installation directory, and the installation program adjusts
the SET BOOKSHELF line in CONFIG.SYS to include this
directory. This allows VIEW to find 4OS2.INF when you press
F1 or use the HELP command. If you prefer, you can move
4OS2.INF to the standard "book" directory shown on the SET
BOOKSHELF line in CONFIG.SYS (normally \OS2\BOOK), in which
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 22
CHAPTER 3 / CONFIGURATION
-------------------------------------------------------------------
Using STARTUP.CMD
If you have a STARTUP.CMD file in the root directory of your
OS/2 boot drive, OS/2 will automatically create a windowed
4OS2 session when the system boots and will tell that session
to execute STARTUP.CMD. (This is a feature of OS/2 and does
not depend on 4OS2. If CMD.EXE is your OS/2 command
processor, it will be used to run STARTUP.CMD.)
You can use STARTUP.CMD to start other sessions, to set up a
global alias list, start SHRALIAS, etc., just as you might use
AUTOEXEC.BAT under DOS (see the ALIAS command in the Reference
Manual for more information on SHRALIAS). STARTUP.CMD will be
executed once, when your system boots, not every time a 4OS2
session is started.
If you place the command EXIT at the end of STARTUP.CMD, the
session created to run STARTUP.CMD will end when that command
is executed, and any global alias and history lists will be
discarded (unless another 4OS2 session has been started or
SHRALIAS has been loaded). If you don't include an EXIT, the
session will remain open and can be used as a normal windowed
4OS2 session. If you have a 4START file, it will be run
before STARTUP.CMD.
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 25
Index
-------------------------------------------------------------------
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 26
Index
-------------------------------------------------------------------
OS/2
shell, 1
versions of, 1, 21
Presentation Manager, 10
applications, 13
sessions, 11
Process, 10
Quick help, 23
README.1ST file, 5
Reference information, 2
Reference Manual, 2
Sessions, 10
4OS2, 18
starting, 14
types of, 11
Settings notebook, see Desktop
objects
Shell, 1
SHRALIAS.EXE, location of, 8
Startup options, 18, 19
//iniline, 20
/C, 21
/K, 21
/L, /LA, /LD, and /LH, 20
/S, 20
@inifile, 20
commands in, 21
STARTUP.CMD, 24
Support, 3
Technical support, 3
Uninstalling 4OS2, 9
VDM, see DOS sessions
VIEW.EXE, see Help system
VMB, see DOS sessions
Windowed sessions, 12
Windows
applications, 14
sessions, 13
Workplace Shell, 10
-------------------------------------------------------------------
Copr. 1995 JP Software Inc. 4OS2 Intro. & Installation Guide / 27