






                       44
                      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



                        Introduction and Installation Guide




                                   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


             We couldn't produce a product like 4OS2 without the dedication
             and quality work of many people.  Our thanks to:

                  JP Software Staff:  Christine Alves, Mike Bessy, Michael
                  Hart, Ellen Stone, Misty White.

                  Online Support:  Brian Miller and Tess Heder of Channel 1
                  BBS; Don Watkins of CompuServe's IBMNET.

                  Beta Test Support:  The sysops of CompuServe's CONSULT
                  forum.

                  Beta Testers:  We can't list all of our beta testers
                  here!  A special thanks to all of you who helped make
                  4OS2 elegant, reliable, and friendly.

                  SHRALIAS Program:  Bill Hinkle.

             The following tools are used in creating and maintaining 4OS2:

                  Compilers:       IBM C-Set/2, Microsoft C, Microsoft
                                   Macro Assembler
                  Libraries:       Spontaneous Assembly (Base Two
                                   Development)
                  Editors:         Edix (Emerging Technology), Brief
                                   (Solution Systems)
                  Debuggers:       IPMD (IBM)
                  Version Control: PVCS (Sage Software)
                  Documentation:   Microsoft Word for Windows with Adobe
                                   Type Manager





             Copyright 1993 - 1995, JP Software Inc., All Rights Reserved.
             4DOS is a registered trademark and 4OS2, JP Software, and the
             JP Software logo and product logos are trademarks of JP
             Software Inc.  Other product and company names are trademarks
             of their respective owners.

                                                                       8-95
                                                                   Contents
        -------------------------------------------------------------------



        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


        Welcome, and thanks for purchasing 4OS2!

        We developed 4OS2 to bring the power and convenience of our popular
        4DOS program to users of the OS/2 operating system.  Whether you
        are a computer novice or an experienced user, 4OS2 will help you
        get the most out of your OS/2 system.

        Technically, 4OS2 is a command interpreter or "Shell."  That means
        that it reacts to the commands you type at the [C:\] prompt.  It
        replaces CMD.EXE, the default command interpreter that is supplied
        with OS/2.  4OS2 offers hundreds of enhancements, yet retains full
        compatibility with CMD.EXE commands and batch files.

        If you are familiar with 4DOS or with the OS/2 command prompt, you
        won't have to change your computing habits or unlearn anything to
        use 4OS2.  If you know how to use commands to display a directory,
        copy a file, or start an application program, you already know how
        to use 4OS2.  And if you are a 4DOS user, you already know how to
        use most of the advanced features that we have built into 4OS2.
        You can even use many of your 4DOS batch files with 4OS2 (see
        Chapter 3 of the Reference Manual, or the Batch Files topic in the
        online help, for tips about making batch files work properly in
        both environments).

        Once you have 4OS2 installed, you can learn its new features at
        your own pace.  Relax, enjoy 4OS2's power, and browse through the
        manuals occasionally.  Press the F1 key whenever you need help.
        4OS2 will soon become an essential part of your computer, and
        you'll wonder how you ever got along without it.

        If you want to take 4OS2 for a spin without performing a complete
        installation, see the separate Guided Tour documentation.

        This version of 4OS2 is designed for OS/2 versions 1.21, 1.3, 2.0,
        and 2.1.  You must have one of these versions of OS/2 operating on
        your computer to install and use 4OS2.  Throughout this manual, we
        refer to versions 1.21, and 1.3 as "version 1.x," and versions 2.0
        and 2.1 as "version 2.x."

        We are constantly working to improve 4OS2.  If you have suggestions
        for features or commands that we should include in the next
        version, or any other way we could improve our product, please let
        us know.  Many of the features in this version of 4OS2 were
        suggested by our users.  We can't promise to include every
        suggestion, but we really do appreciate and pay attention to your
        comments.

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.    4OS2 Intro. & Installation Guide / 1
                                                               INTRODUCTION
        -------------------------------------------------------------------




        How to Use This Manual

             This manual is only one part of the documentation that you
             will need for 4OS2.  It introduces the product and will help
             you install 4OS2 correctly on your computer.  It will also
             help you understand some of the terms and concepts that you
             will need to know to get the most from 4OS2.

             The second part of our documentation is the separate Reference
             Manual.  It contains complete information about the commands
             and features of 4OS2, plus its sister programs, 4DOS and 4DOS
             for Windows NT.

             You should start with this introductory manual whether you are
             new to 4OS2 or you are upgrading from a previous version.
             Once you have successfully installed 4OS2, you can move back
             and forth between this manual and the Reference Manual.

             For the sake of clarity, we have chosen not to indicate each
             of the dozens of places in this manual where you can refer to
             the Reference Manual for additional information.  If you see a
             reference here to a 4OS2 command, the initialization file
             4OS2.INI, or any 4OS2 feature, you can be sure that detailed
             information on that topic is available in the Reference
             Manual.

             4OS2 also includes complete online help for all of its built-
             in commands.  The online help provides much of the same
             information that is in the Reference Manual, but in an
             electronic form which you can access quickly.  See page 22 for
             more details on using the online help.

             Files distributed with 4OS2 cover important additional
             information beyond what's included in the manuals.  README.DOC
             contains general notes, highlights of the latest release, and
             brief installation instructions for those upgrading from a
             downloaded copy.  MANMOD.DOC covers changes or corrections in
             the manuals, if any, and UPDATxxx.DOC contains detailed
             information for users with older versions on what has changed
             in the latest release ("xxx" is the version number).

             You will likely find some parts of the documentation too
             simple or too technical for your tastes.  Unless you are
             convinced that one of those sections holds just the
             information you need for a specific task, feel free to skip to
             the next part of the manual that is more to your liking.  You
             can use almost every feature of 4OS2 without having to worry
             about other features or commands.

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.    4OS2 Intro. & Installation Guide / 2
                                                               INTRODUCTION
        -------------------------------------------------------------------


        Customer Service and Technical Support

             Technical support for 4OS2 is available via public electronic
             support conferences, private electronic mail, telephone, fax,
             and mail.  For complete details, including a listing of
             electronic support conferences, see your Reference Manual.

             Customer service is always available through the telephone and
             fax numbers listed on the title page of this manual.  See your
             Reference Manual for electronic mail addresses for our Sales
             and Customer Service departments.








































        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.    4OS2 Intro. & Installation Guide / 3
                                                   CHAPTER 1 / INSTALLATION
        -------------------------------------------------------------------



        CHAPTER 1 / INSTALLATION


        You can install your copy of 4OS2 automatically or manually.

        If you prefer an automated installation, our installation software
        will set up 4OS2 for you quickly and with very little intervention
        on your part, other than answering the questions on your screen.

        If you prefer to install 4OS2 yourself, you'll need to use the
        installation software to copy the 4OS2 files to your disk.  You can
        then modify your system manually as explained below.

        If you're installing a downloaded copy of 4OS2, see the
        instructions under Manual Installation on page 6.

        No matter which method you choose, you'll find that 4OS2's
        installation software is very well-behaved.  It won't modify or
        erase any existing files, including CONFIG.SYS, without asking you,
        and it takes a very straightforward, step-by-step approach.

        The installation software always prompts you for the directory to
        use for your 4OS2 files, and will create a new directory if
        necessary.  If you are upgrading from a previous version of 4OS2,
        use a new directory for the new version, rather than overwriting
        your existing files.  Transfer any necessary configuration files
        from the old directory (e.g. 4OS2.INI, 4START, etc.), then remove
        the old directory once the new version is up and running.

        Before you install 4OS2 (or any other software, for that matter),
        you should verify that you have a bootable system diskette so you
        can recover in case of a power failure or other interruption during
        the installation process.  Such problems are rare under OS/2, but
        having a bootable system disk is a wise precaution in any case.
        Your OS/2 installation disks can be used for this purpose.

        Once you have 4OS2 installed, the standard "OS/2 Window" and "OS/2
        Full Screen" selections in your Command Prompts folder (OS/2
        version 2.x) or Group-Main window (OS/2 version 1.x) will normally
        start 4OS2 instead of CMD.EXE.  You may wish to change the names of
        these selections to "4OS2 Window" and "4OS2 Full Screen".

        If you have a STARTUP.CMD batch file, it will run just as it did
        before you installed 4OS2.  OS/2 will create a 4OS2 session at boot
        time and pass the STARTUP.CMD command to that session, just as it
        did with CMD.EXE.  See page 25 for more information on STARTUP.CMD.

        Your copy of 4OS2 includes both 32-bit and 16-bit versions.  The
        versions are described in detail on page 21.  The 4OS2 INSTALL

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.    4OS2 Intro. & Installation Guide / 4
                                                   CHAPTER 1 / INSTALLATION
        -------------------------------------------------------------------


        program automatically determines the correct version for your
        system, based on the version of OS/2 you are running.  During
        installation, you may notice that INSTALL displays a few file names
        specific to the particular version being installed (for example
        4OS2-32.EXE or SHRALS16.EXE).  These are the names of the files as
        they are stored on the distribution disk.  The files are renamed
        automatically by INSTALL, and will have "version-independent" names
        (for example 4OS2.EXE or SHRALIAS.EXE) once they are installed on
        your hard disk.

        If you also have our DOS command processor, 4DOS, do not install
        4OS2 in the same directory as 4DOS.  Some file names (for example
        README.DOC) are the same in both products, and the files should be
        kept separate to avoid confusion.

        For information about creating additional 4OS2 objects, configuring
        4OS2, and setting up startup batch files for specific 4OS2
        sessions, see pages 15 and 18.


        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
        -------------------------------------------------------------------


             The installation program will ask whether you want to perform
             a full installation, extract all the 4OS2 files in order to
             run the Guided Tour, or retrieve individual files from the
             4OS2 library.  Choose a full installation to install 4OS2 on
             your system and modify CONFIG.SYS (you will be prompted for
             permission before CONFIG.SYS is modified).  Choose the Extract
             All Files / Tour option if you want to run the Guided Tour and
             see what 4OS2 can do before you install it permanently (see
             the separate Guided Tour booklet).

             If you elect to perform a full installation, shut down OS/2
             and reboot your computer when the installation program is
             done.  You will then have all the power of 4OS2 available to
             you.

             You can halt the installation process at any time by pressing
             Ctrl-X (hold down the Ctrl key and then press "X").


        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
        -------------------------------------------------------------------


             When you're ready to finish the installation process, follow
             the instructions in the appropriate sections below.  Once you
             have modified CONFIG.SYS and rebooted, your standard "OS/2
             Full-Screen" and "OS/2 Windowed" desktop objects can normally
             be used to start 4OS2.


             Manual Installation for OS/2 Version 1.x

             Use an ASCII-format editor (like the OS/2 System Editor) to
             edit your OS/2 CONFIG.SYS file.  In the file, you will find a
             line that begins with the word PROTSHELL and another that
             begins with the words SET COMSPEC.  The lines should look like
             this, but they may not be adjacent in the file (the PROTSHELL
             command is all on one line):

                  PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI
                       C:\OS2\OS2SYS.INI C:\OS2\CMD.EXE
                  SET COMSPEC=C:\OS2\CMD.EXE

             Change the last item on the PROTSHELL line, the item that
             includes the filename CMD.EXE, to point to 4OS2.EXE.  Be sure
             to include the full path for the directory where you installed
             4OS2.EXE.  The changed PROTSHELL line should look like this
             (it should all be on one line):

                  PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI
                       C:\OS2\OS2SYS.INI C:\4OS2\4OS2.EXE

             Do not change PMSHELL.EXE to 4OS2.EXE.  Change only the name
             and path of CMD.EXE.

             Now change the SET COMSPEC line so that it also contains the
             full path of 4OS2.EXE.  The completed line should look like
             this:

                  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.


             Manual Installation for OS/2 Version 2.x

             Use an ASCII-format editor (like the OS/2 System Editor) to
             edit your OS/2 CONFIG.SYS file.  In the file, you will find a
             line that begins with the words SET OS2_SHELL and another that
             begins with the words SET COMSPEC.  The lines should look like
             this, but they may not be adjacent in the file:

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.    4OS2 Intro. & Installation Guide / 7
                                                   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.


             4OS2 Files and Directories

             The automated installation procedure places all 4OS2 files in
             a single directory.  You may move the files to different
             directories if you wish, but you must make sure that the files
             can be found by the programs that need to use them.  The
             following information will help you set up your system
             correctly if you are performing a manual installation:

                  4OS2.EXE is the 4OS2 program file.  It must be in the
                  directory specified in the PROTSHELL (OS/2 version 1.x),
                  SET OS2_SHELL (OS/2 version 2.x), and SET COMSPEC lines
                  in your CONFIG.SYS file as explained above.

                  4OS2.INF contains the text for the 4OS2 HELP command and
                  F1 key.  For HELP to work properly, the directory
                  containing this file must be included in the BOOKSHELF
                  environment variable, which is usually set with a SET
                  BOOKSHELF command in CONFIG.SYS.  If you prefer, you can
                  move this file into the standard OS/2 bookshelf
                  directory, \OS2\BOOK.

                  4OS2H.MSG contains the help text for the /? option that
                  is available as part of each 4OS2 internal command.  For
                  this feature to work properly, the directory containing
                  this file must be included in the DPATH environment
                  variable, which is usually set with a SET DPATH command
                  in CONFIG.SYS.  If you prefer, you can move this file
                  into the standard OS/2 directory for such files,
                  \OS2\SYSTEM.

                  SHRALIAS.EXE is a small utility that saves the shared
                  alias and history list between 4OS2 sessions.  The
                  directory containing this file should be listed in your

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.    4OS2 Intro. & Installation Guide / 8
                                                   CHAPTER 1 / INSTALLATION
        -------------------------------------------------------------------


                  PATH statement.  If it is not, you will have to specify
                  the full path name to load SHRALIAS.EXE each time you
                  want to use it.


        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
        -------------------------------------------------------------------



        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
        -------------------------------------------------------------------


        OS/2 Sessions and Applications

             OS/2 supports several different types of applications and many
             methods for starting them.  Most of the time, you don't need
             to worry about these differences because 4OS2 and OS/2
             cooperate to take care of them for you.  You may, however,
             find this general discussion of applications and sessions
             useful to understand what happens when you run an application
             or other external program.  If you need more details, see the
             OS/2 online reference information.


             Sessions and Session Types

             OS/2 programs are run in "sessions" which are programs or
             groups of programs whose output typically appears in specific
             windowed display areas on the desktop ("windowed" sessions) or
             takes up the whole screen ("full-screen" sessions).

             A windowed session runs on the desktop in a graphical window
             whose size you (or an OS/2 application) can change.  As a
             result, portions of the session's display area may be covered
             or invisible at any given time.  The "active" session, or the
             session that receives keystrokes, is always shown with a
             highlighted title bar at the top of its window.

             Full-screen sessions run on a standard text mode display,
             generally 80 characters by 25 or 50 lines.  When such a
             session is active, its full display area is visible and it
             hides all other sessions and the desktop itself.  You can
             press Alt-Esc to switch back to the desktop from a full-screen
             session.

             OS/2 supports ten different types of sessions:

                  OS/2 Presentation Manager (PM) session:  There is a
                  single PM session which starts when you start OS/2.  This
                  session runs in graphics mode on the desktop.  All OS/2
                  Presentation Manager applications run within this single
                  PM session (though for practical purposes they may appear
                  to be running in separate sessions, since each
                  application has its own window).  Their output is
                  graphical and may include pictures and a variety of fonts
                  within the same window.  Examples of applications that
                  run in the PM session include the OS/2 help file viewer
                  (VIEW.EXE), and the OS/2 System Editor (E.EXE).

                  OS/2 character mode, full-screen session:  This session
                  type displays only text in character mode, like a
                  standard DOS application.  It uses the entire screen,

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 11
                                               CHAPTER 2 / GENERAL CONCEPTS
        -------------------------------------------------------------------


                  typically in standard 80 x 25 text mode.  Examples
                  include a 4OS2 or CMD.EXE full-screen session.

                  OS/2 character mode, windowed session:  This session type
                  is just like the character mode full-screen session
                  except that it runs in a window.  It uses the same text
                  font over the entire window and does not display
                  graphics.  Examples include a 4OS2 or CMD.EXE windowed
                  session.

                  DOS full-screen session:  A DOS session runs DOS within
                  OS/2.  A special version of DOS, designed to run in such
                  a session, is supplied with OS/2 and is generally
                  compatible with MS-DOS 4.0 (in OS/2 version 1.x) or MS-
                  DOS 5.0 (in OS/2 version 2.x).  A DOS full-screen session
                  has full control of the screen (including the ability to
                  switch it into graphics and non-standard text modes).  In
                  OS/2 version 1.x, you can start only one DOS session,
                  called the DOS Compatibility Box.  Once this session is
                  started, it cannot be closed (although you can switch
                  back to the desktop with Alt-Esc).  In OS/2 version 2.x,
                  you can start many such sessions, which are called
                  Virtual DOS Machines (VDMs).  VDMs can be terminated with
                  the EXIT command.  You can switch a full-screen DOS
                  session into windowed mode by pressing Alt-Home.  One
                  example of a DOS full-screen session is the session
                  started by the default "DOS full-screen" object which is
                  installed automatically with OS/2.

                  DOS windowed session:  Available only in OS/2 version
                  2.x, this session is similar to a DOS full-screen
                  session, but runs in a window on the desktop.  You can
                  switch a windowed DOS session into full-screen mode by
                  pressing Alt-Home.  A DOS windowed session can run all
                  text-mode DOS applications, and applications that display
                  graphics in standard graphics video modes.

                  Native DOS full-screen session:  Native DOS sessions are
                  also called Virtual Machine Boots or VMBs.  They are only
                  available in OS/2 version 2.x.  They are similar to the
                  DOS sessions described above, but load a specific version
                  of DOS (for example, MS-DOS 3.3), rather than the version
                  of DOS shipped with OS/2.  Like normal DOS sessions,
                  native DOS sessions can be switched between full-screen
                  and windowed mode by pressing Alt-Home.  For more
                  information on native DOS sessions, see the command
                  VMDISK and the topic "Starting a Specific Version of DOS"
                  in the on-line Command Reference for OS/2 version 2.x.



        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 12
                                               CHAPTER 2 / GENERAL CONCEPTS
        -------------------------------------------------------------------


                  Native DOS windowed session:  This session is similar to
                  a native DOS full-screen session, but it runs in a window
                  on the desktop instead of in full-screen mode.

                  Windows full-screen session:  This session type is
                  available only in OS/2 version 2.x.  A Windows full-
                  screen session is essentially a DOS full-screen session
                  that is running the special version of Microsoft Windows
                  that is supplied with OS/2 version 2.x (or running your
                  original Microsoft Windows 3.1, if you have IBM's "OS/2
                  for Windows" product).  It has the standard Windows
                  display, the Program Manager and Control Panel, etc., and
                  can run virtually all Windows applications.

                  WIN-OS/2 full-screen session:  This session type is
                  available only in OS/2 version 2.x.  It is similar to a
                  Windows full-screen session, but runs only a single
                  application, without the Program Manager.  Internally, it
                  starts a DOS session, tells DOS to load Windows, and
                  tells Windows to load the application.

                  WIN-OS/2 windowed session:  This session type is
                  available only in OS/2 version 2.x.  It allows a single
                  Windows application to run in a window on the Workplace
                  Shell desktop.  Internally, it loads the application just
                  like a WIN-OS/2 full-screen session.  However, the window
                  it opens is a graphical Presentation Manager window for
                  the Windows application.  This session type is sometimes
                  called a "seamless Windows" session.


             Applications and Application Types

             OS/2 and 4OS2 support six different types of applications.
             Application types are related to the type of session in which
             the application can run.  They are similar to, but not the
             same as, session types.  The type of an application is
             determined by the programmer who creates the program.
             Information about the application type is embedded in the
             application itself.

             The application types are:

                  OS/2 Presentation Manager application:  Runs in the PM
                  session only.  Examples include the OS/2 online help
                  program VIEW.EXE and the System Editor distributed with
                  OS/2.




        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 13
                                               CHAPTER 2 / GENERAL CONCEPTS
        -------------------------------------------------------------------


                  OS/2 character mode, full-screen application:  Runs in a
                  full-screen OS/2 session only.  Applications of this type
                  are rare.

                  OS/2 character mode, window-compatible application:  Runs
                  in a full-screen or windowed OS/2 session.  Most OS/2
                  character-mode applications -- including 4OS2 -- are in
                  this category.  This and the previous type are sometimes
                  called "VIO" applications.

                  DOS application:  Runs in a DOS session only.  Examples
                  include all .COM and .EXE files designed to run under
                  DOS, such as those for DOS communications programs and
                  word processors.  Virtually all DOS application programs
                  that use text displays will run in either a full-screen
                  or windowed DOS session.  Some DOS applications that use
                  graphics will run properly only in a full-screen DOS
                  session.  4OS2 also recognizes DOS batch files with a
                  .BAT extension as DOS applications.

                  "Bound application" or "Family-mode application":  Runs
                  in an OS/2 or a DOS character mode session from the same
                  file.  Bound applications are primarily used in compilers
                  and installation programs to allow the same file to run
                  under both DOS and OS/2.  The 4OS2 installation program,
                  INSTALL.EXE, and batch file compression program,
                  BATCOMP.EXE, are examples of bound applications.

                  Windows application:  Runs only in a Windows session.
                  Examples include applications like Word for Windows and
                  Quattro Pro for Windows.  Most Windows applications will
                  run properly in either a Windows full-screen session, or
                  a WIN-OS/2 full-screen or windowed session.


             Starting Sessions and Applications

             Before you can start an application program, you must have a
             session in which to execute it.  Every object on the OS/2
             desktop represents a potential session:  if you double-click
             the object, or select it and press Enter, OS/2 starts a new
             session (or a new window in the PM session), using the
             parameters that have been set up for that object.

             The parameters for the object may cause the session to run an
             OS/2 application program, load the OS/2 command processor and
             display a prompt, run a batch file that could in turn start
             other sessions, or start DOS, Windows, or a Windows
             application.


        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 14
                                               CHAPTER 2 / GENERAL CONCEPTS
        -------------------------------------------------------------------


             To start 4OS2, you must define an object for an OS/2 character
             mode session, either full-screen or windowed.  To do so, see
             Chapter 3 / Configuration (page 18) for full instructions.
             Briefly, after you have installed 4OS2 and defined it as the
             shell in your CONFIG.SYS file, simply place an asterisk [*] in
             the field for the program name.  (If CONFIG.SYS has not yet
             been set up for 4OS2, you must explicitly specify the full
             path and name of 4OS2.EXE instead of using the [*].)

             Once 4OS2 has started, you can start applications or other
             sessions from the 4OS2 prompt.  When you start an application,
             4OS2 checks its type.  If the type is the same as that of the
             session in which 4OS2 is running (i.e., if the application is
             an OS/2 character-mode application), the application will run
             in the same session as 4OS2.  4OS2 will wait for the
             application to complete before displaying a new prompt.  This
             is analogous to how applications are run in DOS.

             If the application type is different from the 4OS2 session
             type, 4OS2 will start a new session to run the application,
             and will wait for that session to complete before returning to
             the prompt.  If the application is started from a windowed
             session, 4OS2 will minimize its own window while the
             application is running.  You can force 4OS2 to start a new
             session and not wait for it to complete by using the START
             command.


        Creating and Configuring Desktop Objects

             This section gives you basic information which you will need
             to create and configure 4OS2 and 4DOS objects on your OS/2
             desktop.  For complete details on creating and configuring
             objects, see your OS/2 documentation.  For details on the
             appropriate properties or settings to use for 4OS2 objects see
             page 18.

             Throughout this section, we assume that OS/2 is running in its
             default configuration.  If you have modified the behavior of
             your mouse or desktop menus, or changed other configuration
             options, you will have to take those changes into account as
             you read the instructions below.


             OS/2 Version 1.x Objects

             In OS/2 1.x, objects are displayed in "groups" on the desktop.
             For example, the "OS/2 Full Screen" object normally appears in
             Group-Main.


        -------------------------------------------------------------------
        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).


             OS/2 Version 2.x Objects

             In OS/2 version 2.x, objects may appear on the desktop itself
             or within folders.  For example, the "OS/2 Full Screen" object
             normally appears in the "Command Prompts" folder.

             To create a new object, switch to the folder where you want
             the object to appear and either copy an existing object (use
             the Copy or Create Another selection on the object's popup
             menu) or drag a Program Template in from the Templates folder.
             Depending on the copying method you choose, the Settings
             notebook may open automatically.

             To adjust the properties of an object, you must open its
             Settings notebook.  To do so, click the right mouse button in
             the object.  When the popup menu appears, click on the small
             arrow to the right of the Open selection, then again on the
             Settings selection on the submenu.

             Once the Settings notebook is open, use the Program page to
             modify the program name, startup directory, and command line
             parameters.  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 on the SET OS2_SHELL line in CONFIG.SYS
             (typically 4OS2.EXE or CMD.EXE).  The Session page lets you
             set the session type.  Other pages let you adjust other
             configuration data for the object.

             The contents of the Settings notebook will vary depending on
             the type of object and the session type set on the Session
             page.  For example, DOS and Windows sessions allow control of
             a wide variety of DOS parameters (such as available XMS and

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 16
                                               CHAPTER 2 / GENERAL CONCEPTS
        -------------------------------------------------------------------


             EMS memory, or whether DOS is loaded high) using the "DOS
             Settings" or "WIN-OS/2 Settings" button on the Session page.
             However, this button cannot be used for Presentation Manager
             or OS/2 character-mode sessions.


        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.


        Creating and Configuring 4OS2 Objects

             Whether you are using OS/2 1.x or 2.x, you will typically
             start 4OS2 from an object on your OS/2 desktop.  The methods
             for creating these program objects vary depending on your
             operating system version (see page 15), but the basic
             characteristics of your 4OS2 objects are the same regardless
             of which version you use.

             You can create as many 4OS2 objects as you wish on the OS/2
             desktop.  Different objects can be used to start 4OS2 in
             different modes, with different startup commands or options,
             or to run different batch files or other commands.  You can
             use these objects to run commonly-used commands and batch
             files directly from the OS/2 desktop.

             Each object represents a different 4OS2 session and you can
             set up any of these sessions to run in windowed or full-screen
             mode.  You can also set any necessary command line parameters
             for 4OS2 such as a command to be executed, any desired
             switches, and the name and path for 4OS2.INI.  More
             information on command line switches and options for 4OS2 is
             included later in this section.

             When you configure a 4OS2 object, place an asterisk [*] in the
             Program Name field, and put any startup options that you want
             passed to 4OS2 (e.g., @inifile) in the Parameters field.  For
             example:

                  Path and file name: *
                  Parameters:         @D:\START\4OS2.INI
                  Working directory:  C:\


        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 18
                                                  CHAPTER 3 / CONFIGURATION
        -------------------------------------------------------------------


             (If 4OS2 is not set up as your default OS/2 shell in
             CONFIG.SYS, use the full path and name for 4OS2.EXE as the
             program name, rather than the asterisk.)

             To run a startup batch file for a particular 4OS2 session,
             include its name (with a path, if the batch file is not in the
             session's startup directory) as the last item in the
             Parameters field.  That batch file will be executed after any
             4START file but before the first prompt is displayed.  You can
             use the batch file to set environment variables and execute
             any other 4OS2 commands.  You can also execute any internal
             4OS2 command, external command, or alias by placing its name
             in the Parameters field.  When you set up a batch file or
             other command to run in this way you are using the command
             option (see below).  For example:

                  Path and file name: *
                  Parameters:         @D:\START\4OS2.INI STARTOS2.CMD
                  Working directory:  C:\

             To execute an internal or external command, an alias, or a
             batch file and then exit (return to the desktop) when it is
             done, place /C command (rather than just command) as the last
             item in the Parameters field.  For example:

                  Path and file name: *
                  Parameters:         /C COMFILES.BTM
                  Working directory:  C:\


        4OS2 Command Line Options

             The 4OS2 command line does not need to contain any
             information.  When invoked with an empty command line, 4OS2
             will configure itself from the 4OS2.INI file, run 4START, and
             then display a prompt and wait for you to type a command.
             However, you may add information to the 4OS2 command line that
             will affect the way it operates.

             Command line options for primary shells are set in the
             Parameters field of the 4OS2 object.  If you need help finding
             and setting the Parameters field for your version of OS/2, see
             page 15.  Command line options for secondary shells can be set
             on the secondary shell command line.

             4OS2 recognizes several optional fields on the command line.
             All of the options go on one line.  If you use more than one
             of these fields, their order is important.  The syntax for the
             command line is:


        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 19
                                                  CHAPTER 3 / CONFIGURATION
        -------------------------------------------------------------------


                  [d:\path] [@d:\path\inifile] [//iniline]... [/L] [/LA]
                  [/LD] [/LH] [/S] [/C | /K] [command]

             In the descriptions below, d: means a drive letter and \path
             means a subdirectory name.

                  d:\path:  4OS2 will use this directory and path to set
                  the COMSPEC environment variable for this session.  If
                  this option is not used, COMSPEC is set from the location
                  of 4OS2.EXE.  Since 4OS2 always knows what drive and
                  directory it was started from, there is little reason to
                  use this option.  It is included only for compatibility
                  with CMD.EXE.  This option cannot be used for secondary
                  shells.

                  @d:\path\inifile:  This option sets the path and name of
                  the 4OS2.INI file, which is discussed below.  You do not
                  need this option if you aren't using a 4OS2.INI file, or
                  if the file is named 4OS2.INI and is stored in the same
                  subdirectory as 4OS2.EXE or in the root directory of the
                  boot drive.  This option is most useful if you want to
                  start a 4OS2 session with a specific and unique .INI
                  file.

                  //iniline:  This option tells 4OS2 to treat the text
                  appearing between the // and the next space or tab as a
                  4OS2.INI directive.  The directive should be in the same
                  format as a line in 4OS2.INI, but it may not contain
                  spaces, tabs, or comments.  This option overrides any
                  corresponding directive in your 4OS2.INI file.  It is a
                  convenient way to send 4OS2 one or two simple directives
                  without modifying or creating a new 4OS2.INI file.

                  /L, /LA, /LD, and /LH:  These options force 4OS2 to use a
                  local alias, directory history, and / or command history
                  list.  This allows you to use global lists as the
                  default, but start a specific 4OS2 session with local
                  aliases or history.  See your Reference Manual for
                  details on local and global aliases and history.  /LA
                  forces local aliases, /LD forces local directory history,
                  /LH forces local command history, and /L forces all
                  three.

                  /S:  This option tells 4OS2 that you do not want it to
                  set up a Ctrl-C / Ctrl-Break handler.  It is included for
                  compatibility with CMD.EXE, but it may cause the system
                  to operate incorrectly if you use this option without
                  other software to handle Ctrl-C and Ctrl-Break.  This
                  option should be avoided by most users.


        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 20
                                                  CHAPTER 3 / CONFIGURATION
        -------------------------------------------------------------------


                  [/C | /K] command:  This option tells 4OS2 to run a
                  command when it starts.  The command will be run after
                  4START has been executed and before any command prompt is
                  displayed.  It can be any valid internal or external
                  command, batch file, or alias; you may include multiple
                  commands by using the command separator.  All other
                  startup options must be placed before the command,
                  because 4OS2 will treat characters after the command as
                  part of the command and not as additional startup
                  options.

                  When the command is preceded by a /C, 4OS2 will execute
                  the command and then exit and return to the parent
                  program or the OS/2 desktop without displaying a prompt.

                  The /K switch has no effect; using it is the same as
                  placing the command (without a /C or /K) at the end of
                  the startup command line.  It is included only for
                  compatibility with CMD.EXE.


        16-Bit and 32-Bit Versions of 4OS2

             4OS2 comes in two versions:  32-bit (4OS2/32) and 16-bit
             (4OS2/16).  If you use OS/2 version 2.1, you will find that
             4OS2/32 offers a few improvements and runs a bit faster than
             4OS2/16.  Normally, the correct version is selected for you
             automatically by the 4OS2 INSTALL program.  If you are using a
             downloaded copy of 4OS2, see the README.DOC file which came
             with your copy for details on selecting the appropriate files
             for your system.

             Once the proper version is selected during installation, you
             generally don't need to be concerned with which version you
             are using, as the two versions are almost identical.  A few
             features are available only in the 32-bit version; these are
             marked as such in the Reference Manual and on-line help.

             If necessary, you can install the 16-bit or 32-bit version
             explicitly rather than letting the installation program choose
             for you.  To do so, start the installation program (see page
             4) and select the Install 16-bit Version or Install 32-bit
             Version option.  These options install only the files which
             differ between the two versions:  4OS2.EXE, SHRALIAS.EXE,
             4OS2A.ICO, and 4OS2B.ICO.

             4OS2/16 runs under OS/2 1.21, 1.3, 2.0, and 2.1.  4OS2/32
             normally runs only under OS/2 2.1.  You can install it
             manually for OS/2 2.0 if you wish, but some features may not


        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 21
                                                  CHAPTER 3 / CONFIGURATION
        -------------------------------------------------------------------


             work properly due to problems with 32-bit support in some
             versions of OS/2 2.0.


        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
        -------------------------------------------------------------------


             case the 4OS2 directory does not need to be listed in the
             BOOKSHELF setting.

             OS/2 includes a complete reference to all internal and
             external commands in the reference book named CMDREF.  This
             book is stored in the file \OS2\BOOK\CMDREF.INF.  4OS2
             normally passes the help file name "4OS2+CMDREF" to VIEW, so
             that VIEW opens both the 4OS2 help text and the OS/2 command
             reference.

             You can specify a different set of "books" to be opened when
             HELP or F1 is invoked.  To do so, use the HelpBook directive
             in 4OS2.INI.  For example, to set up 4OS2 so that only 4OS2
             help is displayed (without the CMDREF book) when F1 is
             pressed, you would include the following directive in
             4OS2.INI:

                  HelpBook=4OS2

             When more than one book is listed in the HelpBook setting,
             VIEW will see the combined group as a single book.  The Table
             of Contents displayed by VIEW will include the tables of
             contents from all the listed books, concatenated together as
             one group of topics with no divisions to show where one book
             ends and the next begins.

             If you wish, you can set up a separate object for 4OS2 help
             which can be invoked from your desktop.  To do so, create an
             object with VIEW.EXE as the program name and 4OS2 in the
             parameter field (or use 4OS2+CMDREF to show both books when
             the object is selected).

             4OS2 also supports the /? switch to display help for any
             command.  For more information on /? see the Command Line Help
             topic in Chapter 3 of your Reference Manual.  For information
             on the 4OS2H.MSG file, which contains the /? help text, see
             page 8 of this manual.

             4OS2 can also be used to obtain help on OS/2 error codes.  If
             you type either of these commands:

                  [c:\] help nnnn
                  [c:\] help sysnnnn

             where "nnnn" is an OS/2 system error number, HELP will display
             an explanation of the OS/2 error.  This feature works by
             running the OS/2 program HELPMSG.EXE which opens the file
             OSO001.H to get the explanation.  For this feature to work,
             HELPMSG.EXE must be in a directory that is in your PATH, and
             the data file OSO001H.MSG must be in a directory in your DPATH

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 23
                                                  CHAPTER 3 / CONFIGURATION
        -------------------------------------------------------------------


             (OS/2 sets up HELPMSG.EXE and OS0001H.MSG this way by
             default).

             You can also use the 4OS2 HELP command to change the PROMPT
             setting.  HELP ON will change the default prompt to $i[$p],
             and HELP OFF will change the default prompt to [$p].  This
             feature is included for compatibility with OS/2's CMD.EXE, and
             is implemented by running the HELP.CMD file which comes with
             OS/2 (typically stored in the \OS2 directory).  Changing the
             prompt is probably better accomplished by using the PROMPT
             command instead of HELP ON or HELP OFF.


        Using 4START and 4EXIT

             4OS2 executes two batch files automatically:  4START is run
             whenever 4OS2 starts, and 4EXIT is run whenever 4OS2 exits.
             4START and 4EXIT can be either .CMD or .BTM files.

             If you create 4START.BTM and 4EXIT.BTM files, you can use them
             for both 4OS2 and 4DOS.  Use the IFF command and the %_DOS
             internal variable to separate commands which should be
             executed under only one operating system.

             If you prefer to use different files for 4OS2 and 4DOS, you
             can use 4START.CMD for 4OS2 and 4START.BAT for 4DOS.  You
             could name your 4EXIT files similarly.  You can also keep the
             4START and 4EXIT files separate by placing the files for 4OS2
             in the 4OS2 directory and the files for 4DOS in the 4DOS
             directory.

             If 4OS2 is started as a secondary shell with the [/C] command
             option, 4START is executed before the command.

             See your Reference Manual for more information on 4START and
             4EXIT.

             If you prefer, you can create a file with a name other than
             4START (for example, STARTOS2.CMD) and put its name in the
             Parameters field for any 4OS2 object (see page 18).  Doing so
             has two advantages.  The file will only be started when a
             primary 4OS2 shell is started, not under a secondary shell or
             under 4DOS.  Also, you can then use different startup files
             for different 4OS2 sessions.

             For example, you might create a file called STARTFS.CMD which
             executes commands for a full-screen session, and another file
             STARTWIN.CMD which executes different commands for a windowed
             session.  You could then set up two objects with these
             settings:

        -------------------------------------------------------------------
        Copr. 1995 JP Software Inc.   4OS2 Intro. & Installation Guide / 24
                                                  CHAPTER 3 / CONFIGURATION
        -------------------------------------------------------------------


                  Path and file name: *
                  Parameters:         D:\STARTFS.CMD
                  Working directory:  C:\

                  Path and file name: *
                  Parameters:         D:\STARTWIN.CMD
                  Working directory:  C:\

             The first object should be configured as an OS/2 Full Screen
             session and the second as an OS/2 Windowed session.


        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
        -------------------------------------------------------------------


        Index                               Desktop objects, 10
                                                configuring, 15
                                                creating, 15
        4DOS, and 4OS2 installation, 5          for 4OS2, 18
        4EXIT, 24                               in OS/2 1.x, 15
            and 4DOS, 24                        in OS/2 2.x, 16
        4OS2                                    properties, 15
            16-bit and 32-bit versions,     Directories, for 4OS2 files, 8
              21                            Directory history list, local
            desktop objects, 18               and global, 20
            sessions, 18                    DOS
        4OS2.EXE, location of, 8                applications, 14
        4OS2.INF, location of, 8                sessions, 12
        4OS2.INI
            directives, on startup          Extended attributes, 17
              command line, 20
            location of, 18, 20             Family mode applications, see
            reference information, 2          Bound applications
        4OS2H.MSG, location of, 8           Full-screen sessions, 11
        4START, 24
            and 4DOS, 24                    General concepts, 10
            and startup command, 21         Guided tour, 1, 6

        Alias list, local and global,       Help system, 2, 22
          20                                    /? option, 23
        Applications                            and OS/2 command reference,
            starting, 14                          23
            types of, 13                        location of files, 8, 22
                                                selecting books to view, 23
        Batch files, startup, 19
        BOOKSHELF, see Help system          .INI file, see 4OS2.INI
        Bound applications, 14              Installation, 4
                                                automated, 5
        Character mode                          directory for, 4
            applications, 14                    manual, 6
            sessions, 11                            for OS/2 version 1.x, 7
        Command history list, local and             for OS/2 version 2.x, 7
          global, 20                            of downloaded updates, 4, 6
        Commands                                reversing, 9
            4OS2 startup, 19, 21                stopping, 6
            help on, 22
            reference information, 2        Local and global aliases and
        CONFIG.SYS, 18                        histories, 20
            and installation, 4, 6
            PROTSHELL line, 7, 9            Native DOS sessions, 12
            SET COMSPEC line, 7, 9
            SET OS2_SHELL line, 7, 9        Objects, see Desktop objects
        Configuration, 18                   Options, see Startup Options



        -------------------------------------------------------------------
        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
