═══ 1. Product Information ═══ This window contains information about the IBM C/C++ Tools V2.0* installation program. To continue with the installation, click on OK. For more information about the program, press F2 from this help window. ═══ 2. Help for Option ═══ Select Install to start the installation program. ═══ 3. Help for Install ═══ Select this option to start the installation program, or to locate the initialization backup file from the previous installation. A dialog box with the installation options appears. You can use the IBM* installation defaults, or choose the options that you want for first installation or reinstallation. ═══ 4. Using Help ═══ Use the help options from this pull-down menu to find out how to use help, to get general help on the program, to see the list of keys, to go to the help index, or to look at the product information. The following options are available: Help index Displays the index for the help file. General help Displays general help for the installation program. Using help Provides detailed information on the kinds of help available and how to use help. Product information Displays the product's copyright information. Help is always available. You can get help in three ways: 1. Press F1 at any time for help about a specific menu-bar pull-down or option (if one was currently selected). 2. Select a Help topic from the Help pull-down. 3. Click on the Help button in a dialog or message box. You can also press F2 to get general information about the active window. For the most recent information about this installation program, read the READ.ME file in the main Install window. To begin the installation program, select Install from the Option pull-down menu. ═══ 5. Help for Using help ═══ Use this choice for information on how to use the Help facility. ═══ 6. Help for General help ═══ Use this choice to get general information about the installation program. ═══ 7. Help for Help index ═══ Use this choice to display the Help index. The Help index lists the titles of the available help information topics. To display a topic, double-click on the index entry (or use the Up and Down arrow keys and press Enter). You can also use the Search choice from the Services pull-down menu to search for a specific word or phrase in the Help facility. To return to the Help index after viewing a topic or from another Help window, press F11. ═══ 8. Help for Product information ═══ Use this choice to display the copyright information for the installation program. ═══ 9. About the Installation Program ═══ The installation program is an interactive program that you use to install the IBM C/C++ Tools V2.0* product. To start the program, select Install from the Option pull-down menu. You can use the IBM-supplied installation defaults, or you can select the options you want to install. If you have already installed the IBM C/C++ Tools V2.0 product, you can reinstall options, or add new options. The installation program creates all necessary directories and subdirectories, and copies the selected libraries and files to the appropriate locations on your hard disk drive. You can have the program update your CONFIG.SYS file. The program also creates a command file, CSETENV.CMD, that you use to set up the C/C++ Tools V2.0 environment, and a Desktop folder containing the tools and online documentation. For the most recent information about this program, read the READ.ME file displayed in the main installation window. ═══ 10. Key Assignments ═══ Each panel shows underlined keys to help you with the installation program. The following Help keys are also available: F1 Get help for a highlighted field F2 Get general help about the active window F9 Go to a list of keys (from within any help window) F11 Go to the help index (from within any help window) Shift+F10 Get information on how to use help (from within any help window) Esc Display previous help (from within any help window). ═══ 11. C/C++ Tools V2.0 Main Window Help ═══ Use this window to select the installation options, or to verify the options selected in previous installations. If you are installing for the first time, all the options are available and the default options are selected. If you are reinstalling, all the options that you selected in the previous installation are selected. For first installation or a reinstallation over an existing version of the product, you can install any of the following IBM C/C++ Tools V2.0* tools: o C/C++ Compiler o Debugger o Execution Trace Analyzer o Browser You can also specify the target drive and directory where the files are to be copied to. You can also install the files that support the IBM WorkFrame/2* product. For the compiler, you can install the libraries, documentation, and sample programs. You can also have the program update your CONFIG.SYS file and your Desktop. The IBM-supplied defaults install the C/C++ Compiler, Debugger, Execution Trace Analyzer, Browser, and WorkFrame/2 support in the IBMCPP directory in your boot drive. The default compiler options specify installation of all libraries, documentation, the sample programs, and tutorials. The default options do not modify your CONFIG.SYS file. Help is available for each field: you make the field active and press F1. Help is also available by the same method for each push button at the bottom of the window. Important If you are reinstalling and you want to install IBM C/C++ Tools V2.0* in another location, you should delete all previous C/C++ Tools directories first. When you have chosen the options you want to install, click on Install to install them. ═══ 12. Verify Options - Help ═══ Verify the selections made in the previous installation. All the previously selected options are checked but all the push buttons are unavailable. There are two situations that require you to verify previously selected options: o C/C++ Tools V2.0 has already been installed on the server connected to your workstation, and you want to update your workstation's desktop and/or configuration to use C/C++ Tools V2.0 in the server. o OS/2 has been upgraded on your workstation or the workstation's system initialization file (OS2.INI) has been corrupted. Click on Update to update the Desktop and configuration of the selections from the previous installation. To exit the main selection window, click on Cancel ═══ 13. Verify Libraries and Documentation - Help ═══ Verify the selections made in the previous installation. All the previously selected options are checked but all the push buttons are unavailable. There are two situations that require you to verify previously selected options: o C/C++ Tools V2.0 has already been installed on the server connected to your workstation, and you want to update your workstation's desktop and/or configuration to use C/C++ Tools V2.0 in the server. o OS/2 has been upgraded on your workstation or the workstation's system initialization file (OS2.INI) has been corrupted. Click on OK to verify the selections and return to the main window. ═══ 14. Update Desktop - Help ═══ Select this option to restore or create the IBM C/C++ Tools V2.0* Desktop folder, selected tools and documentation icons, directories for the creation of temporary files, the CSETENV.CMD and DDE4XTRA.SYS files and for the update of the CONFIG.SYS file. The Desktop is updated according to the installation information that is stored in the OS2.INI file. If OS2.INI is corrupted, the backup initialization file CSET2.INI is used. This option is not available if this is the first installation of the product, because there is no previous installation information. ═══ 15. Status - Help ═══ Select this option to restore the status window that was closed. This option is only available if you close the status window during installation. ═══ 16. Reinstallation - Help ═══ The OS/2 initialization file on this workstation does not contain the information from the previous installation of C/C++ Tools. This information is also in the C/C++ Tools backup initialization file that was installed in the C/C++ Tools directory. Specify the drive and directory where CSET2.INI was installed and click on OK. Note: You may also want to do this in any of the following situations: o C/C++ Tools was installed on a remote LAN server connected to this workstation, and you want to create a Desktop folder of installed tools and documentation and the necessary local environment settings to share the executable files in the server. o C/C++ Tools was installed either in this workstation or in a remote LAN server, and you lost some or all of the installed icons or CONFIG.SYS variable settings. You want to retrieve all of the Desktop folders of installed tools and documentation and the CONFIG.SYS variable settings. o C/C++ Tools was installed on this workstation, but its initialization information was lost, because the operating system was upgraded or the initialization file was corrupted. You want to restore the installation information to the opearating system. Select Ignore to ignore the information from the previous installation and begin a new installation. Select Cancel to return to the main window. ═══ 17. DDE4XTRA.SYS Installation - Help ═══ The target drive is not one of your local drives. The local workstation requires a local directory for the CSETENV.CMD and DDE4XTRA.SYS files and for the creation of temporary files. Specify the local drive and directory where you want the files to be located, and click on OK to copy the file to that path. Click on Default to use the default path in the boot drive. Click on Cancel to return to the main installation window. ═══ 18. TMP File Space - Help ═══ The C/C++ Compiler requires at least 2MB of space for temporary file creation during compiling and linking. The environment variable TMP points to this space. The target drive will have less than 2MB of disk space left if you install the selected options. The target drive is IBMCPP if it is local, or it is the drive specified in the window asking for the location of CSETENV.CMD, DDE4XTRA.SYS and temporary file creation if the target drive is not local. Specify the desired drive and directory for the TMP variable, and click on OK to continue. Click on Default to select the default path. Click on Cancel to return to the main window without selecting a path. ═══ 19. Drive and Directory - Help ═══ Use these fields to specify the drive and directory where the IBM C/C++ Tools V2.0* files are to be installed. You cannot use drive A or B as the target drive. The default path is the directory IBMC on your boot drive. ═══ 20. Tools - Help ═══ Select these options to install any or all of the following IBM C/C++ Tools V2.0* tools: o C/C++ Compiler You can choose the libraries, documentation, and sample programs to install with the compiler. o Debugger Note: You must install the Sample program to use the IBM C/C++ Tools V2.0 Debugger Tutorial. o Execution Trace Analyzer Note: You must install the Sample program to use the IBM C/C++ Tools V2.0 Execution Trace Analyzer Tutorial. o Browser Note: You must install the Sample program to use the IBM C/C++ Tools V2.0 Class Browser Tutorial. At a later time, you can use the installation program to install any tools that you do not install now. ═══ 21. WorkFrame/2 Support - Help ═══ Select either or both of these options to install the files provided to support Version 1.1 and Version 2.0 of the IBM WorkFrame/2* product. The IBM C/C++ Tools V2.0* product provides two compiler options DLLs, a language profile, and sample projects for the WorkFrame/2 product. If you select WorkFrame/2 V1.1 Support and WorkFrame/2 Version 1.1 has already been installed, the C/C++ Tools installation program: 1. Installs the WorkFrame/2 sample files 2. Modifies the sample project file and copies it to the WorkFrame/2 directory 3. Copies the language profile to the WorkFrame/2 directory 4. Backs up the existing project files 5. Adds the Browser and EXTRA to the WorkFrame/2 1.1 tools list If WorkFrame/2 Version 1.1 has not been installed, only the first action is performed. If you select WorkFrame/2 V2.0 Support and WorkFrame/2 Version 2.0 has already been installed, the C/C++ Tools installation program: 1. Installs the WorkFrame/2 sample files 2. Creates a sample object (composite and base) inside the C/C++ Tools folder 3. Creates a C/C++ action profile object inside the C/C++ Tools folder 4. Adds the Browser and EXTRA to the existing action profile If WorkFrame/2 Version 2.0 has not been installed, only the first action is performed. Note: Because some files are copied to directories created by the WorkFrame/2 installation program, you should install the WorkFrame/2 product before you select these options. ═══ 22. Runtime Libraries - Help ═══ Choose the runtime libraries to install from this list. The libraries you choose depend on: o Whether you want the libraries linked statically or dynamically. o Whether you create single-thread or multithread programs. o Whether you develop subsystems. You can install any or all of the runtime libraries. At a later time, you can use the installation program to install any runtime libraries that you do not install now. Note: The IOSTREAM Class libraries are part of the single-thread and multithread Runtime Libraries. The COMPLEX and TASK Class libraries are part of the Basic Class Library. ═══ 23. C++ Class Libraries - Help ═══ Choose the C++ Class Libraries to install from this list. You can also choose Samples for the User Interface and Collection Class Libraries. When you select Class Libraries: User Interface, Collection Classes is automatically selected, because the User Interface requires the Collection Classes. Note: The COMPLEX and TASK Class libraries are part of the Basic Class Library. The IOSTREAM Class libraries are part of the single-thread and multithread Runtime Libraries. ═══ 24. Libraries and Documentation - Help ═══ Choose the Runtime Libraries, the C++ Class Libraries, and the Online References you want to install from this list. Help is available for each panel by positioning the cursor on one of the selections and pressing F1. At a later time, you can use the installation program to install any libraries and documentation that you do not install now. The Libraries and Documentation window must be closed to proceed with the installation. ═══ 25. OK - Help ═══ Click on this push button to select the options that you specified and return to the main installation window. ═══ 26. Online References - Help ═══ Choose the online references to install from this list. You can choose any or all of the following: o The IBM Class Libraries: User Interface Reference, describes the IBM User Interface class library. o The IBM Class Libraries: Collection Classes Reference, describes the IBM Collection Class library. o The IBM Basic Class Library Guide describes the IBM Basic Class library. o The IBM C Library Reference describes the C library functions. o The IBM C Language Reference is a summary of C language constructs, compiler options and messages, and the IBM C++ Language Reference is a summary of C++ language constructs. ═══ 27. Samples - Help ═══ There are seven sample programs that you can install, along with command files that compile, link, and run them. ═══ 28. Update CONFIG.SYS - Help ═══ You can have the installation program update your CONFIG.SYS file to append the correct variables for the IBM C/C++ Tools V2.0* product (such as the PATH and LIBPATH). If you do not select this option, you must add: LIBPATH = C:\IBMCPP\DLL to your CONFIG.SYS file. (Substitute your target installation directory for C:\IBMCPP.) To use the Execution Trace Analyzer, you must add: DEVICE = C:\IBMCPP\SYS\DDE4XTRA.SYS to your CONFIG.SYS file. The other statements required to set up the C/C++ Tools V2.0 environment will be placed in the CSETENV.CMD file in the BIN subdirectory. ═══ 29. Libraries and Documentation - Help ═══ Click on this push button to open the selection window of Runtime Libraries, Class Libraries and their samples and Online References. ═══ 30. Install Push Button - Help ═══ When you have selected the options you want to install, use this push button to validate your choices and start the installation. ═══ 31. Reset - Help ═══ Click on this push button to reset the options to the settings they had when the window appeared. If you are installing for the first time, the settings are reset to the defaults. If you are reinstalling, the settings are reset to the options you selected at the time of the previous installation. ═══ 32. Default - Help ═══ Click on this push button to reset the options to the IBM*-supplied installation defaults. ═══ 33. Cancel - Help ═══ Click on this push button to remove the window and return to the previous panel. No information is saved. ═══ 34. Installation Status Help ═══ This window tells you what is happening during the installation and what stage the program is at. It indicates the files installed, the directory they are copied from on the installation diskette, and the directory they are copied to on your hard disk drive. The bar indicates the percentage of bytes used in installation, compared to the total number of bytes to be used. ═══ 35. Close - Help ═══ Click on this push button to hide the status window. The program is not affected, and the installation continues. To restore the status window, click on the Options command, and then click on Status. ═══ 36. Installation Backup Help ═══ The installation program tried to create a backup file for your command or environment file using the file name and the extension .BAK, but a file with the same name and extension already exists. You can type a different name for the backup file, or use the same name and overwrite the existing backup file. Then click on OK to create the backup file. If you do not want to create a backup file, click on Skip to close this window and continue with the installation. Click on Cancel to return to the Main selection window. ═══ 37. OK - Help ═══ When you have chosen the backup file name, use this push button to back up the file. If the file specified already exists, it will be overwritten. ═══ 38. Cancel - Help ═══ Click on this push button to cancel the window and return to the main installation window. The backup file will not be created. ═══ 39. Skip - Help ═══ Click on this push button to avoid creating a new backup file. ═══ 40. Location of C/C++ Compiler - Help ═══ Specify the drive and directory where you originally installed the IBM C/C++ Tools V2.0* C/C++ Compiler. ═══ 41. OK - Help ═══ When you have specified the drive and directory where the compiler was installed, press this push button to save the information and proceed with the reinstallation. ═══ 42. Ignore - Help ═══ Click on this push button to specify the path from the last installation. ═══ 43. Cancel - Help ═══ Click on this push button to specify the path from the last installation. ═══ 44. Intallation - Help ═══ The program cannot find the selected options from the previous installation. There are several possible reasons for this: 1. This installation is the first for the product in this workstation. Click on Ignore to proceed to the Main installation window. 2. C/C++ Tools V2.0 has already been installed on the server connected to your workstation, but you want to install different selections on your workstation. Click on Ignore to proceed to the Main installation window. 3. C/C++ Tools V2.0 has already been installed on the server connected to your workstation, and you want to update your workstation's desktop and/or configuration to use C/C++ Tools V2.0 in the server. Click on Proceed. A window will prompt you for the backup installation initialization file (CSET2.INI). 4. OS/2 has been upgraded on your workstation or the workstation's system initialization file (OS2.INI) has been corrupted. The information previously stored in OS2.INI has been lost. Click on Proceed. A window will prompt you for the backup installation initialization file (CSET2.INI), which was installed in the C/C++ Tools directory. Click on Cancel to return to the Main installation window. ═══ Message Help ═══ The installation program cannot add the IBM C/C++ Tools* folder to the Desktop. There may not be enough memory available, or the Desktop may be in use. Try the operation again by clicking on the Retry button. Clicking on the Cancel button stops the installation program. ═══ Message Help ═══ Not enough memory is available to complete the installation. Stop any large processes that are running and ensure the swap path is large enough. If you are using a virtual disk, redefine it to a smaller size. Then retry the program. You may need to obtain an additional memory card. ═══ Message Help ═══ The installation program cannot add the IBM C/C++ Tools* programs to the folder on the Desktop. There may not be enough memory available, or the Desktop may be in use. Try the operation again by clicking on the Retry button. Clicking on the Cancel button stops the installation program. ═══ Message Help ═══ The installation program cannot open the CSETINST.INI file that contains the initialization information for the program. Ensure that the CSETINST.INI file exists on the installation diskette and that it is not already in use. Then restart the program. If the file has been corrupted, contact your IBM* Service Representative for help. ═══ Message Help ═══ The installation program cannot find the necessary initialization data in the CSETINST.INI file. Ensure that the CSETINST.INI file is not already in use, and then restart the program. If the file has been corrupted, contact your IBM* Service Representative for help. ═══ Message Help ═══ The help file for the installation program, CSETINST.HLP, cannot be copied to the help path. The OS/2* return code indicates the cause of the error. Correct the error. Ensure that enough disk space is available, and try again. ═══ Message Help ═══ The installation has been completed, and all selected files have been installed. To exit from the installation program, click on OK to return to the main installation window, and then select Close from the system menu. ═══ Message Help ═══ Because of an operating system error, the installation program cannot get the maximum path length allowed, and cannot check the length of the path name specified. The OS/2* return code indicates the cause of the error. Correct the error. Then restart the installation program and try again. ═══ Message Help ═══ The installation program cannot be initialized. Restart the program and try again. ═══ Message Help ═══ The operating system cannot find the starting directory of the installation program. The OS/2* return code indicates the cause of the error. Correct the error. Then restart the program and try again. If the error persists, contact your IBM* Service Representative for help. ═══ Message Help ═══ The program cannot display the indicated window. Enough memory may not be available. Stop any large processes that are running, and try the program again. ═══ Message Help ═══ To exit from the installation program, click on OK. Click on Cancel to return to the installation program. After you have ended the installation program, restart your system to make the changes to your CONFIG.SYS file take effect. ═══ Message Help ═══ Insert the requested diskette into the diskette drive, and then click on OK to continue with the installation. ═══ Message Help ═══ The installation program encountered an operating system error while checking the disk space. The OS/2* return code indicates the cause of the error. Correct the error, and try the operation again. ═══ Message Help ═══ There may not be enough free storage space to install the chosen options. You can continue with the installation by clicking on OK, but the program may not be able to install all of the options. Delete some files from your hard disk drive to make more space available, or return to the C/C++ Tools main installation window and choose different options. If you are reinstalling the IBM C/C++ Tools* to the same target directory, you may not need as much space. ═══ Message Help ═══ Not enough memory is available for the background thread needed to install the files. Stop any large processes that are running, and ensure the swap path is large enough. If you are using a virtual disk, redefine it to a smaller size. Then click on Retry to try the program again. Click on Cancel to stop the installation program. ═══ Message Help ═══ A file error interrupted the installation program while it was accessing the indicated file. The OS/2* return code indicates the cause of the error. Correct the error, and try the operation again. ═══ Message Help ═══ A directory with the same name as an installation directory already exists. If you continue with the installation, any file with the same name as an installation file will be overwritten. If you do not want to overwrite existing files, change the name of the target installation directory. ═══ Message Help ═══ The installation program cannot create the installation directory specified. The OS/2* return code indicates the cause of the error. There may not be enough memory or enough disk space available. Stop any large programs that are running, and ensure the swap path is large enough. Correct the error if possible, and then try the operation again. If there is not enough disk space to create the directory, try installing the product on another drive. ═══ Message Help ═══ The installation program cannot back up the file. The OS/2* return code indicates the cause of the error. Click on OK to return to the Backup window. Make sure the path and file name specified are valid, the file is not already in use, and that enough disk space is available. Then try the operation again. ═══ Message Help ═══ The installation program cannot find the necessary files on the installation diskette to install the indicated option, or the files cannot be unpacked using XPACK.EXE, or the target files are in use. The return code from XPACK.EXE indicates the cause of the error. For more information about the error return codes, run XPACK.EXE from the command line, or refer to the OS/2* online information. Ensure that you have Version 2.0 of XPACK.EXE. If you are reinstalling, make sure the IBM C/C++ Tools* product is not in use. Then try the operation again. If the problem persists, the files may have been damaged or destroyed. Contact your IBM* Service Representative for help. ═══ Message Help ═══ A user action stopped the installation program. Click on OK to return to the main installation window. To restart the program, click on the Options pull-down menu and select Install. To exit from the program, select Close from the system menu. ═══ Message Help ═══ Some of the options chosen have not been installed because of file errors, or they could not be unpacked using XPACK.EXE, or the target files are in use. The return code from XPACK.EXE indicates the cause of the error. For more information about the error return codes, run XPACK.EXE from the command line, or refer to the OS/2* online information. Ensure that you have Version 2.0 of XPACK.EXE. If you are reinstalling, make sure the IBM C/C++ Tools* product is not in use. Then click on Retry to try the operation again. ═══ Message Help ═══ An error occurred while the installation program was using XPACK.EXE to unpack the IBM C/C++ Tools* files. The OS/2* return code indicates the cause of the error. Make sure that XPACK.EXE exists and that its directory is specified in the PATH statement in your CONFIG.SYS. If you are reinstalling, make sure the IBM C/C++ Tools product is not in use. Then try the operation again. ═══ Message Help ═══ A user action stopped the installation program while the files were being unpacked. The return code from XPACK.EXE indicates the reason the program ended. You can try the installation again by clicking on Retry. ═══ Message Help ═══ An error occurred while the installation program was using XPACK.EXE to unpack the IBM C/C++ Tools* files, and XPACK.EXE was stopped. The return code from XPACK.EXE indicates the cause of the error. For more information about the error return codes, run XPACK.EXE from the command line, or refer to the OS/2* online information. If you are reinstalling, make sure the IBM C/C++ Tools product is not in use. Try the operation again by clicking on Retry. ═══ Message Help ═══ The operating system cannot find the boot drive. The installation program has stopped. The OS/2* return code indicates the cause of the error. Correct the error, and then restart the program and try again. If the error persists, contact your IBM* Service Representative for help. ═══ Message Help ═══ The installation program has been invoked twice. Close down one of the installation programs, and try the remaining program. ═══ Message Help ═══ To exit from the installation program, click on OK. Click on Cancel to return to the installation program. After you have ended the program, update the LIBPATH in your CONFIG.SYS file to include the DLL subdirectory. (If you installed the Execution Trace Analyzer, update DEVICE in CONFIG.SYS as well.) Then restart your system to make the changes take effect. ═══ Message Help ═══ The installation program cannot create the target directory specified. The OS/2* return code indicates the cause of the error. Correct the error. Make sure that the path specified is valid and that enough disk space is available. Then try the operation again. ═══ Message Help ═══ The installation program encountered an error while it was loading the READ.ME file. The OS/2* return code indicates the cause of the error. The error may have affected the program. Correct the error, and try the operation again. ═══ Message Help ═══ No libraries were chosen to be installed. To use the compiler, you need at least one library. If you do not want to install a library, click on Yes to continue with the installation. Click on No to return to the C/C++ Tools main installation window, and then choose the additional options you want to install. ═══ Message Help ═══ No installation options were chosen. Click on OK to return to the C/C++ Tools main installation window, and choose the options you want to install. ═══ Message Help ═══ If you are also installing Version 1.1 of the IBM WorkFrame/2* product, it should be installed before you install the IBM C/C++ Tools* product. Some of the C/C++ Tools files provide support for the WorkFrame/2 product. If WorkFrame/2 Version 1.1 has already been installed, the C/C++ Tools installation program: 1. Installs the WorkFrame/2 sample files 2. Modifies the sample project file and copies it to the WorkFrame/2 directory 3. Copies the language profile to the WorkFrame/2 directory 4. Backs up the existing project files 5. Adds the Browser and EXTRA to the WorkFrame/2 1.1 tools list If WorkFrame/2 Version 1.1 has not been installed, only the first action is performed. ═══ Message Help ═══ If you are also installing Version 2.0 of the IBM WorkFrame/2* product, it should be installed before you install the IBM C/C++ Tools* product. Some of the C/C++ Tools files provide support for the WorkFrame/2 product. If WorkFrame/2 Version 2.0 has been installed, the C/C++ Tools installation program: 1. Installs the WorkFrame/2 sample files 2. Creates a sample object (composite and base) inside the C/C++ Tools folder 3. Creates a C/C++ action profile object inside the C/C++ Tools folder 4. Adds the Browser and EXTRA to the existing action profile If WorkFrame/2 2.0 has not been installed, only the first action is performed. ═══ Message Help ═══ The directory that specifies the location of WorkFrame/2 Version 1.1 in the initialization file cannot be found. This directory may have been deleted or renamed. Some of the C/C++ Tools files provide support for the WorkFrame/2 product. If WorkFrame/2 Version 1.1 has been installed, the C/C++ Tools installation program: 1. Installs the WorkFrame/2 sample files 2. Modifies the sample project file and copies it to the WorkFrame/2 directory 3. Copies the language profile to the WorkFrame/2 directory 4. Backs up the existing project files 5. Adds the Browser and EXTRA to the WorkFrame/2 1.1 tools list If WorkFrame/2 Version 1.1 has not been installed, only the first action is performed. ═══ Message Help ═══ The directory that specifies the location of WorkFrame/2 Version 2.0 in the initialization file cannot be found. This directory may have been deleted or renamed. Some of the C/C++ Tools files provide support for the WorkFrame/2 product. If WorkFrame/2 Version 2.0 has already been installed, the C/C++ Tools installation program: 1. Installs the WorkFrame/2 sample files 2. Creates sample object (composite and base) inside the C/C++ Tools folder 3. Creates C/C++ action profile object inside the C/C++ Tools folder 4. Adds the Browser and EXTRA to the existing action profile If WorkFrame/2 2.0 has not been installed, only the first action is performed. ═══ Message Help ═══ An operating-system error occurred while the installation program was copying the indicated file. The OS/2* return code indicates the cause of the error. Make sure enough disk space is available and that the path specified is valid. Correct the error, and try the program again. ═══ Message Help ═══ One or more of the project control files for the IBM WorkFrame/2* sample programs is not valid. Try installing the WorkFrame/2 support again. If the problem persists, contact your IBM Service Representative. ═══ 45. Message Help ═══ The file CSET2.INI cannot be found on the path specified. This file was automatically created under the path of the last installation. Specify another path, and try again. ═══ 46. Message Help ═══ The CSET2.INI file that was found cannot be read. It may be corrupted. Verify that the path specified is correct, and try again. If the problem persists, reinstall the product. ═══ 47. Message Help ═══ The selections from the previous installation of the product cannot be found in the CSET2.INI file. Make sure the path specified is correct and try again. If the problem persists, install the product again to get back all infomation. ═══ 48. Message Help ═══ Click on Yes to ensure that the configuration will be recognized when the system is started. A file (CSETENV.CMD) with a minimal set of environment variables will be created for setting the environment after the system is started. Click on No to put most of the environment variables in CSETENV.CMD. You still must update the CONFIG.SYS file for LIBPATH. If you installed the Execution Trace Analyzer, you still must update the CONFIG.SYS file to include the DDE4XTRA.SYS device statement. ═══ 49. Message Help ═══ The installation program was not successful in updating the Desktop. There may not be enough memory available. ═══ 50. Message Help ═══ The file CONFIG.SYS has been updated. Click on Yes to edit the file. Click on No to accept the changes made by the installation program. ═══ 51. Message Help ═══ The C/C++ Tools V2.0 Desktop folder has been created or updated. ═══ 52. Message Help ═══ The Libraries and Documentation selection window is not closed. Verify that the desired options have been selected, and click on OK to close it. Click on Cancel to ignore any changes after the window has been opened. ═══ 53. Message Help ═══ A TMP environment variable with a different value was in the CONFIG.SYS file before installation updated the file. Only one temporary file directory is allowed for the C/C++ Compiler. The installation program added a variable with the installation default value at the end of the file. Edit the CONFIG.SYS file to delete one of the variables before the installation process ends. ═══ 54. Message Help ═══ An error occurred while you were trying to access the specified path. Verify that the path is correct, and try again. ═══ Message Help ═══ An operating-system error occurred while the installation program was running the XPACK.EXE program. Check the termination code returned by the operating system for the cause of the error: Code Cause of Error 1 Hard error 2 Trap operation 3 Unintercepted DosKillProcess. Correct the error, and try the operation again. ═══ Message Help ═══ Verify that the selections chosen in the previous installation, shown in the Main window, are correct. Click on Update to update the Desktop and configuration with these selections. To change the path of the C/C++ Tools installation, click on Cancel, then select Install Selections from the Options pull-down menu. ═══ 55. Message Help ═══ A DDE4XTRA.SYS DEVICE drive with a directory path different from C/C++ Tools was in the CONFIG.SYS file before installation updated the file. Only one DDE4XTRA.SYS is allowed at a time. The installation program added the DDE4XTRA.SYS DEVICE drive with the C/C++ Compiler Tools directory path to the end of the file. Edit the CONFIG.SYS to delete one of the DEVICE paths before the installation program ends. ═══ 56. OS/2* Return Code Help ═══ Select a range of Control Program error return codes: 0 to 99 100 to 199 200 to 299 300 to 399 400 to 499 500 to 548 639 to 731 2055 to 32904 65026 to 65079 ═══ 56.1. Return Codes 0 to 99 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 0 NO_ERROR No error occurred. 1 ERROR_INVALID_FUNCTION Invalid function number. 2 ERROR_FILE_NOT_FOUND File not found. 3 ERROR_PATH_NOT_FOUND Path not found. 4 ERROR_TOO_MANY_OPEN_FILES Too many open files (no handles left). 5 ERROR_ACCESS_DENIED Access denied. 6 ERROR_INVALID_HANDLE Invalid handle. 7 ERROR_ARENA_TRASHED Memory control blocks destroyed. 8 ERROR_NOT_ENOUGH_MEMORY Insufficient memory. 9 ERROR_INVALID_BLOCK Invalid memory-block address. 10 ERROR_BAD_ENVIRONMENT Invalid environment. 11 ERROR_BAD_FORMAT Invalid format. 12 ERROR_INVALID_ACCESS Invalid access code. 13 ERROR_INVALID_DATA Invalid data. 14 Reserved. 15 ERROR_INVALID_DRIVE Invalid drive specified. 16 ERROR_CURRENT_DIRECTORY Attempting to remove current directory. 17 ERROR_NOT_SAME_DEVICE Not same device. 18 ERROR_NO_MORE_FILES No more files. 19 ERROR_WRITE_PROTECT Attempt to write on write-protected diskette. 20 ERROR_BAD_UNIT Unknown unit. 21 ERROR_NOT_READY Drive not ready. 22 ERROR_BAD_COMMAND Unknown command. 23 ERROR_CRC Data error - cyclic redundancy check. 24 ERROR_BAD_LENGTH Invalid request structure length. 25 ERROR_SEEK Seek error. 26 ERROR_NOT_DOS_DISK Unknown media type. 27 ERROR_SECTOR_NOT_FOUND Sector not found. 28 ERROR_OUT_OF_PAPER Printer is out of paper. 29 ERROR_WRITE FAULT Write fault. 30 ERROR_READ_FAULT Read fault. 31 ERROR_GEN_FAILURE General failure. 32 ERROR_SHARING_VIOLATION Sharing violation. 33 ERROR_LOCK_VIOLATION Lock violation. 34 ERROR_WRONG_DISK Invalid disk change. 35 ERROR_FCB_UNAVAILABLE FCB unavailable. 36 ERROR_SHARING_BUFFER_EXCEEDED Sharing buffer overflow. 37 ERROR_CODE_PAGE_MISMATCHED Code page does not match. 38 ERROR_HANDLE_EOF End of file reached. 39 ERROR_HANDLE_DISK_FULL Disk is full. 40-49 Reserved. 50 ERROR_NOT_SUPPORTED Network request not supported. 51 ERROR_REM_NOT_LIST Remote network node is not online. 52 ERROR_DUP_NAME Duplicate file name in network. 53 ERROR_BAD_NETPATH Network path not found. 54 ERROR_NETWORK_BUSY Network is busy. 55 ERROR_DEV_NOT_EXIST Device is not installed in network. 56 ERROR_TOO_MANY_CMDS Network command limit reached. 57 ERROR_ADAP_HDW_ERR Network adapter hardware error. 58 ERROR_BAD_NET_RESP Incorrect response in network. 59 ERROR_UNEXP_NET_ERR Unexpected error in network. 60 ERROR_BAD_REM_ADAP Remote network adapter error. 61 ERROR_PRINTQ_FULL Network printer queue is full. 62 ERROR_NO_SPOOL_SPACE No space in print spool file. 63 ERROR_PRINT_CANCELLED Print spool file deleted. 64 ERROR_NETNAME_DELETED Network name deleted. 65 ERROR_NETWORK_ACCESS_DENIED Access to network denied. 66 ERROR_BAD_DEV_TYPE Device type invalid for network. 67 ERROR_BAD_NET_NAME Network name not found. 68 ERROR_TOO_MANY_NAMES Network name limit exceeded. 69 ERROR_TOO_MANY_SESS Network session limit exceeded. 70 ERROR_SHARING_PAUSED Temporary pause in network. 71 ERROR_REQ_NOT_ACCEP Network request denied. 72 ERROR_REDIR_PAUSED Pause in network print disk redirection. 73 ERROR_SBCS_ATT_WRITE_PROT Attempted write on protected disk. 74 ERROR_SBCS_GENERAL_FAILURE General failure, single-byte character set. 75-79 Reserved. 80 ERROR_FILE_EXISTS File exists. 81 ERROR_DUP_FCB Reserved. 82 ERROR_CANNOT_MAKE Cannot make directory entry. 83 ERROR_FAIL_I24 Failure on INT 24. 84 ERROR_OUT_OF_STRUCTURES Too many redirections. 85 ERROR_ALREADY_ASSIGNED Duplicate redirection. 86 ERROR_INVALID_PASSWORD Invalid password. 87 ERROR_INVALID_PARAMETER Invalid parameter. 88 ERROR_NET_WRITE_FAULT Network device fault. 89 ERROR_NO_PROC_SLOTS No process slots available. 90 ERROR_NOT_FROZEN System error. 91 ERR_TSTOVFL Timer service table overflow. 92 ERR_TSTDUP Timer service table duplicate. 93 ERROR_NO_ITEMS No items to work on. 95 ERROR_INTERRUPT Interrupted system call. 99 ERROR_DEVICE_IN_USE Device in use. ═══ 56.2. Return Codes 100 to 199 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 100 ERROR_TOO_MANY_SEMAPHORES User/system open semaphore limit reached. 101 ERROR_EXCL_SEM_ALREADY_OWNED Exclusive semaphore already owned. 102 ERROR_SEM_IS_SET DosCloseSem found semaphore set. 103 ERROR_TOO_MANY_SEM_REQUESTS Too many exclusive semaphore requests. 104 ERROR_INVALID_AT_INTERRUPT_TIME Operation invalid at interrupt time. 105 ERROR_SEM_OWNER_DIED Previous semaphore owner terminated without freeing semaphore. 106 ERROR_SEM_USER_LIMIT Semaphore limit exceeded. 107 ERROR_DISK_CHANGE Insert drive B disk into drive A. 108 ERROR_DRIVE_LOCKED Drive locked by another process. 109 ERROR_BROKEN_PIPE Write on pipe with no reader. 110 ERROR_OPEN_FAILED Open/create failed due to explicit fail command. 111 ERROR_BUFFER_OVERFLOW Buffer passed to system call too small to hold return data. 112 ERROR_DISK_FULL Not enough space on the disk. 113 ERROR_NO_MORE_SEARCH_HANDLES Cannot allocate another search structure and handle. 114 ERROR_INVALID_TARGET_HANDLE Target handle in DosDupHandle invalid. 115 ERROR_PROTECTION_VIOLATION Invalid user virtual address. 116 ERROR_VIOKBD_REQUEST Error on display write or keyboard read. 117 ERROR_INVALID_CATEGORY Category for DevIOCtl not defined. 118 ERROR_INVALID_VERIFY_SWITCH Invalid value passed for verify flag. 119 ERROR_BAD_DRIVER_LEVEL Level four driver not found. 120 ERROR_CALL_NOT_IMPLEMENTED Invalid function called. 121 ERROR_SEM_TIMEOUT Time-out occurred from semaphore API function. 122 ERROR_INSUFFICIENT_BUFFER Data buffer too small. 123 ERROR_INVALID_NAME Illegal character or invalid file-system name. 124 ERROR_INVALID_LEVEL Non-implemented level for information retrieval or setting. 125 ERROR_NO_VOLUME_LABEL No volume label found with DosQueryFSInfo function. 126 ERROR_MOD_NOT_FOUND Module handle not found with getprocaddr, getmodhandle. 127 ERROR_PROC_NOT_FOUND Procedure address not found with getprocaddr. 128 ERROR_WAIT_NO_CHILDREN DosWaitChild finds no children. 129 ERROR_CHILD_NOT_COMPLETE DosWaitChild children not terminated. 130 ERROR_DIRECT_ACCESS_HANDLE Handle operation invalid for direct disk-access handles. 131 ERROR_NEGATIVE_SEEK Attempting seek to negative offset. 132 ERROR_SEEK_ON_DEVICE Application trying to seek on device or pipe. 133 ERROR_IS_JOIN_TARGET Drive has previously joined drives. 134 ERROR_IS_JOINED Drive is already joined. 135 ERROR_IS_SUBSTED Drive is already substituted. 136 ERROR_NOT_JOINED Cannot delete drive that is not joined. 137 ERROR_NOT_SUBSTED Cannot delete drive that is not substituted. 138 ERROR_JOIN_TO_JOIN Cannot join to a joined drive. 139 ERROR_SUBST_TO_SUBST Cannot substitute to a substituted drive. 140 ERROR_JOIN_TO_SUBST Cannot join to a substituted drive. 141 ERROR_SUBST_TO_JOIN Cannot substitute to a joined drive. 142 ERROR_BUSY_DRIVE Specified drive is busy. 143 ERROR_SAME_DRIVE Cannot join or substitute a drive to a directory on the same drive. 144 ERROR_DIR_NOT_ROOT Directory must be a subdirectory of the root. 145 ERROR_DIR_NOT_EMPTY Directory must be empty to use join command. 146 ERROR_IS_SUBST_PATH Path specified is being used in a substitute. 147 ERROR_IS_JOIN_PATH Path specified is being used in a join. 148 ERROR_PATH_BUSY Path specified is being used by another process. 149 ERROR_IS_SUBST_TARGET Cannot join or substitute a drive that has a directory that is the target of a previous substitute. 150 ERROR_SYSTEM_TRACE System trace error. 151 ERROR_INVALID_EVENT_COUNT DosWaitMuxWaitSem errors. 152 ERROR_TOO_MANY_MUXWAITERS System limit of 100 entries reached. 153 ERROR_INVALID_LIST_FORMAT Invalid list format. 154 ERROR_LABEL_TOO_LONG Volume label too big. 155 ERROR_TOO_MANY_TCBS Cannot create another TCB. 156 ERROR_SIGNAL_REFUSED Signal refused. 157 ERROR_DISCARDED Segment is discarded. 158 ERROR_NOT_LOCKED Segment is not locked. 159 ERROR_BAD_THREADID_ADDR Invalid thread-identity address. 160 ERROR_BAD_ARGUMENTS Invalid environment pointer. 161 ERROR_BAD_PATHNAME Invalid path name passed to exec. 162 ERROR_SIGNAL_PENDING Signal already pending. 163 ERROR_UNCERTAIN_MEDIA Error with INT 24 mapping. 164 ERROR_MAX_THRDS_REACHED No more process slots. 165 ERROR_MONITORS_NOT_SUPPORTED Error with INT 24 mapping. 166 ERROR_UNC_DRIVER_NOT_INSTALLED Default redirection return code. 167 ERROR_LOCK_FAILED Locking failed. 168 ERROR_SWAPIO_FAILED Swap I/O failed. 169 ERROR_SWAPIN_FAILED Swap in failed. 170 ERROR_BUSY Segment is busy. 171-172 Reserved. 173 ERROR_CANCEL_VIOLATION A lock request is not outstanding for the specified file range, or the range length is zero. 174 ERROR_ATOMIC_LOCK_NOT_SUPPORTED The file-system driver (FSD) does not support atomic lock operations. Versions of OS/2* prior to version 2.00 do not support atomic lock operations. 175 ERROR_READ_LOCKS_NOT_SUPPORTED The file system driver (FSD) does not support shared read locks. 176-179 Reserved. 180 ERROR_INVALID_SEGMENT_NUMBER Invalid segment number. 181 ERROR_INVALID_CALLGATE Invalid call gate. 182 ERROR_INVALID_ORDINAL Invalid ordinal. 183 ERROR_ALREADY_EXISTS Shared segment already exists. 184 ERROR_NO_CHILD_PROCESS No child process to wait for. 185 ERROR_CHILD_ALIVE_NOWAIT NoWait specified and child alive. 186 ERROR_INVALID_FLAG_NUMBER Invalid flag number. 187 ERROR_SEM_NOT_FOUND Semaphore does not exist. 188 ERROR_INVALID_STARTING_CODESEG Invalid starting code segment, incorrect END (label) directive. 189 ERROR_INVALID_STACKSEG Invalid stack segment. 190 ERROR_INVALID_MODULETYPE Invalid module type - dynamic-link library file cannot be used as an application. Application cannot be used as a dynamic-link library. 191 ERROR_INVALID_EXE_SIGNATURE Invalid EXE signature - file is a DOS mode program or an improper program. 192 ERROR_EXE_MARKED_INVALID EXE marked invalid - link detected errors when the application was created. 193 ERROR_BAD_EXE_FORMAT Invalid EXE format - file is a DOS mode program or an improper program. 194 ERROR_ITERATED_DATA_EXCEEDS_64K Iterated data exceeds 64KB - there is more than 64KB of data in one of the segments of the file. 195 ERROR_INVALID_MINALLOCSIZE Invalid minimum allocation size - the size is specified to be less than the size of the segment data in the file. 196 ERROR_DYNLINK_FROM_INVALID_RING Dynamic link from invalid privilege level - privilege level 2 routine cannot link to dynamic-link libraries. 197 ERROR_IOPL_NOT_ENABLED IOPL not enabled - IOPL set to NO in CONFIG.SYS. 198 ERROR_INVALID_SEGDPL Invalid segment descriptor privilege level - can only have privilege levels of 2 and 3. 199 ERROR_AUTODATASEG_EXCEEDS_64k Automatic data segment exceeds 64KB. ═══ 56.3. Return Codes 200 to 299 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 200 ERROR_RING2SEG_MUST_BE_MOVABLE Privilege level 2 segment must be movable. 201 ERROR_RELOC_CHAIN_XEEDS_SEGLIM Relocation chain exceeds segment limit. 202 ERROR_INFLOOP_IN_RELOC_CHAIN Infinite loop in relocation chain segment. 203 ERROR_ENVVAR_NOT_FOUND Environment variable not found. 204 ERROR_NOT_CURRENT_CTRY Not current country. 205 ERROR_NO_SIGNAL_SENT No signal sent - no process in the command subtree has a signal handler. 206 ERROR_FILENAME_EXCED_RANGE File name or extension is greater than 8.3 characters. 207 ERROR_RING2_STACK_IN_USE Privilege level 2 stack is in use. 208 ERROR_META_EXPANSION_TOO_LONG Meta (global) expansion is too long. 209 ERROR_INVALID_SIGNAL_NUMBER Invalid signal number. 210 ERROR_THREAD_1_INACTIVE Inactive thread. 211 ERROR_INFO_NOT_AVAIL File system information is not available for this file. 212 ERROR_LOCKED Locked error. 213 ERROR_BAD_DYNALINK Attempted to execute a non-family API in DOS mode. 214 ERROR_TOO_MANY_MODULES Too many modules. 215 ERROR_NESTING_NOT_ALLOWED Nesting is not allowed. 217 ERROR_ZOMBIE_PROCESS Zombie process. 218 ERROR_STACK_IN_HIGH_MEMORY Stack is in high memory. 219 ERROR_INVALID_EXITROUTINE_RING Invalid exit routine ring. 220 ERROR_GETBUF_FAILED Get buffer failed. 221 ERROR_FLUSHBUF_FAILED Flush buffer failed. 222 ERROR_TRANSFER_TOO_LONG Transfer is too long. 224 ERROR_SMG_NO_TARGET_WINDOW The application window was created without the FCF_TASKLIST style, or the application window not yet been created or has already been destroyed. 228 ERROR_NO_CHILDREN No child process. 229 ERROR_INVALID_SCREEN_GROUP Invalid session. 230 ERROR_BAD_PIPE Non-existent pipe or invalid operation. 231 ERROR_PIPE_BUSY Pipe is busy. 232 ERROR_NO_DATA No data available on non-blocking read. 233 ERROR_PIPE_NOT_CONNECTED Pipe was disconnected by server. 234 ERROR_MORE_DATA More data is available. 240 ERROR_VC_DISCONNECTED Session was dropped due to errors. 250 ERROR_CIRCULARITY_REQUESTED Renaming a directory that would cause a circularity problem. 251 ERROR_DIRECTORY_IN_CDS Renaming a directory that is in use. 252 ERROR_INVALID_FSD_NAME Trying to access nonexistent FSD. 253 ERROR_INVALID_PATH Invalid pseudo device. 254 ERROR_INVALID_EA_NAME Invalid character in name, or invalid cbName. 255 ERROR_EA_LIST_INCONSISTENT List does not match its size, or there are invalid EAs in the list. 256 ERROR_EA_LIST_TOO_LONG FEAList is longer than 64K-1 bytes. 257 ERROR_NO_META_MATCH String does not match expression. 259 ERROR_NO_MORE_ITEMS DosQueryFSAttach ordinal query. 260 ERROR_SEARCH_STRUC_REUSED DOS mode findfirst/next search structure reused. 261 ERROR_CHAR_NOT_FOUND Character not found. 262 ERROR_TOO_MUCH_STACK Stack request exceeds system limit. 263 ERROR_INVALID_ATTR Invalid attribute. 264 ERROR_INVALID_STARTING_RING Invalid starting ring. 265 ERROR_INVALID_DLL_INIT_RING Invalid DLL INIT ring. 266 ERROR_CANNOT_COPY Cannot copy. 267 ERROR_DIRECTORY Used by DOSCOPY in doscall1. 268 ERROR_OPLOCKED_FILE Oplocked file. 269 ERROR_OPLOCK_THREAD_EXISTS Oplock thread exists. 270 ERROR_VOLUME_CHANGED Volume changed. 271-273 Reserved. 274 ERROR_ALREADY_SHUTDOWN System is already shut down. 275 ERROR_EAS_DIDNT_FIT Buffer is not big enough to hold the EAs. 276 ERROR_EA_FILE_CORRUPT EA file has been damaged. 277 ERROR_EA_TABLE_FULL EA table is full. 278 ERROR_INVALID_EA_HANDLE EA handle is invalid. 279 ERROR_NO_CLUSTER No cluster. 280 ERROR_CREATE_EA_FILE Cannot create the EA file. 281 ERROR_CANNOT_OPEN_EA_FILE Cannot open the EA file. 282 ERROR_EAS_NOT_SUPPORTED Destination file system does not support EAs. 283 ERROR_NEED_EAS_FOUND Destination file system does not support EAs, and the source file's EAs contain a need EA. 284 ERROR_DUPLICATE_HANDLE The handle already exists. 285 ERROR_DUPLICATE_NAME The name already exists. 286 ERROR_EMPTY_MUXWAIT The list of semaphores in a muxwait semaphore is empty. 287 ERROR_MUTEX_OWNED The calling thread owns one or more of the mutex semaphores in the list. 288 ERROR_NOT_OWNER Caller does not own the semaphore. 289 ERROR_PARAM_TOO_SMALL Parameter is not large enough to contain all of the semaphore records in the muxwait semaphore. 290 ERROR_TOO_MANY_HANDLES Limit reached for number of handles. 291 ERROR_TOO_MANY_OPENS There are too many files or semaphores open. 292 ERROR_WRONG_TYPE Attempted to create wrong type of semaphore. 293 ERROR_UNUSED_CODE Code is not used. 294 ERROR_THREAD_NOT_TERMINATED Thread has not terminated. 295 ERROR_INIT_ROUTINE_FAILED Initialization routine failed. 296 ERROR_MODULE_IN_USE Module is in use. 297 ERROR_NOT_ENOUGH_WATCHPOINTS There are not enough watchpoints. 298 ERROR_TOO_MANY_POSTS Post count limit was reached for an event semaphore. 299 ERROR_ALREADY_POSTED Event semaphore is already posted. ═══ 56.4. Return Codes 300 to 399 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 300 ERROR_ALREADY_RESET Event semaphore is already reset. 301 ERROR_SEM_BUSY Semaphore is busy. 302 Reserved 303 ERROR_INVALID_PROCID Invalid process identity. 304 ERROR_INVALID_PDELTA Invalid priority delta. 305 ERROR_NOT_DESCENDANT Not descendant. 306 ERROR_NOT_SESSION_MANAGER Requestor not session manager. 307 ERROR_INVALID_PCLASS Invalid P class. 308 ERROR_INVALID_SCOPE Invalid scope. 309 ERROR_INVALID_THREADID Invalid thread identity. 310 ERROR_DOSSUB_SHRINK Cannot shrink segment - DosSubSetMem. 311 ERROR_DOSSUB_NOMEM No memory to satisfy request - DosSubAllocMem. 312 ERROR_DOSSUB_OVERLAP Overlap of the specified block with a block of allocated memory - DosSubFreeMem. 313 ERROR_DOSSUB_BADSIZE Invalid size parameter - DosSubAllocMem or DosSubFreeMem. 314 ERROR_DOSSUB_BADFLAG Invalid flag parameter - DosSubSetMem. 315 ERROR_DOSSUB_BADSELECTOR Invalid segment selector. 316 ERROR_MR_MSG_TOO_LONG Message too long for buffer. 317 ERROR_MR_MID_NOT_FOUND Message identity number not found. 318 ERROR_MR_UN_ACC_MSGF Unable to access message file. 319 ERROR_MR_INV_MSGF_FORMAT Invalid message file format. 320 ERROR_MR_INV_IVCOUNT Invalid insertion variable count. 321 ERROR_MR_UN_PERFORM Unable to perform function. 322 ERROR_TS_WAKEUP Unable to wake up. 323 ERROR_TS_SEMHANDLE Invalid system semaphore. 324 ERROR_TS_NOTIMER No timers available. 326 ERROR_TS_HANDLE Invalid timer handle. 327 ERROR_TS_DATETIME Date or time invalid. 328 ERROR_SYS_INTERNAL Internal system error. 329 ERROR_QUE_CURRENT_NAME Current queue name does not exist. 330 ERROR_QUE_PROC_NOT_OWNED Current process does not own queue. 331 ERROR_QUE_PROC_OWNED Current process owns queue. 332 ERROR_QUE_DUPLICATE Duplicate queue name. 333 ERROR_QUE_ELEMENT_NOT_EXIST Queue element does not exist. 334 ERROR_QUE_NO_MEMORY Inadequate queue memory. 335 ERROR_QUE_INVALID_NAME Invalid queue name. 336 ERROR_QUE_INVALID_PRIORITY Invalid queue priority parameter. 337 ERROR_QUE_INVALID_HANDLE Invalid queue handle. 338 ERROR_QUE_LINK_NOT_FOUND Queue link not found. 339 ERROR_QUE_MEMORY_ERROR Queue memory error. 340 ERROR_QUE_PREV_AT_END Previous queue element was at end of queue. 341 ERROR_QUE_PROC_NO_ACCESS Process does not have access to queues. 342 ERROR_QUE_EMPTY Queue is empty. 343 ERROR_QUE_NAME_NOT_EXIST Queue name does not exist. 344 ERROR_QUE_NOT_INITIALIZED Queues not initialized. 345 ERROR_QUE_UNABLE_TO_ACCESS Unable to access queues. 346 ERROR_QUE_UNABLE_TO_ADD Unable to add new queue. 347 ERROR_QUE_UNABLE_TO_INIT Unable to initialize queues. 349 ERROR_VIO_INVALID_MASK Invalid function replaced. 350 ERROR_VIO_PTR Invalid pointer to parameter. 351 ERROR_VIO_APTR Invalid pointer to attribute. 352 ERROR_VIO_RPTR Invalid pointer to row. 353 ERROR_VIO_CPTR Invalid pointer to column. 354 ERROR_VIO_LPTR Invalid pointer to length. 355 ERROR_VIO_MODE Unsupported screen mode. 356 ERROR_VIO_WIDTH Invalid cursor width value. 357 ERROR_VIO_ATTR Invalid cursor attribute value. 358 ERROR_VIO_ROW Invalid row value. 359 ERROR_VIO_COL Invalid column value. 360 ERROR_VIO_TOPROW Invalid TopRow value. 361 ERROR_VIO_BOTROW Invalid BotRow value. 362 ERROR_VIO_RIGHTCOL Invalid right column value. 363 ERROR_VIO_LEFTCO Invalid left column value. 364 ERROR_SCS_CALL Call issued by other than session manager. 365 ERROR_SCS_VALUE Value is not for save or restore. 366 ERROR_VIO_WAIT_FLAG Invalid wait flag setting. 367 ERROR_VIO_UNLOCK Screen not previously locked. 368 ERROR_SGS_NOT_SESSION_MGR Caller not session manager. 369 ERROR_SMG_INVALID_SGID Invalid session identity. 369 ERROR_SMG_INVALID_SESSION_ID Invalid session ID. 370 ERROR_SMG_NOSG No sessions available. 370 ERROR_SMG_NO_SESSIONS No sessions available. 371 ERROR_SMG_GRP_NOT_FOUND Session not found. 371 ERROR_SMG_SESSION_NOT_FOUND Session not found. 372 ERROR_SMG_SET_TITLE Title sent by shell or parent cannot be changed. 373 ERROR_KBD_PARAMETER Invalid parameter to keyboard. 374 ERROR_KBD_NO_DEVICE No device. 375 ERROR_KBD_INVALID_IOWAIT Invalid I/O wait specified. 376 ERROR_KBD_INVALID_LENGTH Invalid length for keyboard. 377 ERROR_KBD_INVALID_ECHO_MASK Invalid echo mode mask. 378 ERROR_KBD_INVALID_INPUT_MASK Invalid input mode mask. 379 ERROR_MON_INVALID_PARMS Invalid parameters to DosMon. 380 ERROR_MON_INVALID_DEVNAME Invalid device name string. 381 ERROR_MON_INVALID_HANDLE Invalid device handle. 382 ERROR_MON_BUFFER_TOO_SMALL Buffer too small. 383 ERROR_MON_BUFFER_EMPTY Buffer is empty. 384 ERROR_MON_DATA_TOO_LARGE Data record is too large. 385 ERROR_MOUSE_NO_DEVICE Mouse device closed (invalid device handle). 386 ERROR_MOUSE_INV_HANDLE Mouse device closed (invalid device handle). 387 ERROR_MOUSE_INV_PARMS Parameters invalid for display mode. 388 ERROR_MOUSE_CANT_RESET Function assigned and cannot be reset. 389 ERROR_MOUSE_DISPLAY_PARMS Parameters invalid for display mode. 390 ERROR_MOUSE_INV_MODULE Module not valid. 391 ERROR_MOUSE_INV_ENTRY_PT Entry point not valid. 392 ERROR_MOUSE_INV_MASK Function mask invalid. 393 NO_ERROR_MOUSE_NO_DATA No valid data. 394 NO_ERROR_MOUSE_PTR_DRAWN Pointer drawn. 395 ERROR_INVALID_FREQUENCY Invalid frequency for beep. 396 ERROR_NLS_NO_COUNTRY_FILE Cannot find COUNTRY.SYS file. 397 ERROR_NLS_OPEN_FAILED Cannot open COUNTRY.SYS file. 398 ERROR_NLS_NO_CTRY_CODE Country code not found. 398 ERROR_NO_COUNTRY_OR_CODEPAGE Country code not found. 399 ERROR_NLS_TABLE_TRUNCATED Table returned information truncated, buffer is too small. ═══ 56.5. Return Codes 400 to 499 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 400 ERROR_NLS_BAD_TYPE Selected type does not exist. 401 ERROR_NLS_TYPE_NOT_FOUND Selected type is not in file. 402 ERROR_VIO_SMG_ONLY Valid from session manager only. 403 ERROR_VIO_INVALID_ASCIIZ Invalid ASCIIZ length. 404 ERROR_VIO_DEREGISTER VioDeRegister not allowed. 405 ERROR_VIO_NO_POPUP Pop-up window not allocated. 406 ERROR_VIO_EXISTING_POPUP Pop-up window on screen (NoWait). 407 ERROR_KBD_SMG_ONLY Valid from session manager only. 408 ERROR_KBD_INVALID_ASCIIZ Invalid ASCIIZ length. 409 ERROR_KBD_INVALID_MASK Invalid replacement mask. 410 ERROR_KBD_REGISTER KbdRegister not allowed. 411 ERROR_KBD_DEREGISTER KbdDeRegister not allowed. 412 ERROR_MOUSE_SMG_ONLY Valid from session manager only. 413 ERROR_MOUSE_INVALID_ASCIIZ Invalid ASCIIZ length. 414 ERROR_MOUSE_INVALID_MASK Invalid replacement mask. 415 ERROR_MOUSE_REGISTER Mouse register not allowed. 416 ERROR_MOUSE_DEREGISTER Mouse deregister not allowed. 417 ERROR_SMG_BAD_ACTION Invalid action specified. 418 ERROR_SMG_INVALID_CALL INIT called more than once, or invalid session identity. 419 ERROR_SCS_SG_NOTFOUND New session number. 420 ERROR_SCS_NOT_SHELL Caller is not shell. 421 ERROR_VIO_INVALID_PARMS Invalid parameters passed. 422 ERROR_VIO_FUNCTION_OWNED Save/restore already owned. 423 ERROR_VIO_RETURN Non-destruct return (undo). 424 ERROR_SCS_INVALID_FUNCTION Caller invalid function. 425 ERROR_SCS_NOT_SESSION_MGR Caller not session manager. 426 ERROR_VIO_REGISTER Vio register not allowed. 427 ERROR_VIO_NO_MODE_THREAD No mode restore thread in SG. 428 ERROR_VIO_NO_SAVE_RESTORE_THD No save/restore thread in SG. 429 ERROR_VIO_IN_BG Function invalid in background. 430 ERROR_VIO_ILLEGAL_DURING_POPUP Function not allowed during pop-up window. 431 ERROR_SMG_NOT_BASESHELL Caller is not the base shell. 432 ERROR_SMG_BAD_STATUSREQ Invalid status requested. 433 ERROR_QUE_INVALID_WAIT NoWait parameter out of bounds. 434 ERROR_VIO_LOCK Error returned from Scroll Lock. 435 ERROR_MOUSE_INVALID_IOWAIT Invalid parameters for IOWait. 436 ERROR_VIO_INVALID_HANDLE Invalid VIO handle. 437 ERROR_VIO_ILLEGAL_DURING_LOCK Function not allowed during screen lock. 438 ERROR_VIO_INVALID_LENGTH Invalid VIO length. 439 ERROR_KBD_INVALID_HANDLE Invalid KBD handle. 440 ERROR_KBD_NO_MORE_HANDLE Ran out of handles. 441 ERROR_KBD_CANNOT_CREATE_KCB Unable to create kcb. 442 ERROR_KBD_CODEPAGE_LOAD_INCOMPL Unsuccessful code-page load. 443 ERROR_KBD_INVALID_CODEPAGE_ID Invalid code-page identity. 444 ERROR_KBD_NO_CODEPAGE_SUPPORT No code page support. 445 ERROR_KBD_FOCUS_REQUIRED Keyboard focus required. 446 ERROR_KBD_FOCUS_ALREADY_ACTIVE Calling thread has an outstanding focus. 447 ERROR_KBD_KEYBOARD_BUSY Keyboard is busy. 448 ERROR_KBD_INVALID_CODEPAGE Invalid code page. 449 ERROR_KBD_UNABLE_TO_FOCUS Focus attempt failed. 450 ERROR_SMG_SESSION_NON_SELECT Session is not selectable. 451 ERROR_SMG_SESSION_NOT_FOREGRND Parent/child session is not foreground. 452 ERROR_SMG_SESSION_NOT_PARENT Not parent of requested child. 453 ERROR_SMG_INVALID_START_MODE Invalid session start mode. 454 ERROR_SMG_INVALID_RELATED_OPT Invalid session start related option. 455 ERROR_SMG_INVALID_BOND_OPTION Invalid session bond option. 456 ERROR_SMG_INVALID_SELECT_OPT Invalid session select option. 457 ERROR_SMG_START_IN_BACKGROUND Session started in background. 458 ERROR_SMG_INVALID_STOP_OPTION Invalid session stop option. 459 ERROR_SMG_BAD_RESERVE Reserved parameters are not zero. 460 ERROR_SMG_PROCESS_NOT_PARENT Session parent process already exists. 461 ERROR_SMG_INVALID_DATA_LENGTH Invalid data length. 462 ERROR_SMG_NOT_BOUND Parent is not bound. 463 ERROR_SMG_RETRY_SUB_ALLOC Retry request block allocation. 464 ERROR_KBD_DETACHED This call is not allowed for a detached PID. 465 ERROR_VIO_DETACHED This call is not allowed for a detached PID. 466 ERROR_MOU_DETACHED This call is not allowed for a detached PID. 467 ERROR_VIO_FONT No font is available to support the mode. 468 ERROR_VIO_USER_FONT User font is active. 469 ERROR_VIO_BAD_CP Invalid code page specified. 470 ERROR_VIO_NO_CP System displays do not support code page. 471 ERROR_VIO_NA_CP Current display does not support code page. 472 ERROR_INVALID_CODE_PAGE Invalid code page. 473 ERROR_CPLIST_TOO_SMALL Code page list is too small. 474 ERROR_CP_NOT_MOVED Code page was not moved. 475 ERROR_MODE_SWITCH_INIT Mode switch initialization error. 476 ERROR_CODE_PAGE_NOT_FOUND Code page was not found. 477 ERROR_UNEXPECTED_SLOT_RETURNED Internal error. 478 ERROR_SMG_INVALID_TRACE_OPTION Invalid start session trace indicator. 479 ERROR_VIO_INTERNAL_RESOURCE VIO internal resource error. 480 ERROR_VIO_SHELL_INIT VIO shell initialization error. 481 ERROR_SMG_NO_HARD_ERRORS No session manager hard errors. 482 ERROR_CP_SWITCH_INCOMPLETE DosSetProcessCp is unable to set a KBD or VIO code page. 483 ERROR_VIO_TRANSPARENT_POPUP Error during VIO pop-up window. 484 ERROR_CRITSEC_OVERFLOW Critical section overflow. 485 ERROR_CRITSEC_UNDERFLOW Critical section underflow. 486 ERROR_VIO_BAD_RESERVE Reserved parameter is not zero. 487 ERROR_INVALID_ADDRESS Invalid physical address. 488 ERROR_ZERO_SELECTORS_REQUESTED At least one selector must be requested. 489 ERROR_NOT_ENOUGH_SELECTORS_AVA Not enough GDT selectors to satisfy request. 490 ERROR_INVALID_SELECTOR Not a GDT selector. 491 ERROR_SMG_INVALID_PROGRAM_TYPE Invalid program type. 492 ERROR_SMG_INVALID_PGM_CONTROL Invalid program control. 493 ERROR_SMG_INVALID_INHERIT_OPT Invalid inherit option. 494 ERROR_VIO_EXTENDED_SG 495 ERROR_VIO_NOT_PRES_MGR_SG 496 ERROR_VIO_SHIELD_OWNED 497 ERROR_VIO_NO_MORE_HANDLES 498 ERROR_VIO_SEE_ERROR_LOG 499 ERROR_VIO_ASSOCIATED_DC ═══ 56.6. Return Codes 500 to 548 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 500 ERROR_KBD_NO_CONSOLE 501 ERROR_MOUSE_NO_CONSOLE 502 ERROR_MOUSE_INVALID_HANDLE 503 ERROR_SMG_INVALID_DEBUG_PARMS 504 ERROR_KBD_EXTENDED_SG 505 ERROR_MOU_EXTENDED_SG 506 ERROR_SMG_INVALID_ICON_FILE 507 ERROR_TRC_PID_NON_EXISTENT 508 ERROR_TRC_COUNT_ACTIVE 509 ERROR_TRC_SUSPENDED_BY_COUNT 510 ERROR_TRC_COUNT_INACTIVE 511 ERROR_TRC_COUNT_REACHED 512 ERROR_NO_MC_TRACE 513 ERROR_MC_TRACE 514 ERROR_TRC_COUNT_ZERO 515 ERROR_SMG_TOO_MANY_DDS 516 ERROR_SMG_INVALID_NOTIFICATION 517 ERROR_LF_INVALID_FUNCTION 518 ERROR_LF_NOT_AVAIL 519 ERROR_LF_SUSPENDED 520 ERROR_LF_BUF_TOO_SMALL 521 ERROR_LF_BUFFER_CORRUPTED 521 ERROR_LF_BUFFER_FULL 522 ERROR_LF_INVALID_DAEMON 522 ERROR_LF_INVALID_RECORD 523 ERROR_LF_INVALID_TEMPL 523 ERROR_LF_INVALID_SERVICE 524 ERROR_LF_GENERAL_FAILURE 525 ERROR_LF_INVALID_ID 526 ERROR_LF_INVALID_HANDLE 527 ERROR_LF_NO_ID_AVAIL 528 ERROR_LF_TEMPLATE_AREA_FULL 529 ERROR_LF_ID_IN_USE 530 ERROR_MOU_NOT_INITIALIZED 531 ERROR_MOUINITREAL_DONE 532 ERROR_DOSSUB_CORRUPTED 533 ERROR_MOUSE_CALLER_NOT_SUBSYS 534 ERROR_ARITHMETIC_OVERFLOW 535 ERROR_TMR_NO_DEVICE 536 ERROR_TMR_INVALID_TIME 537 ERROR_PVW_INVALID_ENTITY 538 ERROR_PVW_INVALID_ENTITY_TYPE 539 ERROR_PVW_INVALID_SPEC 540 ERROR_PVW_INVALID_RANGE_TYPE 541 ERROR_PVW_INVALID_COUNTER_BLK 542 ERROR_PVW_INVALID_TEXT_BLK 543 ERROR_PRF_NOT_INITIALIZED 544 ERROR_PRF_ALREADY_INITIALIZED 545 ERROR_PRF_NOT_STARTED 546 ERROR_PRF_ALREADY_STARTED 547 ERROR_PRF_TIMER_OUT_OF_RANGE 548 ERROR_PRF_TIMER_RESET ═══ 56.7. Return Codes 639 to 731 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 639 ERROR_VDD_LOCK_USEAGE_DENIED 640 ERROR_TIMEOUT 641 ERROR_VDM_DOWN 642 ERROR_VDM_LIMIT 643 ERROR_VDD_NOT_FOUND 644 ERROR_INVALID_CALLER 645 ERROR_PID_MISMATCH 646 ERROR_INVALID_VDD_HANDLE 647 ERROR_VLPT_NO_SPOOLER 648 ERROR_VCOM_DEVICE_BUSY 649 ERROR_VLPT_DEVICE_BUSY 650 ERROR_NESTING_TOO_DEEP 651 ERROR_VDD_MISSING 691 ERROR_IMP_INVALID_PARM 692 ERROR_IMP_INVALID_LENGTH 693 MSG_HPFS_DISK_ERROR_WARN 730 ERROR_MON_BAD_BUFFER 731 ERROR_MODULE_CORRUPTED ═══ 56.8. Return Codes 2055 to 32904 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 2055 ERROR_LF_TIMEOUT 2057 ERROR_LF_SUSPEND_SUCCESS 2058 ERROR_LF_RESUME_SUCCESS 2059 ERROR_LF_REDIRECT_SUCCESS 2060 ERROR_LF_REDIRECT_FAILURE 32768 ERROR_SWAPPER_NOT_ACTIVE 32769 ERROR_INVALID_SWAPID 32770 ERROR_IOERR_SWAP_FILE 32771 ERROR_SWAP_TABLE_FULL 32772 ERROR_SWAP_FILE_FULL 32773 ERROR_CANT_INIT_SWAPPER 32774 ERROR_SWAPPER_ALREADY_INIT dd. 32775 ERROR_PMM_INSUFFICIENT_MEMORY 32776 ERROR_PMM_INVALID_FLAGS 32777 ERROR_PMM_INVALID_ADDRESS 32778 ERROR_PMM_LOCK_FAILED 32779 ERROR_PMM_UNLOCK_FAILED 32780 ERROR_PMM_MOVE_INCOMPLETE 32781 ERROR_UCOM_DRIVE_RENAMED 32782 ERROR_UCOM_FILENAME_TRUNCATED 32783 ERROR_UCOM_BUFFER_LENGTH 32784 ERROR_MON_CHAIN_HANDLE 32785 ERROR_MON_NOT_REGISTERED 32786 ERROR_SMG_ALREADY_TOP 32787 ERROR_PMM_ARENA_MODIFIED 32788 ERROR_SMG_PRINTER_OPEN 32789 ERROR_PMM_SET_FLAGS_FAILED 32790 ERROR_INVALID_DOS_DD 32791 ERROR_BLOCKED 32792 ERROR_NOBLOCK 32793 ERROR_INSTANCE_SHARED 32794 ERROR_NO_OBJECT 32795 ERROR_PARTIAL_ATTACH 32796 ERROR_INCACHE 32797 ERROR_SWAP_IO_PROBLEMS 32798 ERROR_CROSSES_OBJECT_BOUNDARY 32799 ERROR_LONGLOCK 32800 ERROR_SHORTLOCK 32801 ERROR_UVIRTLOCK 32802 ERROR_ALIASLOCK 32803 ERROR_ALIAS 32804 ERROR_NO_MORE_HANDLES 32805 ERROR_SCAN_TERMINATED 32806 ERROR_TERMINATOR_NOT_FOUND 32807 ERROR_NOT_DIRECT_CHILD 32808 ERROR_DELAY_FREE 32809 ERROR_GUARDPAGE 32900 ERROR_SWAPERROR 32901 ERROR_LDRERROR 32902 ERROR_NOMEMORY 32903 ERROR_NOACCESS 32904 ERROR_NO_DLL_TERM ═══ 56.9. Return Codes 65026 to 65079 ═══ The following shows the numerical value of an error, its symbolic name, and a brief description of the error. 65026 ERROR_CPSIO_CODE_PAGE_INVALID 65027 ERROR_CPSIO_NO_SPOOLER 65028 ERROR_CPSIO_FONT_ID_INVALID 65033 ERROR_CPSIO_INTERNAL_ERROR 65034 ERROR_CPSIO_INVALID_PTR_NAME 65037 ERROR_CPSIO_NOT_ACTIVE 65039 ERROR_CPSIO_PID_FULL 65040 ERROR_CPSIO_PID_NOT_FOUND 65043 ERROR_CPSIO_READ_CTL_SEQ 65045 ERROR_CPSIO_READ_FNT_DEF 65047 ERROR_CPSIO_WRITE_ERROR 65048 ERROR_CPSIO_WRITE_FULL_ERROR 65049 ERROR_CPSIO_WRITE_HANDLE_BAD 65074 ERROR_CPSIO_SWIT_LOAD 65077 ERROR_CPSIO_INV_COMMAND 65078 ERROR_CPSIO_NO_FONT_SWIT 65079 ERROR_ENTRY_IS_CALLGATE ═══ ═══ The following terms are trademarks of the IBM Corporation: BookManager C/C++ Tools V2.0 C Set/2 V1.0 IBM OS/2 SAA WorkFrame/2