Microsoft KB Archive/69764

Checklist for Getting Started with PWB for COBOL 4.00

PSS ID Number: Q69764 Article last modified on 04-25-1991

4.00 MS-DOS

Summary: To successfully begin using the Programmer’s WorkBench (PWB) with Microsoft COBOL Professional Development System (PDS) version 4.00 for MS-DOS and MS OS/2, you must make several changes in your environment: 1. The following environment variables should be set in your AUTOEXEC.BAT file: PATH COBDIR LIB INIT HELPFILES TMP 2. FILES and BUFFERS must be set in the CONFIG.SYS file. 3. If you are using OS/2, LIBPATH and IOPL=YES must also be set. 4. All COBOL source files should have the file extension of .CBL, rather than .COB. 5. The run-time system (RTS) must be specified. SETUP.EXE adds a LINKLIB statement to your COBOL.DIR file. For example, if you are using DOS and the shared run-time system, your COBOL.DIR should contain the following line: LINKLIB(COBLIB+COBAPI) 6. If Microsoft Windows or an extended memory manager is installed on your PC and you receive an error message saying the application program interface (API) entered will work only in OS/2, a patch file is available to correct this problem. This patch file can be obtained by calling Microsoft Product Support Services.

More Information: Below are further details for each item in the above list: 1-3. SETUP.EXE modifies the AUTOEXEC.BAT and the CONFIG.SYS files if instructed. For example, if the default directory structure is used with SETUP.EXE, the following paths will be added to the environment variables:

 DOS and OS/2 Real Mode
 ----------------------
    set PATH=c:\cobol\binb;c:\cobol\binr;c:\cobol
    set COBDIR=c:\cobol
    set LIB=c:\cobol;c:\cobol\lib;
    set INIT=c:\cobol\init;
    set HELPFILES=c:\cobol\help\*.hlp;

 OS/2 Protected Mode Only
 ------------------------
    set PATH=c:\cobol\binb;c:\cobol\binp;c:\cobol
    set COBDIR=c:\cobol
    set LIB=c:\cobol;c:\cobol\lib;
    set INIT=c:\cobol\init;
    set HELPFILES=c:\cobol\help\*.hlp;
    set LIBPATH=c:\cobol;c:\os2\dll;

If using OS/2, the following line must be included in the
CONFIG.SYS:
   IOPL=YES
If using DOS, the following must be included in the CONFIG.SYS:
   FILES=100
   BUFFERS=10
PWB uses temporary files with names in the format PWBnnnnn.Vii,
where nnnnn and ii are generated numbers. Occasionally they are
not deleted. To prevent these temporary files from appearing
throughout your file structure, set the following environment
variable to point to any valid directory:
   set TMP=
After any changes have been made to the AUTOEXEC.BAT file or
CONFIG.SYS file, your machine must be rebooted.

To rename all files in a subdirectory with the file extension of .COB to .CBL, use the Windows File Manager or the following DOS command: rename .cob .cbl
SETUP.EXE creates a default LINKLIB in your COBOL.DIR file.
Depending on operating system and run-time system, use one of the following: With DOS and shared run-time system, use: LINKLIB(COBLIB+COBAPI) With DOS and static run-time system, use: LINKLIB(LCOBOL+COBAPI) With OS/2 and shared run-time system, use
LINKLIB(COBLIB+OS2) With OS/2 and static run-time system, use: LINKLIB(LCOBOL+OS2) The RTS libraries can also be specified on the LINK command line or set as Options within PWB.
More information is available about the “OS/2 API Problem in COBOL 4.00 with Expanded Memory Managers” by querying on the following words: COBOL and API and patch