home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / 4os2b.zip / 4OS2.DOC next >
Text File  |  1993-12-16  |  82KB  |  1,702 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                        44
  9.                       44
  10.                      44        OOOOO        SSSSSS      222222
  11.                     44        OOOOOOO      SSSSSSSS    22222222
  12.                    44  44    OO     OO    SS           22     22
  13.                   44   44    OO     OO    SS                  22
  14.                  44    44    OO     OO     SSSSSS           222
  15.                 444444444    OO     OO      SSSSSS        222
  16.                  44444444    OO     OO           SS     222
  17.                        44    OO     OO           SS    22
  18.                        44     OOOOOOO     SSSSSSSS     22222222
  19.                        44      OOOOO       SSSSSS      222222222
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                     Version 2.0
  27.  
  28.  
  29.  
  30.  
  31.                         Introduction and Installation Guide
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                                    Developed By
  38.                               Rex Conn and Tom Rawson
  39.  
  40.                                  Documentation By
  41.                      Hardin Brothers, Tom Rawson, and Rex Conn
  42.  
  43.  
  44.  
  45.                                    Published By
  46.  
  47.                                  JP Software Inc.
  48.                                    P.O. Box 1470
  49.                              East Arlington, MA 02174
  50.                                       U.S.A.
  51.  
  52.                                   (617) 646-3975
  53.                                 fax (617) 646-0904
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                   ACKNOWLEDGMENTS
  60.  
  61.  
  62.              We couldn't produce a product like 4OS2 without the dedication
  63.              and quality work of many people.  Our thanks to:
  64.  
  65.                   JP Software Staff:  Mike Bessy, Helen Coyne, Ellen Stone,
  66.                   Marcella Turner, Misty White.
  67.  
  68.                   Beta Test Support:  David Moskowitz, Guy Scharf, and
  69.                   Martin Schiff, of CompuServe's CONSULT forum.
  70.  
  71.                   Online Support:  Brian Miller and Tess Heder of Channel 1
  72.                   BBS; Don Watkins of CompuServe's IBMNET.
  73.  
  74.                   Beta Testers:  We can't list all of our beta testers
  75.                   here.  A special thanks to all of you who helped make
  76.                   4OS2 elegant, reliable, and friendly!
  77.  
  78.                   SHRALIAS Program:  Bill Hinkle.
  79.  
  80.  
  81.  
  82.              The following tools are used in creating and maintaining 4OS2:
  83.  
  84.                   Compilers:       IBM C-Set/2, Microsoft C, Microsoft
  85.                                    Macro Assembler
  86.                   Libraries:       Spontaneous Assembly (Base Two
  87.                                    Development)
  88.                   Editors:         Edix (Emerging Technology), Brief
  89.                                    (Solution Systems)
  90.                   Debuggers:       IPMD (IBM)
  91.                   Version Control: PVCS (Sage Software)
  92.                   Documentation:   Microsoft Word for Windows with Adobe
  93.                                    Type Manager
  94.  
  95.  
  96.  
  97.  
  98.  
  99.              Copyright 1993, JP Software Inc., All Rights Reserved.  4DOS
  100.              is a registered trademark and 4OS2, JP Software, and the JP
  101.              Software logo and product logos are trademarks of JP Software
  102.              Inc.  Other product and company names are trademarks of their
  103.              respective owners.
  104.  
  105.                                                                       11-93
  106.  
  107.                                                                    Contents
  108.         -------------------------------------------------------------------
  109.  
  110.  
  111.         Contents
  112.  
  113.  
  114.         Introduction...............................................1
  115.             How to Use This Manual.................................2
  116.             Customer Service and Technical Support.................3
  117.  
  118.         Chapter 1 / Installation...................................4
  119.             Automated Installation.................................5
  120.             Manual Installation....................................6
  121.                 Manual Installation for OS/2 Version 1.x...........7
  122.                 Manual Installation for OS/2 Version 2.x...........7
  123.                 4OS2 Files and Directories.........................8
  124.             Uninstalling 4OS2......................................9
  125.  
  126.         Chapter 2 / General Concepts..............................10
  127.             Terminology...........................................10
  128.             OS/2 Sessions and Applications........................11
  129.                 Sessions and Session Types........................11
  130.                 Applications and Application Types................13
  131.                 Starting Sessions and Applications................14
  132.             Creating and Configuring Desktop Objects..............15
  133.                 OS/2 Version 1.x Objects..........................15
  134.                 OS/2 Version 2.x Objects..........................16
  135.             Extended Attributes...................................17
  136.  
  137.         Chapter 3 / Configuration.................................18
  138.             Creating and Configuring 4OS2 Objects.................18
  139.             4OS2 Command Line Options.............................19
  140.             16-Bit and 32-Bit Versions of 4OS2....................21
  141.             4OS2 Help.............................................22
  142.             Using 4START and 4EXIT................................24
  143.             Using STARTUP.CMD.....................................25
  144.  
  145.         Index.....................................................26
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.         -------------------------------------------------------------------
  162.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / i
  163.  
  164.                                                                INTRODUCTION
  165.         -------------------------------------------------------------------
  166.  
  167.  
  168.         INTRODUCTION
  169.  
  170.  
  171.         Welcome, and thanks for purchasing 4OS2!
  172.  
  173.         We developed 4OS2 to bring the power and convenience of our popular
  174.         4DOS program to users of the OS/2 operating system.  Whether you
  175.         are a computer novice or an experienced user, 4OS2 will help you
  176.         get the most out of your OS/2 system.
  177.  
  178.         Technically, 4OS2 is a command interpreter or "Shell."  That means
  179.         that it reacts to the commands you type at the [C:\] prompt.  It
  180.         replaces CMD.EXE, the default command interpreter that is supplied
  181.         with OS/2.  4OS2 offers hundreds of enhancements, yet retains full
  182.         compatibility with CMD.EXE commands and batch files.
  183.  
  184.         If you are familiar with 4DOS or with the OS/2 command prompt, you
  185.         won't have to change your computing habits or unlearn anything to
  186.         use 4OS2.  If you know how to use commands to display a directory,
  187.         copy a file, or start an application program, you already know how
  188.         to use 4OS2.  And if you are a 4DOS user, you already know how to
  189.         use most of the advanced features that we have built into 4OS2.
  190.         You can even use many of your 4DOS batch files with 4OS2 (see
  191.         Chapter 3 of the Reference Manual, or the Batch Files topic in the
  192.         online help, for tips about making batch files work properly in
  193.         both environments).
  194.  
  195.         Once you have 4OS2 installed, you can learn its new features at
  196.         your own pace.  Relax, enjoy 4OS2's power, and browse through the
  197.         manuals occasionally.  Press the F1 key whenever you need help.
  198.         4OS2 will soon become an essential part of your computer, and
  199.         you'll wonder how you ever got along without it.
  200.  
  201.         If you want to take 4OS2 for a spin without performing a complete
  202.         installation, see the separate Guided Tour documentation.
  203.  
  204.         This version of 4OS2 is designed for OS/2 versions 1.21, 1.3, 2.0,
  205.         and 2.1.  You must have one of these versions of OS/2 operating on
  206.         your computer to install and use 4OS2.  Throughout this manual, we
  207.         refer to versions 1.21, and 1.3 as "version 1.x," and versions 2.0
  208.         and 2.1 as "version 2.x."
  209.  
  210.         We are constantly working to improve 4OS2.  If you have suggestions
  211.         for features or commands that we should include in the next
  212.         version, or any other way we could improve our product, please let
  213.         us know.  Many of the features in this version of 4OS2 were
  214.         suggested by our users.  We can't promise to include every
  215.         suggestion, but we really do appreciate and pay attention to your
  216.         comments.
  217.  
  218.         -------------------------------------------------------------------
  219.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 1
  220.  
  221.                                                                INTRODUCTION
  222.         -------------------------------------------------------------------
  223.  
  224.  
  225.  
  226.         How to Use This Manual
  227.  
  228.              This manual is only one part of the documentation that you
  229.              will need for 4OS2.  It introduces the product and will help
  230.              you install 4OS2 correctly on your computer.  It will also
  231.              help you understand some of the terms and concepts that you
  232.              will need to know to get the most from 4OS2.
  233.  
  234.              The second part of our documentation is the separate Reference
  235.              Manual.  It contains complete information about the commands
  236.              and features of 4OS2, plus its sister programs, 4DOS and 4DOS
  237.              for Windows NT.
  238.  
  239.              You should start with this introductory manual whether you are
  240.              new to 4OS2 or you are upgrading from a previous version.
  241.              Once you have successfully installed 4OS2, you can move back
  242.              and forth between this manual and the Reference Manual.
  243.  
  244.              For the sake of clarity, we have chosen not to indicate each
  245.              of the dozens of places in this manual where you can refer to
  246.              the Reference Manual for additional information.  If you see a
  247.              reference here to a 4OS2 command, the initialization file
  248.              4OS2.INI, or any 4OS2 feature, you can be sure that detailed
  249.              information on that topic is available in the Reference
  250.              Manual.
  251.  
  252.              4OS2 also includes complete online help for all of its built-
  253.              in commands.  The online help provides much of the same
  254.              information that is in the Reference Manual, but in an
  255.              electronic form which you can access quickly.  See page 22 for
  256.              more details on using the online help.
  257.  
  258.              Files distributed with 4OS2 cover important additional
  259.              information beyond what's included in the manuals.  README.DOC
  260.              contains general notes, highlights of the latest release, and
  261.              brief installation instructions for those upgrading from a
  262.              downloaded copy.  MANMOD.DOC covers changes or corrections in
  263.              the manuals, if any, and UPDATxxx.DOC contains detailed
  264.              information for users with older versions on what has changed
  265.              in the latest release ("xxx" is the version number).
  266.  
  267.              You will likely find some parts of the documentation too
  268.              simple or too technical for your tastes.  Unless you are
  269.              convinced that one of those sections holds just the
  270.              information you need for a specific task, feel free to skip to
  271.              the next part of the manual that is more to your liking.  You
  272.              can use almost every feature of 4OS2 without having to worry
  273.              about other features or commands.
  274.  
  275.         -------------------------------------------------------------------
  276.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 2
  277.  
  278.                                                                INTRODUCTION
  279.         -------------------------------------------------------------------
  280.  
  281.         Customer Service and Technical Support
  282.  
  283.              Technical support for 4OS2 is available via public electronic
  284.              support conferences, private electronic mail, telephone, fax,
  285.              and mail.  For complete details, including a listing of
  286.              electronic support conferences, see your Reference Manual.
  287.  
  288.              Customer service is always available through the telephone and
  289.              fax numbers listed on the title page of this manual.  See your
  290.              Reference Manual for electronic mail addresses for our Sales
  291.              and Customer Service departments.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.         -------------------------------------------------------------------
  333.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 3
  334.  
  335.                                                    CHAPTER 1 / INSTALLATION
  336.         -------------------------------------------------------------------
  337.  
  338.  
  339.         CHAPTER 1 / INSTALLATION
  340.  
  341.  
  342.         You can install your copy of 4OS2 automatically or manually.
  343.  
  344.         If you prefer an automated installation, our installation software
  345.         will set up 4OS2 for you quickly and with very little intervention
  346.         on your part, other than answering the questions on your screen.
  347.  
  348.         If you prefer to install 4OS2 yourself, you'll need to use the
  349.         installation software to copy the 4OS2 files to your disk.  You can
  350.         then modify your system manually as explained below.
  351.  
  352.         If you're installing a downloaded copy of 4OS2, see the
  353.         instructions under Manual Installation on page 6.
  354.  
  355.         No matter which method you choose, you'll find that 4OS2's
  356.         installation software is very well-behaved.  It won't modify or
  357.         erase any existing files, including CONFIG.SYS, without asking you,
  358.         and it takes a very straightforward, step-by-step approach.
  359.  
  360.         The installation software always prompts you for the directory to
  361.         use for your 4OS2 files, and will create a new directory if
  362.         necessary.  If you are upgrading from a previous version of 4OS2,
  363.         use a new directory for the new version, rather than overwriting
  364.         your existing files.  Transfer any necessary configuration files
  365.         from the old directory (e.g. 4OS2.INI, 4START, etc.), then remove
  366.         the old directory once the new version is up and running.
  367.  
  368.         Before you install 4OS2 (or any other software, for that matter),
  369.         you should verify that you have a bootable system diskette so you
  370.         can recover in case of a power failure or other interruption during
  371.         the installation process.  Such problems are rare under OS/2, but
  372.         having a bootable system disk is a wise precaution in any case.
  373.         Your OS/2 installation disks can be used for this purpose.
  374.  
  375.         Once you have 4OS2 installed, the standard "OS/2 Window" and "OS/2
  376.         Full Screen" selections in your Command Prompts folder (OS/2
  377.         version 2.x) or Group-Main window (OS/2 version 1.x) will normally
  378.         start 4OS2 instead of CMD.EXE.  You may wish to change the names of
  379.         these selections to "4OS2 Window" and "4OS2 Full Screen".
  380.  
  381.         If you have a STARTUP.CMD batch file, it will run just as it did
  382.         before you installed 4OS2.  OS/2 will create a 4OS2 session at boot
  383.         time and pass the STARTUP.CMD command to that session, just as it
  384.         did with CMD.EXE.  See page 25 for more information on STARTUP.CMD.
  385.  
  386.         Your copy of 4OS2 includes both 32-bit and 16-bit versions.  The
  387.         versions are described in detail on page 21.  The 4OS2 INSTALL
  388.  
  389.         -------------------------------------------------------------------
  390.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 4
  391.  
  392.                                                    CHAPTER 1 / INSTALLATION
  393.         -------------------------------------------------------------------
  394.  
  395.         program automatically determines the correct version for your
  396.         system, based on the version of OS/2 you are running.  During
  397.         installation, you may notice that INSTALL displays a few file names
  398.         specific to the particular version being installed (for example
  399.         4OS2-32.EXE or SHRALS16.EXE).  These are the names of the files as
  400.         they are stored on the distribution disk.  The files are renamed
  401.         automatically by INSTALL, and will have "version-independent" names
  402.         (for example 4OS2.EXE or SHRALIAS.EXE) once they are installed on
  403.         your hard disk.
  404.  
  405.         If you also have our DOS command processor, 4DOS, do not install
  406.         4OS2 in the same directory as 4DOS.  Some file names (for example
  407.         README.DOC) are the same in both products, and the files should be
  408.         kept separate to avoid confusion.
  409.  
  410.         For information about creating additional 4OS2 objects, configuring
  411.         4OS2, and setting up startup batch files for specific 4OS2
  412.         sessions, see pages 15 and 18.
  413.  
  414.  
  415.         Automated Installation
  416.  
  417.              To begin the automated installation process, open an OS/2
  418.              windowed or full-screen session and put the distribution
  419.              diskette in drive A.  (You can use drive B if you prefer, in
  420.              which case you should substitute "b" for "a" in the
  421.              instructions below.)
  422.  
  423.              One of the files on the distribution diskette, README.1ST,
  424.              contains information that you should read before you install
  425.              4OS2 on your computer.  Type:
  426.  
  427.                   type a:readme.1st | more
  428.  
  429.              to view the file.  If you want to print a copy of the file,
  430.              type:
  431.  
  432.                   copy a:readme.1st prn
  433.  
  434.              After checking README.1ST, you can start the installation
  435.              process.  Type:
  436.  
  437.                   a:install
  438.  
  439.              and press the Enter key.
  440.  
  441.              Once the installation program has started, just follow the
  442.              instructions on the screen and 4OS2 will install itself on
  443.              your system.
  444.  
  445.  
  446.         -------------------------------------------------------------------
  447.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 5
  448.  
  449.                                                    CHAPTER 1 / INSTALLATION
  450.         -------------------------------------------------------------------
  451.  
  452.              The installation program will ask whether you want to perform
  453.              a full installation, extract all the 4OS2 files in order to
  454.              run the Guided Tour, or retrieve individual files from the
  455.              4OS2 library.  Choose a full installation to install 4OS2 on
  456.              your system and modify CONFIG.SYS (you will be prompted for
  457.              permission before CONFIG.SYS is modified).  Choose the Extract
  458.              All Files / Tour option if you want to run the Guided Tour and
  459.              see what 4OS2 can do before you install it permanently (see
  460.              the separate Guided Tour booklet).
  461.  
  462.              If you elect to perform a full installation, shut down OS/2
  463.              and reboot your computer when the installation program is
  464.              done.  You will then have all the power of 4OS2 available to
  465.              you.
  466.  
  467.              You can halt the installation process at any time by pressing
  468.              Ctrl-X (hold down the Ctrl key and then press "X").
  469.  
  470.  
  471.         Manual Installation
  472.  
  473.              The 4OS2 files are contained in a special library file on the
  474.              distribution diskette.  You cannot simply copy the files from
  475.              the diskette onto your system.  You must use the installation
  476.              program to extract and decompress the 4OS2 files if you want
  477.              to perform a manual installation, or if you need to replace a
  478.              damaged 4OS2 file on your hard disk.
  479.  
  480.              If you want to install 4OS2 manually, first start the
  481.              automatic installation program using the instructions above.
  482.              Select the Extract all files option and extract the 4OS2 files
  483.              onto your hard disk (be sure to place the files in their own
  484.              directory).
  485.  
  486.              If you're installing a downloaded copy of 4OS2, you will not
  487.              have an INSTALL program.  Instead, use the appropriate
  488.              decompression program (for example, PKUNZIP) to extract the
  489.              files from your download into a new directory.  Then follow
  490.              the instructions below to complete your installation.  If you
  491.              are updating from a previous version, check the README.DOC
  492.              file for update instructions.
  493.  
  494.              Once you've extracted the files, you can go through the Guided
  495.              Tour if you want to try 4OS2 before completing the
  496.              installation (see the separate Guided Tour documentation).
  497.              When you run the tour, the HELP command and F1 key, along with
  498.              the /? option for 4OS2 commands, may not work if the required
  499.              files are not accessible.  You can activate these features
  500.              during the tour by following the instructions for 4OS2.INF and
  501.              4OS2H.MSG in the 4OS2 Files and Directories section below.
  502.  
  503.         -------------------------------------------------------------------
  504.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 6
  505.  
  506.                                                    CHAPTER 1 / INSTALLATION
  507.         -------------------------------------------------------------------
  508.  
  509.              When you're ready to finish the installation process, follow
  510.              the instructions in the appropriate sections below.  Once you
  511.              have modified CONFIG.SYS and rebooted, your standard "OS/2
  512.              Full-Screen" and "OS/2 Windowed" desktop objects can normally
  513.              be used to start 4OS2.
  514.  
  515.  
  516.              Manual Installation for OS/2 Version 1.x
  517.  
  518.              Use an ASCII-format editor (like the OS/2 System Editor) to
  519.              edit your OS/2 CONFIG.SYS file.  In the file, you will find a
  520.              line that begins with the word PROTSHELL and another that
  521.              begins with the words SET COMSPEC.  The lines should look like
  522.              this, but they may not be adjacent in the file (the PROTSHELL
  523.              command is all on one line):
  524.  
  525.                   PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI
  526.                        C:\OS2\OS2SYS.INI C:\OS2\CMD.EXE
  527.                   SET COMSPEC=C:\OS2\CMD.EXE
  528.  
  529.              Change the last item on the PROTSHELL line, the item that
  530.              includes the filename CMD.EXE, to point to 4OS2.EXE.  Be sure
  531.              to include the full path for the directory where you installed
  532.              4OS2.EXE.  The changed PROTSHELL line should look like this
  533.              (it should all be on one line):
  534.  
  535.                   PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI
  536.                        C:\OS2\OS2SYS.INI C:\4OS2\4OS2.EXE
  537.  
  538.              Do not change PMSHELL.EXE to 4OS2.EXE.  Change only the name
  539.              and path of CMD.EXE.
  540.  
  541.              Now change the SET COMSPEC line so that it also contains the
  542.              full path of 4OS2.EXE.  The completed line should look like
  543.              this:
  544.  
  545.                   SET COMSPEC=C:\4OS2\4OS2.EXE
  546.  
  547.              Verify that the changes have been made correctly and then save
  548.              the CONFIG.SYS file.  Exit from your editor, shut down OS/2,
  549.              and reboot your system.
  550.  
  551.  
  552.              Manual Installation for OS/2 Version 2.x
  553.  
  554.              Use an ASCII-format editor (like the OS/2 System Editor) to
  555.              edit your OS/2 CONFIG.SYS file.  In the file, you will find a
  556.              line that begins with the words SET OS2_SHELL and another that
  557.              begins with the words SET COMSPEC.  The lines should look like
  558.              this, but they may not be adjacent in the file:
  559.  
  560.         -------------------------------------------------------------------
  561.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 7
  562.  
  563.                                                    CHAPTER 1 / INSTALLATION
  564.         -------------------------------------------------------------------
  565.  
  566.                   SET OS2_SHELL=D:\OS2\CMD.EXE
  567.                   SET COMSPEC=D:\OS2\CMD.EXE
  568.  
  569.              Change both of these lines so that they to point to 4OS2.EXE,
  570.              instead of to the CMD.EXE file.  Be sure to enter the correct
  571.              path for the directory where you installed 4OS2.  When you are
  572.              done, the lines should look like this:
  573.  
  574.                   SET OS2_SHELL=C:\4OS2\4OS2.EXE
  575.                   SET COMSPEC=C:\4OS2\4OS2.EXE
  576.  
  577.              Verify that the changes have been made correctly and then save
  578.              the CONFIG.SYS file.  Exit from your editor, shut down OS/2,
  579.              and reboot your system.
  580.  
  581.  
  582.              4OS2 Files and Directories
  583.  
  584.              The automated installation procedure places all 4OS2 files in
  585.              a single directory.  You may move the files to different
  586.              directories if you wish, but you must make sure that the files
  587.              can be found by the programs that need to use them.  The
  588.              following information will help you set up your system
  589.              correctly if you are performing a manual installation:
  590.  
  591.                   4OS2.EXE is the 4OS2 program file.  It must be in the
  592.                   directory specified in the PROTSHELL (OS/2 version 1.x),
  593.                   SET OS2_SHELL (OS/2 version 2.x), and SET COMSPEC lines
  594.                   in your CONFIG.SYS file as explained above.
  595.  
  596.                   4OS2.INF contains the text for the 4OS2 HELP command and
  597.                   F1 key.  For HELP to work properly, the directory
  598.                   containing this file must be included in the BOOKSHELF
  599.                   environment variable, which is usually set with a SET
  600.                   BOOKSHELF command in CONFIG.SYS.  If you prefer, you can
  601.                   move this file into the standard OS/2 bookshelf
  602.                   directory, \OS2\BOOK.
  603.  
  604.                   4OS2H.MSG contains the help text for the /? option that
  605.                   is available as part of each 4OS2 internal command.  For
  606.                   this feature to work properly, the directory containing
  607.                   this file must be included in the DPATH environment
  608.                   variable, which is usually set with a SET DPATH command
  609.                   in CONFIG.SYS.  If you prefer, you can move this file
  610.                   into the standard OS/2 directory for such files,
  611.                   \OS2\SYSTEM.
  612.  
  613.                   SHRALIAS.EXE is a small utility that saves the shared
  614.                   alias and history list between 4OS2 sessions.  The
  615.                   directory containing this file should be listed in your
  616.  
  617.         -------------------------------------------------------------------
  618.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 8
  619.  
  620.                                                    CHAPTER 1 / INSTALLATION
  621.         -------------------------------------------------------------------
  622.  
  623.                   PATH statement.  If it is not, you will have to specify
  624.                   the full path name to load SHRALIAS.EXE each time you
  625.                   want to use it.
  626.  
  627.  
  628.         Uninstalling 4OS2
  629.  
  630.              We don't expect you to have any trouble using 4OS2, but we
  631.              know some people feel more comfortable knowing how to
  632.              uninstall a product as well as install it.  Or, you may need
  633.              to remove 4OS2 from one system to move it to another system.
  634.  
  635.              To temporarily remove 4OS2 from your system, use an ASCII
  636.              editor to edit your OS/2 CONFIG.SYS file.  You will need to
  637.              edit both the SET COMSPEC line (all versions of OS/2) and
  638.              either the PROTSHELL line (OS/2 version 1.x) or SET OS2_SHELL
  639.              line (OS/2 version 2.x).  In all cases, change the reference
  640.              to 4OS2.EXE to the complete path and filename of CMD.EXE.
  641.  
  642.              Save the file, exit from your editor, shut down OS/2 and
  643.              reboot your system.  You should be back up and running under
  644.              CMD.EXE.  To switch back to 4OS2, edit CONFIG.SYS again to
  645.              restore the 4OS2 lines as described above, and shut down and
  646.              reboot.
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.         -------------------------------------------------------------------
  675.         Copr. 1993 JP Software Inc.    4OS2 Intro. & Installation Guide / 9
  676.  
  677.                                                CHAPTER 2 / GENERAL CONCEPTS
  678.         -------------------------------------------------------------------
  679.  
  680.  
  681.         CHAPTER 2 / GENERAL CONCEPTS
  682.  
  683.  
  684.         This chapter contains information about OS/2 and 4OS2.  Some of the
  685.         information is general and introductory in nature; other parts of
  686.         this chapter are fairly detailed and technical.  We encourage you
  687.         to at least scan through this chapter to see what is here and to
  688.         study the sections that appear to have relevance to your work with
  689.         4OS2 and OS/2.
  690.  
  691.         Technical experts will recognize that some explanations are not
  692.         complete (for example, this chapter does not explore the
  693.         distinction between sessions and screen groups), but they should
  694.         serve as a useful introduction for many users.
  695.  
  696.  
  697.         Terminology
  698.  
  699.              Throughout this manual, the term "desktop" refers to the
  700.              Presentation Manager in OS/2 version 1.x or the Workplace
  701.              Shell in OS/2 version 2.x.
  702.  
  703.              The term "object" refers to a selectable item on your desktop,
  704.              whether or not the corresponding icon is actually visible (you
  705.              may have chosen to configure the desktop with only session
  706.              names visible, rather than the icons themselves).  For
  707.              example, the standard desktop for all versions of OS/2
  708.              includes objects titled "OS/2 Window" and "OS/2 Full Screen,"
  709.              typically kept in the Main group (OS/2 1.x) or the Command
  710.              Prompts folder (OS/2 2.x).
  711.  
  712.              The term "session" refers to the OS/2 session created by
  713.              selecting an object on the desktop.  Sessions run a program or
  714.              sequence of programs.  See below for more information on
  715.              sessions and session types.  When you double-click on an
  716.              object or select it with the keyboard and press Enter, a new
  717.              session is started (or, for Presentation Manager programs, the
  718.              program is started in the PM session).
  719.  
  720.              The term "process" refers to a single invocation of a
  721.              particular program within a session.  Many sessions run only a
  722.              single process.  However, multiple processes can run
  723.              simultaneously within the same session.  For example, in a
  724.              4OS2 session which is running a character-mode text editor,
  725.              two processes are running:  4OS2 and the text editor.
  726.  
  727.  
  728.  
  729.  
  730.  
  731.         -------------------------------------------------------------------
  732.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 10
  733.  
  734.                                                CHAPTER 2 / GENERAL CONCEPTS
  735.         -------------------------------------------------------------------
  736.  
  737.         OS/2 Sessions and Applications
  738.  
  739.              OS/2 supports several different types of applications and many
  740.              methods for starting them.  Most of the time, you don't need
  741.              to worry about these differences because 4OS2 and OS/2
  742.              cooperate to take care of them for you.  You may, however,
  743.              find this general discussion of applications and sessions
  744.              useful to understand what happens when you run an application
  745.              or other external program.  If you need more details, see the
  746.              OS/2 online reference information.
  747.  
  748.  
  749.              Sessions and Session Types
  750.  
  751.              OS/2 programs are run in "sessions" which are programs or
  752.              groups of programs whose output typically appears in specific
  753.              windowed display areas on the desktop ("windowed" sessions) or
  754.              takes up the whole screen ("full-screen" sessions).
  755.  
  756.              A windowed session runs on the desktop in a graphical window
  757.              whose size you (or an OS/2 application) can change.  As a
  758.              result, portions of the session's display area may be covered
  759.              or invisible at any given time.  The "active" session, or the
  760.              session that receives keystrokes, is always shown with a
  761.              highlighted title bar at the top of its window.
  762.  
  763.              Full-screen sessions run on a standard text mode display,
  764.              generally 80 characters by 25 or 50 lines.  When such a
  765.              session is active, its full display area is visible and it
  766.              hides all other sessions and the desktop itself.  You can
  767.              press Alt-Esc to switch back to the desktop from a full-screen
  768.              session.
  769.  
  770.              OS/2 supports ten different types of sessions:
  771.  
  772.                   OS/2 Presentation Manager (PM) session:  There is a
  773.                   single PM session which starts when you start OS/2.  This
  774.                   session runs in graphics mode on the desktop.  All OS/2
  775.                   Presentation Manager applications run within this single
  776.                   PM session (though for practical purposes they may appear
  777.                   to be running in separate sessions, since each
  778.                   application has its own window).  Their output is
  779.                   graphical and may include pictures and a variety of fonts
  780.                   within the same window.  Examples of applications that
  781.                   run in the PM session include the OS/2 help file viewer
  782.                   (VIEW.EXE), and the OS/2 System Editor (E.EXE).
  783.  
  784.                   OS/2 character mode, full-screen session:  This session
  785.                   type displays only text in character mode, like a
  786.                   standard DOS application.  It uses the entire screen,
  787.  
  788.         -------------------------------------------------------------------
  789.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 11
  790.  
  791.                                                CHAPTER 2 / GENERAL CONCEPTS
  792.         -------------------------------------------------------------------
  793.  
  794.                   typically in standard 80 x 25 text mode.  Examples
  795.                   include a 4OS2 or CMD.EXE full-screen session.
  796.  
  797.                   OS/2 character mode, windowed session:  This session type
  798.                   is just like the character mode full-screen session
  799.                   except that it runs in a window.  It uses the same text
  800.                   font over the entire window and does not display
  801.                   graphics.  Examples include a 4OS2 or CMD.EXE windowed
  802.                   session.
  803.  
  804.                   DOS full-screen session:  A DOS session runs DOS within
  805.                   OS/2.  A special version of DOS, designed to run in such
  806.                   a session, is supplied with OS/2 and is generally
  807.                   compatible with MS-DOS 4.0 (in OS/2 version 1.x) or MS-
  808.                   DOS 5.0 (in OS/2 version 2.x).  A DOS full-screen session
  809.                   has full control of the screen (including the ability to
  810.                   switch it into graphics and non-standard text modes).  In
  811.                   OS/2 version 1.x, you can start only one DOS session,
  812.                   called the DOS Compatibility Box.  Once this session is
  813.                   started, it cannot be closed (although you can switch
  814.                   back to the desktop with Alt-Esc).  In OS/2 version 2.x,
  815.                   you can start many such sessions, which are called
  816.                   Virtual DOS Machines (VDMs).  VDMs can be terminated with
  817.                   the EXIT command.  You can switch a full-screen DOS
  818.                   session into windowed mode by pressing Alt-Home.  One
  819.                   example of a DOS full-screen session is the session
  820.                   started by the default "DOS full-screen" object which is
  821.                   installed automatically with OS/2.
  822.  
  823.                   DOS windowed session:  Available only in OS/2 version
  824.                   2.x, this session is similar to a DOS full-screen
  825.                   session, but runs in a window on the desktop.  You can
  826.                   switch a windowed DOS session into full-screen mode by
  827.                   pressing Alt-Home.  A DOS windowed session can run all
  828.                   text-mode DOS applications, and applications that display
  829.                   graphics in standard graphics video modes.
  830.  
  831.                   Native DOS full-screen session:  Native DOS sessions are
  832.                   also called Virtual Machine Boots or VMBs.  They are only
  833.                   available in OS/2 version 2.x.  They are similar to the
  834.                   DOS sessions described above, but load a specific version
  835.                   of DOS (for example, MS-DOS 3.3), rather than the version
  836.                   of DOS shipped with OS/2.  Like normal DOS sessions,
  837.                   native DOS sessions can be switched between full-screen
  838.                   and windowed mode by pressing Alt-Home.  For more
  839.                   information on native DOS sessions, see the command
  840.                   VMDISK and the topic "Starting a Specific Version of DOS"
  841.                   in the on-line Command Reference for OS/2 version 2.x.
  842.  
  843.  
  844.  
  845.         -------------------------------------------------------------------
  846.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 12
  847.  
  848.                                                CHAPTER 2 / GENERAL CONCEPTS
  849.         -------------------------------------------------------------------
  850.  
  851.                   Native DOS windowed session:  This session is similar to
  852.                   a native DOS full-screen session, but it runs in a window
  853.                   on the desktop instead of in full-screen mode.
  854.  
  855.                   Windows full-screen session:  This session type is
  856.                   available only in OS/2 version 2.x.  A Windows full-
  857.                   screen session is essentially a DOS full-screen session
  858.                   that is running the special version of Microsoft Windows
  859.                   that is supplied with OS/2 version 2.x (or running your
  860.                   original Microsoft Windows 3.1, if you have IBM's "OS/2
  861.                   for Windows" product).  It has the standard Windows
  862.                   display, the Program Manager and Control Panel, etc., and
  863.                   can run virtually all Windows applications.
  864.  
  865.                   WIN-OS/2 full-screen session:  This session type is
  866.                   available only in OS/2 version 2.x.  It is similar to a
  867.                   Windows full-screen session, but runs only a single
  868.                   application, without the Program Manager.  Internally, it
  869.                   starts a DOS session, tells DOS to load Windows, and
  870.                   tells Windows to load the application.
  871.  
  872.                   WIN-OS/2 windowed session:  This session type is
  873.                   available only in OS/2 version 2.x.  It allows a single
  874.                   Windows application to run in a window on the Workplace
  875.                   Shell desktop.  Internally, it loads the application just
  876.                   like a WIN-OS/2 full-screen session.  However, the window
  877.                   it opens is a graphical Presentation Manager window for
  878.                   the Windows application.  This session type is sometimes
  879.                   called a "seamless Windows" session.
  880.  
  881.  
  882.              Applications and Application Types
  883.  
  884.              OS/2 and 4OS2 support six different types of applications.
  885.              Application types are related to the type of session in which
  886.              the application can run.  They are similar to, but not the
  887.              same as, session types.  The type of an application is
  888.              determined by the programmer who creates the program.
  889.              Information about the application type is embedded in the
  890.              application itself.
  891.  
  892.              The application types are:
  893.  
  894.                   OS/2 Presentation Manager application:  Runs in the PM
  895.                   session only.  Examples include the OS/2 online help
  896.                   program VIEW.EXE and the System Editor distributed with
  897.                   OS/2.
  898.  
  899.  
  900.  
  901.  
  902.         -------------------------------------------------------------------
  903.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 13
  904.  
  905.                                                CHAPTER 2 / GENERAL CONCEPTS
  906.         -------------------------------------------------------------------
  907.  
  908.                   OS/2 character mode, full-screen application:  Runs in a
  909.                   full-screen OS/2 session only.  Applications of this type
  910.                   are rare.
  911.  
  912.                   OS/2 character mode, window-compatible application:  Runs
  913.                   in a full-screen or windowed OS/2 session.  Most OS/2
  914.                   character-mode applications -- including 4OS2 -- are in
  915.                   this category.  This and the previous type are sometimes
  916.                   called "VIO" applications.
  917.  
  918.                   DOS application:  Runs in a DOS session only.  Examples
  919.                   include all .COM and .EXE files designed to run under
  920.                   DOS, such as those for DOS communications programs and
  921.                   word processors.  Virtually all DOS application programs
  922.                   that use text displays will run in either a full-screen
  923.                   or windowed DOS session.  Some DOS applications that use
  924.                   graphics will run properly only in a full-screen DOS
  925.                   session.  4OS2 also recognizes DOS batch files with a
  926.                   .BAT extension as DOS applications.
  927.  
  928.                   "Bound application" or "Family-mode application":  Runs
  929.                   in an OS/2 or a DOS character mode session from the same
  930.                   file.  Bound applications are primarily used in compilers
  931.                   and installation programs to allow the same file to run
  932.                   under both DOS and OS/2.  The 4OS2 installation program,
  933.                   INSTALL.EXE, and batch file compression program,
  934.                   BATCOMP.EXE, are examples of bound applications.
  935.  
  936.                   Windows application:  Runs only in a Windows session.
  937.                   Examples include applications like Word for Windows and
  938.                   Quattro Pro for Windows.  Most Windows applications will
  939.                   run properly in either a Windows full-screen session, or
  940.                   a WIN-OS/2 full-screen or windowed session.
  941.  
  942.  
  943.              Starting Sessions and Applications
  944.  
  945.              Before you can start an application program, you must have a
  946.              session in which to execute it.  Every object on the OS/2
  947.              desktop represents a potential session:  if you double-click
  948.              the object, or select it and press Enter, OS/2 starts a new
  949.              session (or a new window in the PM session), using the
  950.              parameters that have been set up for that object.
  951.  
  952.              The parameters for the object may cause the session to run an
  953.              OS/2 application program, load the OS/2 command processor and
  954.              display a prompt, run a batch file that could in turn start
  955.              other sessions, or start DOS, Windows, or a Windows
  956.              application.
  957.  
  958.  
  959.         -------------------------------------------------------------------
  960.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 14
  961.  
  962.                                                CHAPTER 2 / GENERAL CONCEPTS
  963.         -------------------------------------------------------------------
  964.  
  965.              To start 4OS2, you must define an object for an OS/2 character
  966.              mode session, either full-screen or windowed.  To do so, see
  967.              Chapter 3 / Configuration (page 18) for full instructions.
  968.              Briefly, after you have installed 4OS2 and defined it as the
  969.              shell in your CONFIG.SYS file, simply place an asterisk [*] in
  970.              the field for the program name.  (If CONFIG.SYS has not yet
  971.              been set up for 4OS2, you must explicitly specify the full
  972.              path and name of 4OS2.EXE instead of using the [*].)
  973.  
  974.              Once 4OS2 has started, you can start applications or other
  975.              sessions from the 4OS2 prompt.  When you start an application,
  976.              4OS2 checks its type.  If the type is the same as that of the
  977.              session in which 4OS2 is running (i.e., if the application is
  978.              an OS/2 character-mode application), the application will run
  979.              in the same session as 4OS2.  4OS2 will wait for the
  980.              application to complete before displaying a new prompt.  This
  981.              is analogous to how applications are run in DOS.
  982.  
  983.              If the application type is different from the 4OS2 session
  984.              type, 4OS2 will start a new session to run the application,
  985.              and will wait for that session to complete before returning to
  986.              the prompt.  If the application is started from a windowed
  987.              session, 4OS2 will minimize its own window while the
  988.              application is running.  You can force 4OS2 to start a new
  989.              session and not wait for it to complete by using the START
  990.              command.
  991.  
  992.  
  993.         Creating and Configuring Desktop Objects
  994.  
  995.              This section gives you basic information which you will need
  996.              to create and configure 4OS2 and 4DOS objects on your OS/2
  997.              desktop.  For complete details on creating and configuring
  998.              objects, see your OS/2 documentation.  For details on the
  999.              appropriate properties or settings to use for 4OS2 objects see
  1000.              page 18.
  1001.  
  1002.              Throughout this section, we assume that OS/2 is running in its
  1003.              default configuration.  If you have modified the behavior of
  1004.              your mouse or desktop menus, or changed other configuration
  1005.              options, you will have to take those changes into account as
  1006.              you read the instructions below.
  1007.  
  1008.  
  1009.              OS/2 Version 1.x Objects
  1010.  
  1011.              In OS/2 1.x, objects are displayed in "groups" on the desktop.
  1012.              For example, the "OS/2 Full Screen" object normally appears in
  1013.              Group-Main.
  1014.  
  1015.  
  1016.         -------------------------------------------------------------------
  1017.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 15
  1018.  
  1019.                                                CHAPTER 2 / GENERAL CONCEPTS
  1020.         -------------------------------------------------------------------
  1021.  
  1022.              To create a new object, switch to the group where you want the
  1023.              object to appear and choose the New selection on the File
  1024.              menu.  Then follow the selections in the dialog box to adjust
  1025.              the object's properties.
  1026.  
  1027.              To adjust the properties of an existing object, first select
  1028.              it (click on the object once, or use the arrow keys on the
  1029.              keyboard), then open the File Properties menu from the menu
  1030.              bar.  From within this menu you can modify the program name,
  1031.              startup directory, command line parameters, and other
  1032.              configuration data for the object.  If you use an asterisk [*]
  1033.              in the "Program Name" field for an object which starts an OS/2
  1034.              full-screen or windowed session, that object will start the
  1035.              OS/2 command processor named at the end of the PROTSHELL line
  1036.              in CONFIG.SYS (typically 4OS2.EXE or CMD.EXE).
  1037.  
  1038.  
  1039.              OS/2 Version 2.x Objects
  1040.  
  1041.              In OS/2 version 2.x, objects may appear on the desktop itself
  1042.              or within folders.  For example, the "OS/2 Full Screen" object
  1043.              normally appears in the "Command Prompts" folder.
  1044.  
  1045.              To create a new object, switch to the folder where you want
  1046.              the object to appear and either copy an existing object (use
  1047.              the Copy or Create Another selection on the object's popup
  1048.              menu) or drag a Program Template in from the Templates folder.
  1049.              Depending on the copying method you choose, the Settings
  1050.              notebook may open automatically.
  1051.  
  1052.              To adjust the properties of an object, you must open its
  1053.              Settings notebook.  To do so, click the right mouse button in
  1054.              the object.  When the popup menu appears, click on the small
  1055.              arrow to the right of the Open selection, then again on the
  1056.              Settings selection on the submenu.
  1057.  
  1058.              Once the Settings notebook is open, use the Program page to
  1059.              modify the program name, startup directory, and command line
  1060.              parameters.  If you use an asterisk [*] in the "Program Name"
  1061.              field for an object which starts an OS/2 full-screen or
  1062.              windowed session, that object will start the OS/2 command
  1063.              processor named on the SET OS2_SHELL line in CONFIG.SYS
  1064.              (typically 4OS2.EXE or CMD.EXE).  The Session page lets you
  1065.              set the session type.  Other pages let you adjust other
  1066.              configuration data for the object.
  1067.  
  1068.              The contents of the Settings notebook will vary depending on
  1069.              the type of object and the session type set on the Session
  1070.              page.  For example, DOS and Windows sessions allow control of
  1071.              a wide variety of DOS parameters (such as available XMS and
  1072.  
  1073.         -------------------------------------------------------------------
  1074.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 16
  1075.  
  1076.                                                CHAPTER 2 / GENERAL CONCEPTS
  1077.         -------------------------------------------------------------------
  1078.  
  1079.              EMS memory, or whether DOS is loaded high) using the "DOS
  1080.              Settings" or "WIN-OS/2 Settings" button on the Session page.
  1081.              However, this button cannot be used for Presentation Manager
  1082.              or OS/2 character-mode sessions.
  1083.  
  1084.  
  1085.         Extended Attributes
  1086.  
  1087.              DOS allows a limited set of attributes for files; for example,
  1088.              a file can have Read-Only, Hidden, System, or Archive
  1089.              attributes (for more information about file attributes, see
  1090.              Chapter 1 of your Reference Manual).  OS/2 supports additional
  1091.              information about files called "Extended Attributes" or "EAs."
  1092.  
  1093.              The Extended Attributes for a file provide additional
  1094.              information which is not part of the file's actual contents.
  1095.              This information might include the icon to be displayed for
  1096.              the file on the OS/2 desktop, or the type of data contained in
  1097.              the file.
  1098.  
  1099.              OS/2 supports Extended Attributes on both FAT (DOS-compatible)
  1100.              and HPFS (High Performance File System) partitions.  EAs for
  1101.              the files on a FAT partition are stored in the file
  1102.              "EA DATA. SF" in the partition's root directory.  Like
  1103.              CMD.EXE, 4OS2 preserves a file's EAs when copying or moving
  1104.              the file, and makes the appropriate adjustments to EAs when a
  1105.              file is deleted or renamed.
  1106.  
  1107.              If you boot DOS and delete or otherwise manipulate files that
  1108.              have Extended Attributes, you can face several unexpected
  1109.              problems when you next boot under OS/2, because the EAs and
  1110.              directories will no longer be synchronized.  If you must
  1111.              manipulate files with Extended Attributes during a DOS boot,
  1112.              make sure you run OS/2's CHKDSK program the next time you boot
  1113.              OS/2.  (This problem does not occur when you manipulate files
  1114.              with 4DOS or COMMAND.COM in a standard OS/2 VDM, but it can
  1115.              occur if you copy or move files while running a specific
  1116.              version of DOS, such as MS-DOS 3.3, under OS/2.)
  1117.  
  1118.              For more information on Extended Attributes, see your OS/2
  1119.              documentation.
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.         -------------------------------------------------------------------
  1131.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 17
  1132.  
  1133.                                                   CHAPTER 3 / CONFIGURATION
  1134.         -------------------------------------------------------------------
  1135.  
  1136.  
  1137.         CHAPTER 3 / CONFIGURATION
  1138.  
  1139.  
  1140.         This chapter explains how you can tune 4OS2 to make it as efficient
  1141.         and as useful as possible in your computing environment.  Nearly
  1142.         everything in this chapter is for advanced users and those with
  1143.         unusual needs.  If 4OS2 works the way you want it to after
  1144.         installation, you can skip this chapter.  You may, however, want to
  1145.         skim this material to see what options are available.
  1146.  
  1147.         In this chapter, we assume that 4OS2 is set up as the default OS/2
  1148.         command processor in your OS/2 CONFIG.SYS file.  This is normally
  1149.         done when you install 4OS2.  See page 6 for information on making
  1150.         these changes to CONFIG.SYS manually.
  1151.  
  1152.  
  1153.         Creating and Configuring 4OS2 Objects
  1154.  
  1155.              Whether you are using OS/2 1.x or 2.x, you will typically
  1156.              start 4OS2 from an object on your OS/2 desktop.  The methods
  1157.              for creating these program objects vary depending on your
  1158.              operating system version (see page 15), but the basic
  1159.              characteristics of your 4OS2 objects are the same regardless
  1160.              of which version you use.
  1161.  
  1162.              You can create as many 4OS2 objects as you wish on the OS/2
  1163.              desktop.  Different objects can be used to start 4OS2 in
  1164.              different modes, with different startup commands or options,
  1165.              or to run different batch files or other commands.  You can
  1166.              use these objects to run commonly-used commands and batch
  1167.              files directly from the OS/2 desktop.
  1168.  
  1169.              Each object represents a different 4OS2 session and you can
  1170.              set up any of these sessions to run in windowed or full-screen
  1171.              mode.  You can also set any necessary command line parameters
  1172.              for 4OS2 such as a command to be executed, any desired
  1173.              switches, and the name and path for 4OS2.INI.  More
  1174.              information on command line switches and options for 4OS2 is
  1175.              included later in this section.
  1176.  
  1177.              When you configure a 4OS2 object, place an asterisk [*] in the
  1178.              Program Name field, and put any startup options that you want
  1179.              passed to 4OS2 (e.g., @inifile) in the Parameters field.  For
  1180.              example:
  1181.  
  1182.                   Path and file name: *
  1183.                   Parameters:         @D:\START\4OS2.INI
  1184.                   Working directory:  C:\
  1185.  
  1186.  
  1187.         -------------------------------------------------------------------
  1188.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 18
  1189.  
  1190.                                                   CHAPTER 3 / CONFIGURATION
  1191.         -------------------------------------------------------------------
  1192.  
  1193.              (If 4OS2 is not set up as your default OS/2 shell in
  1194.              CONFIG.SYS, use the full path and name for 4OS2.EXE as the
  1195.              program name, rather than the asterisk.)
  1196.  
  1197.              To run a startup batch file for a particular 4OS2 session,
  1198.              include its name (with a path, if the batch file is not in the
  1199.              session's startup directory) as the last item in the
  1200.              Parameters field.  That batch file will be executed after any
  1201.              4START file but before the first prompt is displayed.  You can
  1202.              use the batch file to set environment variables and execute
  1203.              any other 4OS2 commands.  You can also execute any internal
  1204.              4OS2 command, external command, or alias by placing its name
  1205.              in the Parameters field.  When you set up a batch file or
  1206.              other command to run in this way you are using the command
  1207.              option (see below).  For example:
  1208.  
  1209.                   Path and file name: *
  1210.                   Parameters:         @D:\START\4OS2.INI STARTOS2.CMD
  1211.                   Working directory:  C:\
  1212.  
  1213.              To execute an internal or external command, an alias, or a
  1214.              batch file and then exit (return to the desktop) when it is
  1215.              done, place /C command (rather than just command) as the last
  1216.              item in the Parameters field.  For example:
  1217.  
  1218.                   Path and file name: *
  1219.                   Parameters:         /C COMFILES.BTM
  1220.                   Working directory:  C:\
  1221.  
  1222.  
  1223.         4OS2 Command Line Options
  1224.  
  1225.              The 4OS2 command line does not need to contain any
  1226.              information.  When invoked with an empty command line, 4OS2
  1227.              will configure itself from the 4OS2.INI file, run 4START, and
  1228.              then display a prompt and wait for you to type a command.
  1229.              However, you may add information to the 4OS2 command line that
  1230.              will affect the way it operates.
  1231.  
  1232.              Command line options for primary shells are set in the
  1233.              Parameters field of the 4OS2 object.  If you need help finding
  1234.              and setting the Parameters field for your version of OS/2, see
  1235.              page 15.  Command line options for secondary shells can be set
  1236.              on the secondary shell command line.
  1237.  
  1238.              4OS2 recognizes several optional fields on the command line.
  1239.              All of the options go on one line.  If you use more than one
  1240.              of these fields, their order is important.  The syntax for the
  1241.              command line is:
  1242.  
  1243.  
  1244.         -------------------------------------------------------------------
  1245.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 19
  1246.  
  1247.                                                   CHAPTER 3 / CONFIGURATION
  1248.         -------------------------------------------------------------------
  1249.  
  1250.                   [d:\path] [@d:\path\inifile] [//iniline]... [/L] [/LA]
  1251.                   [/LH] [/S] [/C | /K] [command]
  1252.  
  1253.              In the descriptions below, d: means a drive letter and \path
  1254.              means a subdirectory name.
  1255.  
  1256.                   d:\path:  4OS2 will use this directory and path to set
  1257.                   the COMSPEC environment variable for this session.  If
  1258.                   this option is not used, COMSPEC is set from the location
  1259.                   of 4OS2.EXE.  Since 4OS2 always knows what drive and
  1260.                   directory it was started from, there is little reason to
  1261.                   use this option.  It is included only for compatibility
  1262.                   with CMD.EXE.  This option cannot be used for secondary
  1263.                   shells.
  1264.  
  1265.                   @d:\path\inifile:  This option sets the path and name of
  1266.                   the 4OS2.INI file, which is discussed below.  You do not
  1267.                   need this option if you aren't using a 4OS2.INI file, or
  1268.                   if the file is named 4OS2.INI and is stored in the same
  1269.                   subdirectory as 4OS2.EXE or in the root directory of the
  1270.                   boot drive.  This option is most useful if you want to
  1271.                   start a 4OS2 session with a specific and unique .INI
  1272.                   file.
  1273.  
  1274.                   //iniline:  This option tells 4OS2 to treat the text
  1275.                   appearing between the // and the next space or tab as a
  1276.                   4OS2.INI directive.  The directive should be in the same
  1277.                   format as a line in 4OS2.INI, but it may not contain
  1278.                   spaces, tabs, or comments.  This option overrides any
  1279.                   corresponding directive in your 4OS2.INI file.  It is a
  1280.                   convenient way to send 4OS2 one or two simple directives
  1281.                   without modifying or creating a new 4OS2.INI file.
  1282.  
  1283.                   /L, /LA, and /LH:  These options force 4OS2 to use a
  1284.                   local alias and / or history list.  This allows you to
  1285.                   use global aliases as the default, but start a specific
  1286.                   4OS2 session with local aliases or history.  See your
  1287.                   Reference Manual for details on local and global aliases
  1288.                   and history.  /LA forces local aliases, /LH forces local
  1289.                   history, and /L forces both local aliases and local
  1290.                   history.
  1291.  
  1292.                   /S:  This option tells 4OS2 that you do not want it to
  1293.                   set up a Ctrl-C / Ctrl-Break handler.  It is included for
  1294.                   compatibility with CMD.EXE, but it may cause the system
  1295.                   to operate incorrectly if you use this option without
  1296.                   other software to handle Ctrl-C and Ctrl-Break.  This
  1297.                   option should be avoided by most users.
  1298.  
  1299.  
  1300.  
  1301.         -------------------------------------------------------------------
  1302.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 20
  1303.  
  1304.                                                   CHAPTER 3 / CONFIGURATION
  1305.         -------------------------------------------------------------------
  1306.  
  1307.                   [/C | /K] command:  This option tells 4OS2 to run a
  1308.                   command when it starts.  The command will be run after
  1309.                   4START has been executed and before any command prompt is
  1310.                   displayed.  It can be any valid internal or external
  1311.                   command, batch file, or alias; you may include multiple
  1312.                   commands by using the command separator.  All other
  1313.                   startup options must be placed before the command,
  1314.                   because 4OS2 will treat characters after the command as
  1315.                   part of the command and not as additional startup
  1316.                   options.
  1317.  
  1318.                   When the command is preceded by a /C, 4OS2 will execute
  1319.                   the command and then exit and return to the parent
  1320.                   program or the OS/2 desktop without displaying a prompt.
  1321.  
  1322.                   The /K switch has no effect; using it is the same as
  1323.                   placing the command (without a /C or /K) at the end of
  1324.                   the startup command line.  It is included only for
  1325.                   compatibility with CMD.EXE.
  1326.  
  1327.  
  1328.         16-Bit and 32-Bit Versions of 4OS2
  1329.  
  1330.              4OS2 comes in two versions:  32-bit (4OS2/32) and 16-bit
  1331.              (4OS2/16).  If you use OS/2 version 2.1, you will find that
  1332.              4OS2/32 offers a few improvements and runs a bit faster than
  1333.              4OS2/16.  Normally, the correct version is selected for you
  1334.              automatically by the 4OS2 INSTALL program.  If you are using a
  1335.              downloaded copy of 4OS2, see the README.DOC file which came
  1336.              with your copy for details on selecting the appropriate files
  1337.              for your system.
  1338.  
  1339.              Once the proper version is selected during installation, you
  1340.              generally don't need to be concerned with which version you
  1341.              are using, as the two versions are almost identical.  A few
  1342.              features are available only in the 32-bit version; these are
  1343.              marked as such in the Reference Manual and on-line help.
  1344.  
  1345.              If necessary, you can install the 16-bit or 32-bit version
  1346.              explicitly rather than letting the installation program choose
  1347.              for you.  To do so, start the installation program (see page
  1348.              4) and select the Install 16-bit Version or Install 32-bit
  1349.              Version option.  These options install only the files which
  1350.              differ between the two versions:  4OS2.EXE, SHRALIAS.EXE,
  1351.              4OS2A.ICO, and 4OS2B.ICO.
  1352.  
  1353.              4OS2/16 runs under OS/2 1.21, 1.3, 2.0, and 2.1.  4OS2/32
  1354.              normally runs only under OS/2 2.1.  You can install it
  1355.              manually for OS/2 2.0 if you wish, but some features may not
  1356.  
  1357.  
  1358.         -------------------------------------------------------------------
  1359.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 21
  1360.  
  1361.                                                   CHAPTER 3 / CONFIGURATION
  1362.         -------------------------------------------------------------------
  1363.  
  1364.              work properly due to problems with 32-bit support in some
  1365.              versions of OS/2 2.0.
  1366.  
  1367.  
  1368.         4OS2 Help
  1369.  
  1370.              Complete on-line help for all 4OS2 commands and features is
  1371.              provided with 4OS2.  Help is invoked with the HELP command or
  1372.              the F1 key.
  1373.  
  1374.              4OS2's help text does not cover the OS/2 external commands
  1375.              because they are included in OS/2's built-in Command
  1376.              Reference.  The OS/2 Command Reference is normally displayed
  1377.              along with 4OS2's help when the HELP command or F1 key is
  1378.              used.  You can also use the 4OS2 HELP command for quick help
  1379.              on 4OS2 commands, and for explanations of OS/2 error messages
  1380.              (see below for details).
  1381.  
  1382.              When you start the 4OS2 Help system, 4OS2 opens a new window
  1383.              to run VIEW.EXE, the standard help program supplied with OS/2.
  1384.              VIEW displays the 4OS2 Help and OS/2 Command Reference
  1385.              information and lets you browse through it.
  1386.  
  1387.              If you invoke VIEW from a windowed 4OS2 session, you will be
  1388.              returned to that session when you are done with VIEW.  If you
  1389.              invoke VIEW from a full-screen session, you must manually
  1390.              return to that session using standard OS/2 methods for
  1391.              switching between sessions (this is due to the design of VIEW
  1392.              and is not a limitation of 4OS2).
  1393.  
  1394.              You can also keep the VIEW help window on the screen and
  1395.              return to the 4OS2 session, switching between the two sessions
  1396.              as needed.  This may be useful when you are writing a batch
  1397.              file, working on a complex command, or experimenting with
  1398.              4OS2.
  1399.  
  1400.              In order for the 4OS2 help system to work properly, both
  1401.              VIEW.EXE and the help text file, 4OS2.INF, must be in their
  1402.              proper locations.  VIEW.EXE is normally stored in the \OS2
  1403.              directory.  This directory must be included in your PATH (as
  1404.              it normally is) so that 4OS2 can find and start VIEW.
  1405.  
  1406.              During automated installation, 4OS2.INF is copied to your 4OS2
  1407.              installation directory, and the installation program adjusts
  1408.              the SET BOOKSHELF line in CONFIG.SYS to include this
  1409.              directory.  This allows VIEW to find 4OS2.INF when you press
  1410.              F1 or use the HELP command.  If you prefer, you can move
  1411.              4OS2.INF to the standard "book" directory shown on the SET
  1412.              BOOKSHELF line in CONFIG.SYS (normally \OS2\BOOK), in which
  1413.  
  1414.  
  1415.         -------------------------------------------------------------------
  1416.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 22
  1417.  
  1418.                                                   CHAPTER 3 / CONFIGURATION
  1419.         -------------------------------------------------------------------
  1420.  
  1421.              case the 4OS2 directory does not need to be listed in the
  1422.              BOOKSHELF setting.
  1423.  
  1424.              OS/2 includes a complete reference to all internal and
  1425.              external commands in the reference book named CMDREF.  This
  1426.              book is stored in the file \OS2\BOOK\CMDREF.INF.  4OS2
  1427.              normally passes the help file name "4OS2+CMDREF" to VIEW, so
  1428.              that VIEW opens both the 4OS2 help text and the OS/2 command
  1429.              reference.
  1430.  
  1431.              You can specify a different set of "books" to be opened when
  1432.              HELP or F1 is invoked.  To do so, use the HelpBook directive
  1433.              in 4OS2.INI.  For example, to set up 4OS2 so that only 4OS2
  1434.              help is displayed (without the CMDREF book) when F1 is
  1435.              pressed, you would include the following directive in
  1436.              4OS2.INI:
  1437.  
  1438.                   HelpBook=4OS2
  1439.  
  1440.              When more than one book is listed in the HelpBook setting,
  1441.              VIEW will see the combined group as a single book.  The Table
  1442.              of Contents displayed by VIEW will include the tables of
  1443.              contents from all the listed books, concatenated together as
  1444.              one group of topics with no divisions to show where one book
  1445.              ends and the next begins.
  1446.  
  1447.              If you wish, you can set up a separate object for 4OS2 help
  1448.              which can be invoked from your desktop.  To do so, create an
  1449.              object with VIEW.EXE as the program name and 4OS2 in the
  1450.              parameter field (or use 4OS2+CMDREF to show both books when
  1451.              the object is selected).
  1452.  
  1453.              4OS2 also supports the /? switch to display help for any
  1454.              command.  For more information on /? see the Command Line Help
  1455.              topic in Chapter 3 of your Reference Manual.  For information
  1456.              on the 4OS2H.MSG file, which contains the /? help text, see
  1457.              page 8 of this manual.
  1458.  
  1459.              4OS2 can also be used to obtain help on OS/2 error codes.  If
  1460.              you type either of these commands:
  1461.  
  1462.                   [c:\] help nnnn
  1463.                   [c:\] help sysnnnn
  1464.  
  1465.              where "nnnn" is an OS/2 system error number, HELP will display
  1466.              an explanation of the OS/2 error.  This feature works by
  1467.              running the OS/2 program HELPMSG.EXE which opens the file
  1468.              OSO001.H to get the explanation.  For this feature to work,
  1469.              HELPMSG.EXE must be in a directory that is in your PATH, and
  1470.              the data file OSO001H.MSG must be in a directory in your DPATH
  1471.  
  1472.         -------------------------------------------------------------------
  1473.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 23
  1474.  
  1475.                                                   CHAPTER 3 / CONFIGURATION
  1476.         -------------------------------------------------------------------
  1477.  
  1478.              (OS/2 sets up HELPMSG.EXE and OS0001H.MSG this way by
  1479.              default).
  1480.  
  1481.              You can also use the 4OS2 HELP command to change the PROMPT
  1482.              setting.  HELP ON will change the default prompt to $i[$p],
  1483.              and HELP OFF will change the default prompt to [$p].  This
  1484.              feature is included for compatibility with OS/2's CMD.EXE, and
  1485.              is implemented by running the HELP.CMD file which comes with
  1486.              OS/2 (typically stored in the \OS2 directory).  Changing the
  1487.              prompt is probably better accomplished by using the PROMPT
  1488.              command instead of HELP ON or HELP OFF.
  1489.  
  1490.  
  1491.         Using 4START and 4EXIT
  1492.  
  1493.              4OS2 executes two batch files automatically:  4START is run
  1494.              whenever 4OS2 starts, and 4EXIT is run whenever 4OS2 exits.
  1495.              4START and 4EXIT can be either .CMD or .BTM files.
  1496.  
  1497.              If you create 4START.BTM and 4EXIT.BTM files, you can use them
  1498.              for both 4OS2 and 4DOS.  Use the IFF command and the %_DOS
  1499.              internal variable to separate commands which should be
  1500.              executed under only one operating system.
  1501.  
  1502.              If you prefer to use different files for 4OS2 and 4DOS, you
  1503.              can use 4START.CMD for 4OS2 and 4START.BAT for 4DOS.  You
  1504.              could name your 4EXIT files similarly.  You can also keep the
  1505.              4START and 4EXIT files separate by placing the files for 4OS2
  1506.              in the 4OS2 directory and the files for 4DOS in the 4DOS
  1507.              directory.
  1508.  
  1509.              If 4OS2 is started as a secondary shell with the [/C] command
  1510.              option, 4START is executed before the command.
  1511.  
  1512.              See your Reference Manual for more information on 4START and
  1513.              4EXIT.
  1514.  
  1515.              If you prefer, you can create a file with a name other than
  1516.              4START (for example, STARTOS2.CMD) and put its name in the
  1517.              Parameters field for any 4OS2 object (see page 18).  Doing so
  1518.              has two advantages.  The file will only be started when a
  1519.              primary 4OS2 shell is started, not under a secondary shell or
  1520.              under 4DOS.  Also, you can then use different startup files
  1521.              for different 4OS2 sessions.
  1522.  
  1523.              For example, you might create a file called STARTFS.CMD which
  1524.              executes commands for a full-screen session, and another file
  1525.              STARTWIN.CMD which executes different commands for a windowed
  1526.              session.  You could then set up two objects with these
  1527.              settings:
  1528.  
  1529.         -------------------------------------------------------------------
  1530.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 24
  1531.  
  1532.                                                   CHAPTER 3 / CONFIGURATION
  1533.         -------------------------------------------------------------------
  1534.  
  1535.                   Path and file name: *
  1536.                   Parameters:         D:\STARTFS.CMD
  1537.                   Working directory:  C:\
  1538.  
  1539.                   Path and file name: *
  1540.                   Parameters:         D:\STARTWIN.CMD
  1541.                   Working directory:  C:\
  1542.  
  1543.              The first object should be configured as an OS/2 Full Screen
  1544.              session and the second as an OS/2 Windowed session.
  1545.  
  1546.  
  1547.         Using STARTUP.CMD
  1548.  
  1549.              If you have a STARTUP.CMD file in the root directory of your
  1550.              OS/2 boot drive, OS/2 will automatically create a windowed
  1551.              4OS2 session when the system boots and will tell that session
  1552.              to execute STARTUP.CMD.  (This is a feature of OS/2 and does
  1553.              not depend on 4OS2.  If CMD.EXE is your OS/2 command
  1554.              processor, it will be used to run STARTUP.CMD.)
  1555.  
  1556.              You can use STARTUP.CMD to start other sessions, to set up a
  1557.              global alias list, start SHRALIAS, etc., just as you might use
  1558.              AUTOEXEC.BAT under DOS (see the ALIAS command in the Reference
  1559.              Manual for more information on SHRALIAS).  STARTUP.CMD will be
  1560.              executed once, when your system boots, not every time a 4OS2
  1561.              session is started.
  1562.  
  1563.              If you place the command EXIT at the end of STARTUP.CMD, the
  1564.              session created to run STARTUP.CMD will end when that command
  1565.              is executed, and any global alias and history lists will be
  1566.              discarded (unless another 4OS2 session has been started or
  1567.              SHRALIAS has been loaded).  If you don't include an EXIT, the
  1568.              session will remain open and can be used as a normal windowed
  1569.              4OS2 session.  If you have a 4START file, it will be run
  1570.              before STARTUP.CMD.
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.         -------------------------------------------------------------------
  1587.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 25
  1588.  
  1589.                                                                       Index
  1590.         -------------------------------------------------------------------
  1591.  
  1592.         Index                               Desktop objects (continued)
  1593.                                                 for 4OS2, 18
  1594.                                                 in OS/2 1.x, 15
  1595.         4DOS, and 4OS2 installation, 5          in OS/2 2.x, 16
  1596.         4EXIT, 24                               properties, 15
  1597.             and 4DOS, 24                    Directories, for 4OS2 files, 8
  1598.         4OS2                                DOS
  1599.             16-bit and 32-bit versions,         applications, 14
  1600.               21                                sessions, 12
  1601.             desktop objects, 18
  1602.             sessions, 18                    Extended attributes, 17
  1603.         4OS2.EXE, location of, 8
  1604.         4OS2.INF, location of, 8            Family mode applications, see
  1605.         4OS2.INI                              Bound applications
  1606.             directives, on startup          Full-screen sessions, 11
  1607.               command line, 20
  1608.             location of, 18, 20             General concepts, 10
  1609.             reference information, 2        Guided tour, 1, 6
  1610.         4OS2H.MSG, location of, 8
  1611.         4START, 24                          Help system, 2, 22
  1612.             and 4DOS, 24                        /? option, 23
  1613.             and startup command, 21             and OS/2 command reference,
  1614.                                                   23
  1615.         Alias list, local and global,           location of files, 8, 22
  1616.           20                                    selecting books to view, 23
  1617.         Applications                        History list, local and global,
  1618.             starting, 14                      20
  1619.             types of, 13
  1620.                                             .INI file, see 4OS2.INI
  1621.         Batch files, startup, 19            Installation, 4
  1622.         BOOKSHELF, see Help system              automated, 5
  1623.         Bound applications, 14                  directory for, 4
  1624.                                                 manual, 6
  1625.         Character mode                              for OS/2 version 1.x, 7
  1626.             applications, 14                        for OS/2 version 2.x, 7
  1627.             sessions, 11                        of downloaded updates, 4, 6
  1628.         Commands                                reversing, 9
  1629.             4OS2 startup, 19, 21                stopping, 6
  1630.             help on, 22
  1631.             reference information, 2        Local and global aliases and
  1632.         CONFIG.SYS, 18                        history, 20
  1633.             and installation, 4, 6
  1634.             PROTSHELL line, 7, 9            Native DOS sessions, 12
  1635.             SET COMSPEC line, 7, 9
  1636.             SET OS2_SHELL line, 7, 9        Objects, see Desktop objects
  1637.         Configuration, 18                   Options, see Startup Options
  1638.                                             OS/2
  1639.         Desktop objects, 10                     shell, 1
  1640.             configuring, 15                     versions of, 1, 21
  1641.             creating, 15
  1642.  
  1643.         -------------------------------------------------------------------
  1644.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 26
  1645.  
  1646.                                                                       Index
  1647.         -------------------------------------------------------------------
  1648.  
  1649.  
  1650.         Presentation Manager, 10
  1651.             applications, 13
  1652.             sessions, 11
  1653.         Process, 10
  1654.  
  1655.         Quick help, 23
  1656.  
  1657.         README.1ST file, 5
  1658.         Reference information, 2
  1659.         Reference Manual, 2
  1660.  
  1661.         Sessions, 10
  1662.             4OS2, 18
  1663.             starting, 14
  1664.             types of, 11
  1665.         Settings notebook, see Desktop
  1666.           objects
  1667.         Shell, 1
  1668.         SHRALIAS.EXE, location of, 8
  1669.         Startup options, 18, 19
  1670.             //iniline, 20
  1671.             /C, 21
  1672.             /K, 21
  1673.             /L, /LA, and /LH, 20
  1674.             /S, 20
  1675.             @inifile, 20
  1676.             commands in, 21
  1677.         STARTUP.CMD, 24
  1678.         Support, 3
  1679.  
  1680.         Technical support, 3
  1681.  
  1682.         Uninstalling 4OS2, 9
  1683.  
  1684.         VDM, see DOS sessions
  1685.         VIEW.EXE, see Help system
  1686.         VMB, see DOS sessions
  1687.  
  1688.         Windowed sessions, 12
  1689.         Windows
  1690.             applications, 14
  1691.             sessions, 13
  1692.         Workplace Shell, 10
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.         -------------------------------------------------------------------
  1701.         Copr. 1993 JP Software Inc.   4OS2 Intro. & Installation Guide / 27
  1702.