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