═══ 1. CS-Edit/2 ═══ CS-Edit/2 "Peace of mind for your OS/2 2.x CONFIG.SYS" Online Help and Reference (c) Copyright 1993 Multitask Consulting Pty Ltd. All rights reserved. IBM, Operating System/2, and OS/2 are registered trademarks of International Business Machines Corporation. CompuServe is a registered trademark of CompuServe, Inc.. PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc. ═══ 2. Software License Agreement ═══ Software License Agreement Please read this agreement carefully and make sure that you accept its terms before using CS-Edit/2. By installing or using this product, you are agreeing to be bound by the terms and conditions herein. This software is protected by copyright law and international treaty provisions. You may treat this software like a book, or other material bound by copyright law. You may only make copies of this software to back it up, to protect your investment in this software. This software may be installed on more than one machine, and can be freely moved from one machine to another, as long as there is no possibility that more than one copy may be in use at any particular moment. For example, a LAN Administrator may install a copy of this software on each machine on the LAN, as long as only the LAN Administrator is allowed to run it, and thus only one copy would be active at any point in time. Multitask Consulting disclaims all warranties as to this software, whether expressed or implied, including, without any limitation, any implied warranty of the product to sell itself, usefulness for any particular purpose, functionality or data or system integrity. ═══ 3. Introduction ═══ CS-Edit/2 is an intelligent CONFIG.SYS editor for OS/2 2.0 and 2.1. It is a tool that can make maintaining your system much easier, and also let you learn about your machines' configuration with a minimum of effort. CS-Edit/2's goal is to only allow a valid CONFIG.SYS file to be written to disk, and to only allow valid additions and updates to be made to any existing CONFIG.SYS. What this means for OS/2 users is that they no longer have to edit their CONFIG.SYS manually, and that help is always available for items of which you are unsure. The net result being a computer that always comes up, and an increased knowledge about your system and about OS/2 itself. We hope that you will find CS-Edit/2 useful and that it becomes your preferred method for making updates to your CONFIG.SYS. ═══ 4. Glossary ═══ You can use the SET command in the CONFIG.SYS to set the value of Work Place Shell (WPS) environment variables. One of these variables is GLOSSARY. The GLOSSARY variable holds a list of directories that contain Help Files ( these have a .HLP extension) which are used by the Glossary object that is found in the Information folder on your desktop. The normal value of this statement is x:\OS2\HELP\GLOSS where x is the drive your machine is booted from. Example: To set the GLOSSARY environment variable to its normal value for a machine with OS/2 installed on the C: drive, insert the line SET GLOSSARY=C:\OS2\HELP\GLOSS; in your CONFIG.SYS ═══ 5. SET Statements ═══ The sections following this details various set statements that can be found in the CONFIG.SYS and explain them in more detail. ═══ 5.1. DIRCMD ═══ This variable holds the default options for the DIR command when run from an OS/2 or DOS Command Prompt. Valid values are listed under OS/2 Commands By Name in the entry under DIR. For example, if you wanted your HPFS and FAT DIR commands to produce the same output, you would SET DIRCMD=/N in your CONFIG.SYS. ═══ 5.2. HOSTNAME ═══ This variable holds the name of the TCP/IP host that your PC will be connecting to. It can be any valid TCP/IP host name. See the TCP/IP documentation for more details. ═══ 5.3. ICC ═══ This statement holds the default options for the CSet/2 V1.0 or CSet++ C/C++ Compiler from IBM. Any options that you don't want to explicitly specify, can be placed in this statement in your CONFIG.SYS, and all compiles will use them as the default options. This can save space in make files, or define your development standards for compiler options once, rather than every time you use the compiler. For more information, see the CSet++ documentation. ═══ 5.4. IPF_KEYS ═══ IPF_KEYS is an environment variable that is used by the Information Presentation Facility of OS/2 to allow selective hiding of information depending on which users are viewing the information. Usually the variable is set to either SBCS or DBCS by OS/2 2.1 installation, so that only the appropriate help will be shown for system commands and for the online references that are shipped with OS/2. In some situations, more than one level of information may need to be shown, and the levels may be concatenated in the IPF_KEYS statement with a '+' character. Example: To view both Single Byte Character Set and Double Byte Character Set information, you might use the following IPF_KEYS statement in your CONFIG.SYS SET IPF_KEYS=DBCS+SBCS ═══ 5.5. NCDEBUG ═══ NCDEBUG is actually a Secret Lotus 1-2-3 value that allows MMPM/2 Lotus macros to work correctly. There is no range for this value, but set at 4000 it allows MMPM/2 to load DLL entry points from within a macro for audio annotation in 1-2-3. ═══ 5.6. OBJECTSNOOZETIME ═══ This variable holds the duration, in seconds, that a WPS object waits before it unloads it's DLL as part of the WPS process. It defaults to 30 seconds, but you can set it to zero, to immediately unload an objects DLL when not in use. This is extremely handy for debugging WPS objects and doing object development work. ═══ 5.7. SHELLEXCEPTIONHANDLER ═══ This varaible tells the Work Place Shell whether it should gracefully recover from exceptions, such as TRAP D's. To see how often the shell really falls over, set this variable to NO in your CONFIG.SYS. Set this variable to YES if you are doing WPS development and don't want your desktop to fall over every time your object causes an exception. ═══ 5.8. SLIP.COM ═══ This statement holds the COM port (valid values are valid COM ports for your machine) that the SLIP (Serial Line Internet Protocol) service will use to communicate with a remote machine. For more information on this statement, please see the TCP/IP documentation. ═══ 5.9. SLINK2 ═══ This variable is used to hold the directory in which SourceLink is installed. It should only be one directory, and not a path statement of multiple directories. If SourceLink is installed on your C: drive in the default directory, the variable would be set up as follows :- SET SLINK2=C:\SLINK2 ═══ 5.10. SL_BACKUP2 ═══ This variable is used to hold a directory that is used by SourceLink for autosaved copies of files being edited. It is a single directory, not a list of directories, such as is found in the SET PATH= statement. If SourceLink were installed in the default directory on your C: drive, the SL_BACKUP2 statement would be:- SET SL_BACKUP2=C:\SLINK2\BACKUP ═══ 5.11. SL_TEMP2 ═══ This variable is used to hold the directory that SourceLink uses to create temporary files for its own processing. It should be a single director and not a list of directories, such as the SET PATH= statement. If SourceLink were installed in the default directories on drive C:, the SL_TEMP2 statement would be as follows :- SET SL_TEMP2=C:\SLINK2\TEMP ═══ 5.12. TZ ═══ TZ is an environment variable that is used by the C Compiler and some applications to define the time zone that you are currently in. Usually the variable is set for you by the compiler installation, or application installation. In some situations, however, and application may need this variable set, and it may not be present in your CONFIG.SYS. CS-Edit/2 will allow you to add this statement from the Line->Add menu option. Information about the format of the TZ statement is on the next page. Press the Forward button to proceed to the next page. ═══ 5.12.1. Description of TZ format. ═══ SET TZ=SSS[+|-]nDDD[,sm,sw,sd,st,em,ew,ed,et,shift] ┌──────────┬──────────────────────────────┬───────────────┐ │Variable │Description │Default Value │ ├──────────┼──────────────────────────────┼───────────────┤ │SSS │Standard timezone identifier. │EST │ │ │This must be three characters,│ │ │ │must begin with a letter and │ │ │ │can contain spaces. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │n │Difference in hours between │5 │ │ │your time zone and Greenwich │ │ │ │mean time (GMT). A positive │ │ │ │number denotes time zones west│ │ │ │of Greenwich, a negative │ │ │ │number denotes time zones East│ │ │ │of Greenwich. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │DDD │Daylight saving time zone │EDT │ │ │identifier. Rules are the same│ │ │ │as for SSS. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │sm │Starting month of daylight │4 │ │ │saving (1 to 12). │ │ ├──────────┼──────────────────────────────┼───────────────┤ │sw │Starting week of daylight │1 │ │ │saving relative to sm (-4 to 4│ │ │ │). │ │ ├──────────┼──────────────────────────────┼───────────────┤ │sd │Starting day of daylight │0 │ │ │saving. Range 0 to 6 if sw <> │ │ │ │0, 1 to 31 if sw = 0. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │st │Starting time (in seconds) of │3600 │ │ │daylight saving. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │em │Ending month (1 to 12) of │10 │ │ │daylight saving │ │ ├──────────┼──────────────────────────────┼───────────────┤ │ew │Ending week of daylight saving│-1 │ │ │relative to em (-4 to 4). │ │ ├──────────┼──────────────────────────────┼───────────────┤ │ed │Ending day of daylight saving.│0 │ │ │Range of 0 to 6 if ew is not 0│ │ │ │, 1 to 31 if ew is 0. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │et │Ending time of daylight saving│7200 │ │ │in seconds. │ │ ├──────────┼──────────────────────────────┼───────────────┤ │shift │Amount of time shift (in │3600 │ │ │seconds). │ │ └──────────┴──────────────────────────────┴───────────────┘ Example: The following statement would be the default TZ value. SET TZ=EST5EDT,4,1,0,3600,10,-1,0,7200,3600