home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / CPPICC30.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-06-02  |  84KB  |  2,594 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Notices ΓòÉΓòÉΓòÉ
  3.  
  4. References in this help to IBM products, programs, or services do not imply 
  5. that IBM intends to make these available in all countries in which IBM 
  6. operates. 
  7.  
  8. Any reference to an IBM licensed program in this help is not intended to state 
  9. or imply that only IBM's licensed program may be used.  Any functionally 
  10. equivalent product, program, or service that does not infringe on any of IBM's 
  11. intellectual property rights may be used instead of the IBM product, program, 
  12. or service. 
  13.  
  14. Evaluation and verification of operation in conjunction with other products, 
  15. except those expressly designated by IBM, is the user's responsibility. 
  16.  
  17. IBM may have patents or pending patent applications covering subject matter in 
  18. this help.  The furnishing of this help does not give you any license to these 
  19. patents. 
  20.  
  21. The following terms are trademarks of the IBM corporation in the United States 
  22. and/or other countries: 
  23.  
  24. BookManager
  25. C/2
  26. C Set/2
  27. C Set ++
  28. Common User Access
  29. CUA
  30. IBM
  31. LibraryReader
  32. Open Class
  33. Operating System/2
  34. OS/2
  35. OS/2 Warp
  36. Personal System/2
  37. PS/2
  38. Presentation Manager
  39. Systems Application Architecture
  40. SAA
  41. VisualAge
  42. WorkFrame
  43. WorkPlace Shell
  44. System Object Model
  45. SOM
  46.  
  47. Windows is a trademark of Microsoft Corporation. 
  48.  
  49. Pentium is a trademark of Intel Corporation. 
  50.  
  51. Other company, product, and service names, which may be denoted by a double 
  52. asterisk (**), may be trademarks of others. 
  53.  
  54. This publication contains examples of data and reports used in daily business 
  55. operations. To illustrate them as completely as possible, the examples include 
  56. the names of individuals, companies, brands, and products. All of these names 
  57. are fictitious and any similarity to the names and addresses used by an actual 
  58. business enterprise is entirely coincidental. 
  59.  
  60. Licensees of this program who wish to have information about it for the purpose 
  61. of enabling: (i) the exchange of information between independent created 
  62. programs and other programs (including this one) and (ii) the mutual use of the 
  63. information which has been exchanged, should contact IBM Canada Ltd., 
  64. Department 071, 1150 Eglinton Ave E., North York, ONT Canada M3C 1H7. Such 
  65. information may be available, subject to appropriate terms and conditions, 
  66. including in some cases, payment of a fee. 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ 2. C/C++ Compiler Options ΓòÉΓòÉΓòÉ
  70.  
  71. Use the Compiler Options notebook to select which set of compiler options you 
  72. want to change. 
  73.  
  74. You can set any of 10 option categories: 
  75.  
  76.      Processing 
  77.      File 
  78.      Listing 
  79.      Debugging 
  80.      Source 
  81.      Object 
  82.      Preprocessor 
  83.      Other 
  84.      User 
  85.      SOM 
  86.  
  87.  Some options have already been set to their default settings. You can change 
  88.  the default settings by clicking on them and selecting your preferred 
  89.  settings. 
  90.  
  91.  See Command-line equivalents for a mapping between command-line options and 
  92.  options set in WorkFrame. 
  93.  
  94.  
  95. ΓòÉΓòÉΓòÉ 3. Command-line equivalents ΓòÉΓòÉΓòÉ
  96.  
  97. Points to remember: 
  98.  
  99.      The options you set in WorkFrame apply to all files in the project or 
  100.       subproject they are set for. On the command line, an option applies to 
  101.       all files after it on the command line. In WorkFrame, if you want an 
  102.       option to apply to some files but not others, divide the files into two 
  103.       separate subprojects, and set that option at the subproject level. 
  104.      You can use command line syntax directly, in the User entry field on the 
  105.       User page. 
  106.  
  107.   OPTION  NOTEBOOK TAB    PAGE    CONTROL DESCRIPTION
  108.  
  109.   /B      Other           1       Parameters passed to linker
  110.   /C      Processing step 1       Perform compile only
  111.   /C-     Processing step 1       Compile and link
  112.   /D      Preprocessor    2       User macros: Define
  113.   /Fa     File            1       Assembler
  114.   /Fb     File            1       Browser info
  115.   /Fc     Processing step 1       Perform syntax check only
  116.   /Fe     File            1       Executable
  117.   /Fi     File            2       Precompiled header file
  118.   /Fm     File            1       Linker map
  119.   /Fo     File            1       Object
  120.   /Fr     SOM             1       Produce file: Release order
  121.   /Fs     SOM             1       Produce file: IDL
  122.   /Ft     File            1       Template
  123.   /Fw     File            1       Intermediate
  124.   /Fw     Processing step 1       Create intermediate files only
  125.   /G      Object          1       Target processor
  126.   /Ga     SOM             1       Implicit SOM mode
  127.   /Gb     SOM             1       Disable direct access to attributes
  128.   /Gd     Object          1       Library linkage
  129.   /Ge     Processing step 1       Target
  130.   /Gf     Object          3       Use fast floating point method
  131.   /Gh     Object          3       Enable performance analyser
  132.   /Gi     Object          3       Use fast integer method
  133.   /Gm     Object          1       Library selection
  134.   /Gn     Object          3       Do not generate default library info,
  135.   /Gr     Object          3       Generate code to run at ring 0
  136.   /Gs     Object          3       Remove stack probes
  137.   /Gt     Object          3       Use tiled memory
  138.   /Gu     Object          3       Remove unused data in intermediate files
  139.   /Gv     Object          2       Preserve DS and ES segments for VDD
  140.   /Gw     Object          3       Generate FWAIT after load
  141.   /Gx     Object          3       Remove C++ exception information
  142.   /Gz     SOM             1       Initialize during static initialization
  143.   /H      Other           1       Length of external names:
  144.   /I      File            2       Command line include path
  145.   /J      Other           1       Make default char type unsigned
  146.   /L      File            1       Listing
  147.   /La     Listing         1       Aggregate layout: Referenced
  148.   /Lb     Listing         1       Aggregate layout: All
  149.   /Le     Listing         1       Expand all macros
  150.   /Li     Listing         1       Expand include files: User
  151.   /Lj     Listing         1       Expand include files: User and system
  152.   /Lp     Listing         2       Page length
  153.   /Ls     Listing         1       Source
  154.   /Lt     Listing         2       Title
  155.   /Lu     Listing         2       Subtitle
  156.   /Lx     Listing         1       Cross reference: Referenced
  157.   /Ly     Listing         1       Cross reference: All
  158.   /Mp     Object          3       Use optlink linkage
  159.   /N      Debugging       1       Stop on error count of
  160.   /Nd     Object          2       Data segment
  161.   /Nt     Object          2       Code segment
  162.   /O      Object          2       Optimization: Speed
  163.   /Oc     Object          2       Optimization: Compact
  164.   /Oi     Object          2       Inline user code
  165.   /Ol     Object          3       Invoke intermediate code linker
  166.   /Om     Object          2       Limit working set size while optimizing
  167.   /Op     Object          2       Do not perform stack pointer optimization
  168.   /Os-    Object          2       Do not invoke the instruction scheduler
  169.   /P      Processing step 1       Run the preprocessor only
  170.   /Pc     Preprocessor    1       Retain comments
  171.   /Pd     Preprocessor    1       Send the output to stdout
  172.   /Pe     Preprocessor    1       No line numbers
  173.   /Q      Other           1       Display the logo
  174.   /R      Object          1       Executable environment
  175.   /S      Source          1       Language constructs
  176.   /Sd-    Source          2       Make .OBJ the default extension
  177.   /Sg     Source          2       Margins
  178.   /Sh     Source          2       Allow use of ddnames support
  179.   /Si     Source          2       Use precompiled header files
  180.   /Sm     Source          2       Ignore unsupported 16-bit keywords
  181.   /Sn     Source          2       Allow DBCS support
  182.   /Sp     Source          3       Pack structures and unions
  183.   /Sq     Source          2       Sequence numbers
  184.   /Sr     Source          1       Conversion rule
  185.   /Ss     Source          2       Allow use of '//' for comments
  186.   /Su     Source          3       Enum variables
  187.   /Sv     Source          2       Enable support for memory file
  188.   /Td     Source          1       Source file language
  189.   /Ti     Debugging       2       Debugging information: All
  190.   /Tl     Other           1       Preload compiler components
  191.   /Tm     Debugging       2       Use debug memory management
  192.   /Tn     Debugging       2       Debugging information: Line number
  193.   /Tx     Debugging       2       Full exception dump information
  194.   /U      Preprocessor    2       User macros: Remove
  195.   /U*     Preprocessor    2       User macros: Remove all user defined macros
  196.   /V      Other           1       Version string:
  197.   /Wgrp   Debugging       1       Diagnostic options
  198.   /Wn     Debugging       1       Compiler warning level
  199.   /Xc     File            2       Ignore command line include paths
  200.   /Xi     File            2       Ignore environment include paths
  201.   /Xs     SOM             1       Exclude files from implicit SOM mode
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ 4. Processing ΓòÉΓòÉΓòÉ
  205.  
  206. Use the options on the Processing page to select the degree of compilation you 
  207. want, and the type of executable produced. 
  208.  
  209. The options that control the degree of processing are in the Processing step 
  210. group. 
  211.  
  212. Select the type of executable produced with the Target radio buttons. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 4.1. Processing step ΓòÉΓòÉΓòÉ
  216.  
  217. Use the Processing step options to select the degree of compilation you want. 
  218. You have the following options: 
  219.  
  220.  Run the preprocessor only 
  221.            Runs the preprocessor only without running the compiler, and creates 
  222.            a preprocessor output file that has the same name as the source 
  223.            file, with a .I file name extension. Comments from the source code 
  224.            are not included in the preprocessor output file. The equivalent 
  225.            command-line option is /P+. 
  226.  Perform syntax check only 
  227.            Does only a syntax check on the source files. Only listing (.LST) 
  228.            files are produced when you select this option. The equivalent 
  229.            command-line option is /Fc+ . 
  230.  Create intermediate files only 
  231.            Creates intermediate code files only without completing compilation. 
  232.            You can name the files with the Intermediate entry field, on the 
  233.            first page under the Files tab. The equivalent comand-line option is 
  234.            /Fw+. See  Using the Intermediate Code Linker for more information 
  235.            on intermediate code. 
  236.  Perform compile only, no link 
  237.            Indicates you want to compile but not link the program. The 
  238.            equivalent command-line option is /C+. 
  239.  Compile and link 
  240.            Indicates that you want to compile and link in one step, with the 
  241.            compiler invoking the linker. The equivalent command-line option is 
  242.            /C-. 
  243.  
  244.  
  245. ΓòÉΓòÉΓòÉ 4.2. Target ΓòÉΓòÉΓòÉ
  246.  
  247. Use the Target options to specify the type of file you want to create. 
  248.  
  249. Select one radio button from the group: 
  250.  
  251.  EXE 
  252.        Build an .EXE file.  This is the default setting.  The equivalent icc 
  253.        command-line option is /Ge+. 
  254.  
  255.  DLL 
  256.        Build a dynamic link library (.DLL) file.  The equivalent icc 
  257.        command-line option is /Ge-. 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 5. File ΓòÉΓòÉΓòÉ
  261.  
  262. Use the File pages to set compiler options that control the files that the 
  263. compiler produces.  These files include: 
  264.  
  265.      Listing (/L) 
  266.      Intermediate (/Fw) 
  267.      Browser info (/Fb) 
  268.      Object (/Fo) 
  269.      Template (/Ft) 
  270.      Assembler listing (/Fa) 
  271.      Linker map (/Fm) 
  272.      Executable (/Fe) 
  273.      Precompiled header file (/Fi) 
  274.  
  275.  You can control the way the compiler searches for include files with these 
  276.  options: 
  277.  
  278.      Ignore environment include paths (/Xi) 
  279.      Ignore command line include paths (/Xc) 
  280.      Command line include path (/I) 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 5.1. Listing ΓòÉΓòÉΓòÉ
  284.  
  285. Select the Listing check box to create a listing file from the source file.  If 
  286. you do not select the Listing checkbox, no listing file will be produced unless 
  287. you select any of the following options on the Listing page of the Compiler 
  288. Options notebook: 
  289.  
  290.      Source 
  291.      Expand all macros 
  292.      Aggregate layout 
  293.      Cross reference 
  294.      Expand include files. 
  295.  
  296.  In the Listing entry field, type the name for the listing file.  If you leave 
  297.  this field blank, the listing file will have the same name as the source file 
  298.  with an extension of .LST. 
  299.  
  300.  Selecting this item is equivalent to specifying the /L+ or /Fl+ option on the 
  301.  icc command line. 
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 5.2. Intermediate ΓòÉΓòÉΓòÉ
  305.  
  306. In the Intermediate entry field, type the names you want to give the 
  307. intermediate code files. You must first select to generate intermediate files 
  308. only, on the Processing page. 
  309.  
  310. If you leave this field blank, the intermediate code files will have the same 
  311. name as the source file, with the file name extensions .W, .WH, and .WI. 
  312.  
  313. Selecting this item is equivalent to specifying a name with the /Fw+ option on 
  314. the icc command line. 
  315.  
  316. For more information on intermediate code, please refer to Using the 
  317. Intermediate Code Linker. 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 5.3. Browser info ΓòÉΓòÉΓòÉ
  321.  
  322. Use the Browser info options to select the type of browser file the compiler 
  323. produces for use with the VisualAge C++ browser. 
  324.  
  325. The browser file will have the same name as the main source file, with a .PDB 
  326. file name extension. All .PDB files are stored in the same directory as the 
  327. object files. 
  328.  
  329. You can control the information as follows: 
  330.  
  331.  None 
  332.            Do not produce browser files. Your executable will not be browsable. 
  333.            The equivalent command-line option is /Fb-. 
  334.  
  335.  Full 
  336.            Produce browser files. Your executable can then be browsed. The 
  337.            equivalent command-line option is /Fb+. 
  338.  
  339.  Compiler requested. 
  340.            Produce browser files that includes full information on system 
  341.            #include files. You only need to set this option if you get a 
  342.            compiler message that tells you it is required. The equivalent 
  343.            command-line option is /Fb*. 
  344.  
  345.  
  346. ΓòÉΓòÉΓòÉ 5.4. Object ΓòÉΓòÉΓòÉ
  347.  
  348. Select the Object check box to generate an object file. 
  349.  
  350. In the Object entry field, type the name of the object file.  If you leave this 
  351. field blank, the object file will have the same name as the source file, with a 
  352. .OBJ file name extension. 
  353.  
  354. Specify a directory in the entry field to direct object files (and .PDB files 
  355. if you are producing browser information) to that directory. 
  356.  
  357. Selecting this item is equivalent to specifying the /Fo+ option on the icc 
  358. command line. 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 5.5. Template ΓòÉΓòÉΓòÉ
  362.  
  363. Select the Template check box to generate files for template resolution. 
  364.  
  365. In the Template directory entry field, type the name of the directory in which 
  366. you wish to store the template files. If you leave this field blank, the 
  367. template resolution files will be stored in the TEMPINC subdirectory under the 
  368. current directory. 
  369.  
  370. Selecting this item is equivalent to specifying the /Ft+ option on the icc 
  371. command line. 
  372.  
  373.  
  374. ΓòÉΓòÉΓòÉ 5.6. Assembler ΓòÉΓòÉΓòÉ
  375.  
  376. Select the Assembler check box to produce an assembler listing file that has 
  377. the source code as comments. 
  378.  
  379. Note:  This listing is not guaranteed to assemble. 
  380.  
  381.  In the Assembler entry field, type the name you want to give the assembler 
  382.  file.  If you leave this field blank, the assembler file will have the same 
  383.  name as the source file, with a .ASM file name extension. 
  384.  
  385.  Selecting this item is equivalent to specifying the /Fa+ option on the icc 
  386.  command line. 
  387.  
  388.  
  389. ΓòÉΓòÉΓòÉ 5.7. Linker map ΓòÉΓòÉΓòÉ
  390.  
  391. Select the Linker map check box to create a linker map file, which lists the 
  392. object modules in your output file, segment names, addresses, and sizes, and 
  393. symbol information. 
  394.  
  395. In the Linker map entry field, type the name you want to give the linker map 
  396. file.  If you leave this field blank, the linker map file will have the same 
  397. name as the source file, with a .MAP file name extension. 
  398.  
  399. Selecting this item is equivalent to specifying the /Fm+ option on the icc 
  400. command line. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 5.8. Executable ΓòÉΓòÉΓòÉ
  404.  
  405. In the Executable entry field, enter a name for the generated executable file 
  406. or dynamic link library (DLL).  If you leave this field blank, the executable 
  407. file or DLL will have the same name as the first file, with a .EXE or .DLL file 
  408. name extension, based on the Target you selected on the Processing step page. 
  409.  
  410. Entering a name here is equivalent to specifying the /Fename option on the icc 
  411. command line. 
  412.  
  413.  
  414. ΓòÉΓòÉΓòÉ 5.9. Precompiled header file ΓòÉΓòÉΓòÉ
  415.  
  416. Select the Precompiled header file check box to generate a precompiled header 
  417. file if none exists or if the existing one is out of date. 
  418.  
  419. Note:  To get the most benefit from using precompiled header files, you may 
  420. need to reorganize your source files, and use multiple precompiled header 
  421. objects. See Using Precompiled Headers for more information on using 
  422. precompiled headers. To use multiple precompiled header objects, use the 
  423. /Siname and /Finame command-line options, which you can enter on the User 
  424. notebook page. You can set these options on a subproject level, to use 
  425. different precompiled header options for different sets of source files. 
  426.  
  427. Selecting this item is equivalent to specifying the /Fi+ option on the icc 
  428. command line. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 5.10. Ignore environment include paths ΓòÉΓòÉΓòÉ
  432.  
  433. Select the Ignore environment include paths check box to ignore the #include 
  434. search path(s) given in the INCLUDE environment variable. #include files will 
  435. not be searched for in the directories specified by the INCLUDE environment 
  436. variable. 
  437.  
  438. Selecting this item is equivalent to specifying the /Xi+ option on the icc 
  439. command line. 
  440.  
  441. To specify search directories for #include files, use the Command line include 
  442. path entry field. 
  443.  
  444.  
  445. ΓòÉΓòÉΓòÉ 5.11. Ignore command line include paths ΓòÉΓòÉΓòÉ
  446.  
  447. Select the Ignore command line include paths to ignore the search paths 
  448. specified in the Command line include path entry field. #include files will not 
  449. be searched for in the directories specified in the Command line include path 
  450. field. 
  451.  
  452. Note:  Any search paths you specified on the User page are also ignored. 
  453.  
  454. Selecting this item is equivalent to specifying the /Xc+ option on the icc 
  455. command line. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 5.12. Command line include path ΓòÉΓòÉΓòÉ
  459.  
  460. In the Command line include path field, enter the pathnames of directories to 
  461. be searched for #include files.  Separate each pathname with a semicolon or 
  462. enter one path per line. 
  463.  
  464. If you do not enter any paths in this field, the default is to search the 
  465. directory of the source file (for user files only), and then search the paths 
  466. given in the INCLUDE environment variable unless the Ignore environment include 
  467. paths check box is selected. 
  468.  
  469. Entering paths in this field is equivalent to specifying the /Ipath option on 
  470. the icc command line. 
  471.  
  472.  
  473. ΓòÉΓòÉΓòÉ 6. Listing ΓòÉΓòÉΓòÉ
  474.  
  475. Use the Listing page to set compiler options that allow you to control whether 
  476. or not a listing file is produced, the type of information in the listing, and 
  477. the appearance of the file. 
  478.  
  479. You have the following options: 
  480.  
  481.  Source 
  482.            Include source code in listing file (/Ls) 
  483.  
  484.  Expand all macros 
  485.            Expand all macros in listing file (/Le) 
  486.  
  487.  Aggregate layout 
  488.            Control aggregate layout of struct and union variables in listing 
  489.            file (/La, /Lb) 
  490.  
  491.  Cross reference 
  492.            Control cross reference listing in listing file (/Ly, /Lx) 
  493.  
  494.  Expand include files 
  495.            Control expansion of #include files in listing file (/Li, /Lj) 
  496.  
  497.  Page length 
  498.            Set page length of listing file (/Lp) 
  499.  
  500.  Title 
  501.            Set title of listing file (/Lt) 
  502.  
  503.  Subtitle 
  504.            Set subtitle in listing file (/Lu) 
  505.  
  506.  
  507. ΓòÉΓòÉΓòÉ 6.1. Source ΓòÉΓòÉΓòÉ
  508.  
  509. Select the Source check box to include the source code in the listing file. 
  510.  
  511. Selecting this item is equivalent to specifying the /Ls+ option on the icc 
  512. command line. 
  513.  
  514.  
  515. ΓòÉΓòÉΓòÉ 6.2. Expand all macros ΓòÉΓòÉΓòÉ
  516.  
  517. Select the Expand all macros check box to produce a listing showing the 
  518. contents of all the macros from your source program. 
  519.  
  520. Selecting this item is equivalent to specifying the /Le+ option on the icc 
  521. command line. 
  522.  
  523.  
  524. ΓòÉΓòÉΓòÉ 6.3. Aggregate layout ΓòÉΓòÉΓòÉ
  525.  
  526. Use the Aggregate layout group of radio buttons to specify whether or not you 
  527. want to include a layout of all struct and union variables with their offsets 
  528. and lengths in the listing file. 
  529.  
  530. Select one of the radio buttons from the group: 
  531.  
  532.  None 
  533.          Does not produce an aggregate layout.  This is the default setting. 
  534.          Selecting this item is equivalent to specifying the /La- or /Lb- 
  535.          option on the icc command line. 
  536.  
  537.  Referenced 
  538.          Includes a layout of only the referenced struct and union variables. 
  539.          Selecting this item is equivalent to specifying the /La+ option on the 
  540.          icc command line. 
  541.  
  542.  All 
  543.          Includes a layout of all struct and union variables.  Selecting this 
  544.          item is equivalent to specifying the /Lb+ option on the icc command 
  545.          line. 
  546.  
  547.  
  548. ΓòÉΓòÉΓòÉ 6.4. Cross reference ΓòÉΓòÉΓòÉ
  549.  
  550. Use the Cross reference group of radio buttons to specify whether or not to 
  551. produce a cross reference listing. The generated cross-reference table 
  552. identifies variables, structures, and function names along with the line 
  553. numbers where the names are declared in the source code. 
  554.  
  555. Select one of the radio buttons from the group: 
  556.  
  557.  None 
  558.       Does not produce a cross-reference table.  This is the default setting. 
  559.       Selecting this item is equivalent to specifying the /Lx- or /Ly- option 
  560.       on the icc command line. 
  561.  
  562.  Referenced 
  563.       Generates a cross-reference table of only the referenced variable, 
  564.       structure, and function names.  Selecting this item is equivalent to 
  565.       specifying the /Lx+ option on the icc command line. 
  566.  
  567.  All 
  568.       Generates a cross-reference table of all variable, structure, and 
  569.       function names.  The table includes all local identifiers referenced by 
  570.       the user and all external identifiers. Selecting this item is equivalent 
  571.       to specifying the /Ly+ option on the icc command line. 
  572.  
  573.  
  574. ΓòÉΓòÉΓòÉ 6.5. Expand include files ΓòÉΓòÉΓòÉ
  575.  
  576. Use the Expand include files group of radio buttons to specify whether or not 
  577. to expand #include files. 
  578.  
  579. Select one of the radio buttons from the group: 
  580.  
  581.  None 
  582.       Does not expand #include files for the listing file.  This is the default 
  583.       setting. Selecting this item is equivalent to specifying the /Li- or /Lj- 
  584.       option on the icc command line. 
  585.  
  586.  User 
  587.       Produces a listing showing the contents of the user #include files from 
  588.       your source program.  Selecting this item is equivalent to specifying the 
  589.       /Li+ option on the icc command line. 
  590.  
  591.  User and system 
  592.       Produces a listing showing the contents of the user and system #include 
  593.       files from your source program.  Selecting this item is equivalent to 
  594.       specifying the /Lj+ option on the icc command line. 
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ 6.6. Page length ΓòÉΓòÉΓòÉ
  598.  
  599. In the Page length entry field, type a number between 15 and 65535 to set the 
  600. page length for the generated listing file. If you leave this field blank, the 
  601. default page length of 66 lines will be used. 
  602.  
  603. Entering a number in this field is equivalent to specifying the /Lpnum option 
  604. on the icc command line. 
  605.  
  606.  
  607. ΓòÉΓòÉΓòÉ 6.7. Title ΓòÉΓòÉΓòÉ
  608.  
  609. In the Title field, type some text to specify a title for the listing.  The 
  610. title name can be up to 256 characters long. You can also enter a subtitle 
  611. string in the Subtitle field. 
  612.  
  613. Selecting this item is equivalent to specifying the /Lt"string" option on the 
  614. icc command line. 
  615.  
  616.  
  617. ΓòÉΓòÉΓòÉ 6.8. Subtitle ΓòÉΓòÉΓòÉ
  618.  
  619. In the Subtitle field, type some text to specify a subtitle for the listing. 
  620. The subtitle name can be up to 256 characters long. You can also enter a Title 
  621. string in the Title field. 
  622.  
  623. Selecting this item is equivalent to specifying the /Lu"string" option on the 
  624. icc command line. 
  625.  
  626.  
  627. ΓòÉΓòÉΓòÉ 7. Debugging ΓòÉΓòÉΓòÉ
  628.  
  629. Use the Debugging page to set compiler options that are useful for debugging 
  630. your programs. 
  631.  
  632. The information generated by the VisualAge C++ debugger and compiler as a 
  633. result of these options are provided to help you diagnose problems in your 
  634. code.  Do not use the debugging information as a programming interface. 
  635.  
  636. You have the following options: 
  637.  
  638.  Debugging information 
  639.            Control debugging information for debugger (/Ti, /Tn) 
  640.  
  641.  Stop on error count of 
  642.            Set error count to stop compile on (/N) 
  643.  
  644.  Compiler warning level 
  645.            Specify type of messages to produce (/Wn) 
  646.  
  647.  Diagnostic options 
  648.            Control groups of diagnostic messages (/Wgrp) 
  649.  
  650.  Use debug memory management 
  651.            Use debug memory management functions (/Tm) 
  652.  
  653.  Full exception dump information 
  654.            Provide machine-state dump when exception occurs (/Tx) 
  655.  
  656.  
  657. ΓòÉΓòÉΓòÉ 7.1. Debugging information ΓòÉΓòÉΓòÉ
  658.  
  659. Use the Debugging information check box to produce debugging information for 
  660. use by the VisualAge C++ debugger. You can produce the following levels of 
  661. debugging information: 
  662.  
  663.  None 
  664.            No debugging information is produced. Your executable cannot be 
  665.            debugged with the VisualAge C++ debugger. The equivalent 
  666.            command-line option is /Ti-. 
  667.  
  668.  Line number 
  669.            Only line number information is produced. You can use the debugger 
  670.            to single-step through the source view of program, but cannot view 
  671.            variables. The equivalent command-line option is /Tn+. 
  672.  
  673.  All 
  674.            Complete debugging information is produced. You can use the full 
  675.            capability of the debugger when debugging your program. 
  676.  
  677.            Note:  If you used optimizing options, then the debugger can only 
  678.            provide limited information. See Generating Debugger Information. 
  679.  
  680.            The equivalent command-line option is /Ti+. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 7.2. Stop on error count of ΓòÉΓòÉΓòÉ
  684.  
  685. In the Stop on error count of field, type a value between 1 and 65535 to 
  686. indicate the maximum number of errors at which to abort compilation.  If you 
  687. leave this field blank, compilation will continue until it is completed or 
  688. until an unrecoverable error is encountered. 
  689.  
  690. The type of error message (Info, Warning, Error, or Severe) that increments the 
  691. error counter is determined by the Compiler warning level option. 
  692.  
  693. Selecting this item is equivalent to specifying the /Nnum option on the icc 
  694. command line. 
  695.  
  696.  
  697. ΓòÉΓòÉΓòÉ 7.3. Compiler warning level ΓòÉΓòÉΓòÉ
  698.  
  699. Use the Compiler warning level setting to specify the type of messages you want 
  700. the compiler to produce. The type of compiler message that you indicate here is 
  701. also used to determine which type of error message will cause the error counter 
  702. to be incremented. 
  703.  
  704. Select one radio button from the group: 
  705.  
  706.  Severe 
  707.       Produce only severe error messages.  The equivalent command-line option 
  708.       is /W0. 
  709.  
  710.  Error 
  711.       Produce only severe errors and errors.  The equivalent command-line 
  712.       option is /W1. 
  713.  
  714.  Warning 
  715.       Produce severe errors, errors, and warnings.  The equivalent command-line 
  716.       option is /W2. 
  717.  
  718.  Info 
  719.       Produce all error message types (severe errors, errors, warnings, and 
  720.       information).  This is the default setting. The equivalent command-line 
  721.       option is /W3. 
  722.  
  723.  
  724. ΓòÉΓòÉΓòÉ 7.4. Diagnostic options ΓòÉΓòÉΓòÉ
  725.  
  726. From the Diagnostic options list box, select the diagnostic messages you want 
  727. generated.  The level of diagnostic messages generated is controlled by that 
  728. specified in the Compiler warning level option. For example, if you set the 
  729. compiler warning level to Warning, then diagnostic messages that are only at 
  730. the Information level do not appear. 
  731.  
  732. The diagnostic options help you examine your source code for possible 
  733. programming errors, weak programming style, and other information about the 
  734. structure of your program. 
  735.  
  736. If you do not select any diagnostic messages from this list box, none will be 
  737. generated. 
  738.  
  739. Selecting items from the Diagnostic options list box is equivalent to 
  740. specifying the /Wgrp options on the icc command line. 
  741.  
  742.  
  743. ΓòÉΓòÉΓòÉ 7.5. Use debug memory management ΓòÉΓòÉΓòÉ
  744.  
  745. Select the Use debug memory management check box to instruct the compiler to 
  746. use the debug memory management functions ( _debug_calloc, _debug_malloc, new, 
  747. and so on).  Selecting this option also defines the __DEBUG_ALLOC__ macro. 
  748.  
  749. Selecting this item is equivalent to specifying the /Tm option on the icc 
  750. command line. 
  751.  
  752.  
  753. ΓòÉΓòÉΓòÉ 7.6. Full exception dump information ΓòÉΓòÉΓòÉ
  754.  
  755. Select the Full exception dump information check box to provide a complete 
  756. machine-state dump when an exception occurs.  If this option is not selected, 
  757. only the exception message and address is provided when an exception occurs. 
  758.  
  759. Selecting this item is equivalent to specifying the /Tx option on the icc 
  760. command line. 
  761.  
  762.  
  763. ΓòÉΓòÉΓòÉ 8. Source ΓòÉΓòÉΓòÉ
  764.  
  765. Use the Source page to set compiler options that allow you to control how the 
  766. VisualAge C++ compiler interprets your source file. These options are 
  767. especially useful, for example, if you are concerned with migrating code or 
  768. ensuring consistency with a particular language or standard. 
  769.  
  770. You have the following options: 
  771.  
  772.  Source file language 
  773.            Set default language (C or C++) of source files (/Td, /Tdc, /Tdp) 
  774.  
  775.  Language constructs 
  776.            Set language standard (/S) 
  777.  
  778.  Conversion rule 
  779.            Set type conversion rules (/Sr) 
  780.  
  781.  Use precompiled header files 
  782.            Use precompiled header files, if current (/Si) 
  783.  
  784.  Ignore unsupported 16-bit keywords 
  785.            Ignore unsupported 16-bit keywords (/Sm) 
  786.  
  787.  Make .OBJ the default extension 
  788.            Assume file names without extensions are object files (/Sd) 
  789.  
  790.  Allow use of '//' for comments 
  791.            Allow use of // comments in C files (/Ss) 
  792.  
  793.  Allow DBCS support 
  794.            Allow use of DBCS symbols in source code (/Sn) 
  795.  
  796.  Allow use of ddnames 
  797.            Allow use of ddnames in source code (/Sh) 
  798.  
  799.  Enable support for memory file 
  800.            Allow use of memory files (/Sv) 
  801.  
  802.  Margins 
  803.            Set margins for source files (/Sg) 
  804.  
  805.  Sequence numbers 
  806.            Ignore text in sequence-number columns (/Sq) 
  807.  
  808.  Enum variables 
  809.            Control size of enum variables (/Su) 
  810.  
  811.  Packed structures and union variables 
  812.            Set alignment of data items within structs and unions (/Sp) 
  813.  
  814.  
  815. ΓòÉΓòÉΓòÉ 8.1. Source file language ΓòÉΓòÉΓòÉ
  816.  
  817. Use the Source file language setting to specify the default language (C or C++) 
  818. for source files. 
  819.  
  820. Select one radio button from the group: 
  821.  
  822.  Compiler extension 
  823.       Use the file name extension of the source file to determine its language. 
  824.       .CPP and .CXX files are compiled as C++ files and .C and all other 
  825.       unrecognized files are compiled as C files. This is the default setting. 
  826.       The equivalent icc command-line option is /Td. 
  827.  
  828.  C 
  829.       Compile all source and unrecognized files as C files. The equivalent icc 
  830.       command-line option is /Tdc. 
  831.  
  832.  C++ 
  833.       Compile all source and unrecognized files as C++ files and ensure that 
  834.       template functions are resolved correctly. The equivalent icc 
  835.       command-line option is /Tdp. 
  836.  
  837.  
  838. ΓòÉΓòÉΓòÉ 8.2. Language constructs ΓòÉΓòÉΓòÉ
  839.  
  840. Use the Language constructs setting to specify the default language standard. 
  841.  
  842. Select one radio button from the group: 
  843.  
  844.  ANSI 
  845.       Allow only those extensions that conform to the American National 
  846.       Standards Institute (ANSI).  The equivalent icc command-line option is 
  847.       /Sa. 
  848.  
  849.  SAA level 2 
  850.       Allow only those extensions defined by the SAA Level 2 specifications. 
  851.       This option is only valid for C files.  The equivalent icc command-line 
  852.       option is /S2. 
  853.  
  854.  Extended 
  855.       Allow all VisualAge C++ language extensions.  This is the default 
  856.       setting.  The equivalent icc command-line option is /Se. 
  857.  
  858.  Compatibility 
  859.       Allow constructs compatible with older levels of the C++ language.  This 
  860.       option is only valid for C++ files. The equivalent icc command-line 
  861.       option is /Sc. 
  862.  
  863.  
  864. ΓòÉΓòÉΓòÉ 8.3. Conversion rule ΓòÉΓòÉΓòÉ
  865.  
  866. Use the Conversion rule setting to set type conversion rules.  This option is 
  867. only valid for C source files.  For C++, the conversion rule is to preserve 
  868. accuracy. 
  869.  
  870. Select one radio button from the group: 
  871.  
  872.  Preserve sign 
  873.       Preserve the sign of the number being converted.  This is an old-style 
  874.       rule that is non-conformant to ANSI specifications.  The equivalent icc 
  875.       command-line option is /Sr+. 
  876.  
  877.  Preserve accuracy 
  878.       Preserve the accuracy of the number being converted.  This new-style rule 
  879.       is equivalent to specifying the /Sr- option on the icc command line, and 
  880.       is the default setting. 
  881.  
  882.  
  883. ΓòÉΓòÉΓòÉ 8.4. Use precompiled header files ΓòÉΓòÉΓòÉ
  884.  
  885. Select the Use precompiled header files check box to use precompiler header 
  886. files if they exist and are current. 
  887.  
  888. Note:  To get the most benefit from using precompiled header files, you may 
  889. need to reorganize your source files, and use multiple precompiled header 
  890. objects. See Using Precompiled Headers for more information on using 
  891. precompiled headers. To use multiple precompiled header objects, use the 
  892. /Siname and /Finame command-line options, which you can enter on the User 
  893. notebook page. You can set these options on a subproject level, to use 
  894. different precompiled header options for different sets of source files. 
  895.  
  896. Selecting this item is equivalent to specifying the /Si+ option on the icc 
  897. command line. 
  898.  
  899.  
  900. ΓòÉΓòÉΓòÉ 8.5. Ignore unsupported 16-bit keywords ΓòÉΓòÉΓòÉ
  901.  
  902. Select the Ignore unsupported 16-bit keywords check box to ignore unsupported 
  903. 16-bit keywords, such as near and far. Leave this check box blank if you want 
  904. to treat unsupported 16-bit keywords like any other identifier. 
  905.  
  906. Selecting this item is equivalent to specifying the /Sm+ option on the icc 
  907. command line. 
  908.  
  909.  
  910. ΓòÉΓòÉΓòÉ 8.6. Make .OBJ the default extension ΓòÉΓòÉΓòÉ
  911.  
  912. Select the Make .OBJ the default extension check box to set the default file 
  913. name extension to .OBJ. This means that if an extension is not specified with a 
  914. file, then it is assumed to be an object file. 
  915.  
  916. Selecting this item is equivalent to specifying the /Sd- option on the icc 
  917. command line. 
  918.  
  919. If you do not accept .OBJ as the default extension in this check box, then the 
  920. default file name extension is .C if you selected C for the Source file 
  921. language option, and .CPP if you selected C++. 
  922.  
  923. The extension determines whether the file is treated as a C source file or as 
  924. an object file.  If the file has an extension of .C, then it is compiled and 
  925. linked.  If the file has an extension of .OBJ, then it is only linked. 
  926.  
  927.  
  928. ΓòÉΓòÉΓòÉ 8.7. Allow use of '//' for comments ΓòÉΓòÉΓòÉ
  929.  
  930. Select the Allow use of '//' for comments check box to allow the double slash 
  931. format of indicating comments. This type of comment is ended by a carriage 
  932. return. 
  933.  
  934. Note:  This option is only valid for C files.  C++ allows double slashes to 
  935.        indicate comments as part of the language. 
  936.  
  937.  Selecting this item is equivalent to specifying the /Ss+ option on the icc 
  938.  command line. 
  939.  
  940.  
  941. ΓòÉΓòÉΓòÉ 8.8. Allow DBCS support ΓòÉΓòÉΓòÉ
  942.  
  943. Select the Allow DBCS support check box to allow the use of double-byte 
  944. character set (DBCS) symbols in the source code. 
  945.  
  946. Selecting this item is equivalent to specifying the /Sn+ option on the icc 
  947. command line. 
  948.  
  949.  
  950. ΓòÉΓòÉΓòÉ 8.9. Allow use of ddnames support ΓòÉΓòÉΓòÉ
  951.  
  952. Select the Allow use of ddnames support check box to allow the use of ddnames 
  953. in the source code. 
  954.  
  955. Selecting this item is equivalent to specifying the /Sh+ option on the icc 
  956. command line. 
  957.  
  958.  
  959. ΓòÉΓòÉΓòÉ 8.10. Enable support for memory file ΓòÉΓòÉΓòÉ
  960.  
  961. Select the Enable support for memory file check box to allow the use of memory 
  962. files. 
  963.  
  964. Selecting this item is equivalent to specifying the /Sv+ option on the icc 
  965. command line. 
  966.  
  967.  
  968. ΓòÉΓòÉΓòÉ 8.11. Margins ΓòÉΓòÉΓòÉ
  969.  
  970. Use the Margins setting to specify values for the input file margins.  Text 
  971. which is outside the specified margins is ignored. The Margins setting is 
  972. useful for importing source files that were created on other systems and 
  973. contain characters you want to ignore. 
  974.  
  975. This option is only valid for C source files. 
  976.  
  977.      In the Left entry field, type a value between 1 and 65535 to specify a 
  978.       value for the left margin. 
  979.  
  980.      In the Right entry field, type an asterisk to denote no right margin, or 
  981.       enter a value between 1 and 65535.  The value specified for the right 
  982.       margin must be greater than or equal than that specified for the left 
  983.       margin. 
  984.  
  985.  Selecting this item is equivalent to specifying the /Sg[l][,r|*] option on the 
  986.  icc command line, where l and r are integers indicating the left and right 
  987.  margins, respectively. 
  988.  
  989.  
  990. ΓòÉΓòÉΓòÉ 8.12. Sequence numbers ΓòÉΓòÉΓòÉ
  991.  
  992. Use the Sequence numbers setting to specify columns in which sequence column 
  993. numbers appear, and ignore the text in those columns.  Setting Sequence numbers 
  994. is useful for importing source files from systems that use sequence numbers. 
  995.  
  996. This option is only valid for C source files. 
  997.  
  998.      In the Left entry field, type a value from 1 to 65535 to specify the left 
  999.       sequence column. 
  1000.  
  1001.      In the Right entry field, type an asterisk to denote no right sequence 
  1002.       column, or enter a value from 1 to 65535.  The value specified for the 
  1003.       right column must be greater than or equal to the value specified for the 
  1004.       left column. 
  1005.  
  1006.  Selecting this item is equivalent to specifying the /Sq[l][,r] option on the 
  1007.  icc command line, where l and r are integers respectively indicating the left 
  1008.  and right columns where sequence numbers appear. 
  1009.  
  1010.  
  1011. ΓòÉΓòÉΓòÉ 8.13. Enum variables ΓòÉΓòÉΓòÉ
  1012.  
  1013. Use the Enum variables setting to control the size of enum variables in the 
  1014. source code. 
  1015.  
  1016. Select one radio button from the group: 
  1017.  
  1018.  SAA 
  1019.       Use the SAA rules, that is, make all enum variables the size of the 
  1020.       smallest integral type that can contain all variables.  This is the 
  1021.       default setting.  The equivalent icc command-line option is /Su-. 
  1022.  
  1023.  1 byte 
  1024.       Make all enum variables 1 byte.  The equivalent icc command-line option 
  1025.       is /Su1. 
  1026.  
  1027.  2 byte 
  1028.       Make all enum variables 2 bytes.  The equivalent icc command-line option 
  1029.       is /Su2. 
  1030.  
  1031.  4 byte 
  1032.       Make all enum variables 4 byte.  The equivalent icc command-line option 
  1033.       is /Su4. 
  1034.  
  1035.  
  1036. ΓòÉΓòÉΓòÉ 8.14. Packed structures and unions ΓòÉΓòÉΓòÉ
  1037.  
  1038. Use the Packed structures and unions setting to set the alignment or packing of 
  1039. data items within structs and unions. 
  1040.  
  1041. Select one radio button from the group: 
  1042.  
  1043.  1 byte 
  1044.       Set the most restrictive alignment of structure and union members to 
  1045.       1-byte.  The equivalent icc command-line option is /Sp1. 
  1046.  
  1047.  2 byte 
  1048.       Set the most restrictive alignment of structure and union members to 
  1049.       2-byte.  The equivalent icc command-line option is /Sp2. 
  1050.  
  1051.  4-byte 
  1052.       Set the most restrictive alignment of structure and union members to 
  1053.       4-byte.  The equivalent icc command-line option is /Sp4. 
  1054.  
  1055.  
  1056. ΓòÉΓòÉΓòÉ 9. Object ΓòÉΓòÉΓòÉ
  1057.  
  1058. Use the  Object page to set compiler options that allow you to specify the type 
  1059. of code that the compiler will produce. 
  1060.  
  1061. You have the following options: 
  1062.  
  1063.  Executable environment 
  1064.            Specify VisualAge C++ runtime environment, or subsystem without 
  1065.            runtime environment (/R) 
  1066.  
  1067.  Library selection 
  1068.            Select type of library to link to (/Gm) 
  1069.  
  1070.  Library Linkage 
  1071.            Link to DLL or .LIB versions of runtime libraries (/Gd) 
  1072.  
  1073.  Target processor 
  1074.            Optimize for processor type (/Gnum) 
  1075.  
  1076.  Turn on optimization 
  1077.            Select type of optimization (/O, /Oc) 
  1078.  
  1079.  Do not perform stack pointer optimization 
  1080.            Turn off optimizations involving the stack pointer (/Op-) 
  1081.  
  1082.  Limit working set size while optimizing 
  1083.            Limit working set size to approximately 35Mb (/Om) 
  1084.  
  1085.  Preserve DS and ES segments for VDD 
  1086.            Control handling of DS and ES registers (/Gv) 
  1087.  
  1088.  Do not invoke the instruction scheduler 
  1089.            Control invocation of instruction scheduler during optimization 
  1090.            (/Os-) 
  1091.  
  1092.  Data segment 
  1093.            Rename default data and constant segments (/Nd) 
  1094.  
  1095.  Code segment 
  1096.            Set default name for code segment (/Nt) 
  1097.  
  1098.  Inlining 
  1099.            Control inlining of user code (/Oi) 
  1100.  
  1101.  Enable performance analyzer 
  1102.            Enable executable for performance analysis (/Gh) 
  1103.  
  1104.  Remove stack probes 
  1105.            Remove stack probes (/Gs) 
  1106.  
  1107.  Remove C++ exception information 
  1108.            Remove exception-handling information from code (/Gx) 
  1109.  
  1110.  Do not generate default library info 
  1111.            Do not identify default libraries for linker (/Gn) 
  1112.  
  1113.  Use optlink linkage 
  1114.            Specify linkage to use for functions (/M) 
  1115.  
  1116.  Use tiled memory 
  1117.            Enable all variables to be passed to 16-bit functions (/Gt) 
  1118.  
  1119.  Use fast floating point method 
  1120.            Use fast floating-point execution (/Gf) 
  1121.  
  1122.  Generate code to run at ring 0 
  1123.            Generate code that runs at ring 0 instead of ring 3 (/Gr) 
  1124.  
  1125.  Remove unused data in intemediate files 
  1126.            Remove unused data with the intermediate code linker (/Gu) 
  1127.  
  1128.  Invoke intermediate code linker 
  1129.            Use intermediate code linker when compiling (/Ol) 
  1130.  
  1131.  Generate FWAIT after load 
  1132.            Generate FWAIT instruction after each floating-point load 
  1133.            instruction (/Gw) 
  1134.  
  1135.  Use fast integer method 
  1136.            Use fast integer execution (/Gi) 
  1137.  
  1138.  
  1139. ΓòÉΓòÉΓòÉ 9.1. Executable environment ΓòÉΓòÉΓòÉ
  1140.  
  1141. Use the Executable environment setting to control the executable runtime 
  1142. environment. 
  1143.  
  1144. Select one radio button from the group: 
  1145.  
  1146.  Runtime 
  1147.       Generate executable code that runs in a VisualAge C++ runtime 
  1148.       environment.  This is the default setting.  The equivalent icc 
  1149.       command-line option is /Re. 
  1150.  
  1151.  Subsystem 
  1152.       Generate executable code that can be used as a subsystem without a 
  1153.       runtime environment.  The equivalent icc command-line option is /Rn. 
  1154.  
  1155.  
  1156. ΓòÉΓòÉΓòÉ 9.2. Library selection ΓòÉΓòÉΓòÉ
  1157.  
  1158. Use the Library selection setting to specify the version of the library you 
  1159. want to link to. 
  1160.  
  1161. Select one radio button from the group: 
  1162.  
  1163.  Single-thread 
  1164.       Link with the single-thread version of the library (no multithread 
  1165.       capabilities).  This is the default setting.  The equivalent icc 
  1166.       command-line option is /Gm-. 
  1167.  
  1168.  Multithread 
  1169.       Link with the multithread version of the library.  The equivalent icc 
  1170.       command-line option is /Gm+. 
  1171.  
  1172.  
  1173. ΓòÉΓòÉΓòÉ 9.3. Library linkage ΓòÉΓòÉΓòÉ
  1174.  
  1175. Use the Library linkage setting to specify how you want to link to the runtime 
  1176. libraries. 
  1177.  
  1178. Select one radio button from the group: 
  1179.  
  1180.  Static 
  1181.       Statically link to the runtime libraries.  All external names beginning 
  1182.       with the letters Dos, Kbd, and Vio are reserved.  This is the default 
  1183.       setting.  The equivalent icc command-line option is /Gd-. 
  1184.  
  1185.  Dynamic 
  1186.       Dynamically link to the runtime libraries.   The equivalent icc 
  1187.       command-line option is /Gd+. 
  1188.  
  1189.  
  1190. ΓòÉΓòÉΓòÉ 9.4. Target processor ΓòÉΓòÉΓòÉ
  1191.  
  1192. Use the Target processor setting to specify which processor to optimize for. 
  1193.  
  1194. Select one radio button from the group: 
  1195.  
  1196.  80386 
  1197.       Optimize code for use with the 80386 processor.  The code generated will 
  1198.       also run on a 80486 or Pentium processor.  This is the default setting. 
  1199.       The equivalent icc command-line option is /G3. 
  1200.  
  1201.  80486 
  1202.       Optimize code for use with the 80486 processor.  The code generated will 
  1203.       also run on a 80386 or Pentium processor.  The equivalent icc 
  1204.       command-line option is /G4. 
  1205.  
  1206.  Pentium 
  1207.       Optimize code for use with the Pentium processor.  The code generated 
  1208.       will also run on a 80386 or 80486 processor.  The equivalent icc 
  1209.       command-line option is /G5. 
  1210.  
  1211.  
  1212. ΓòÉΓòÉΓòÉ 9.5. Optimization ΓòÉΓòÉΓòÉ
  1213.  
  1214. Use the Optimization options to select the type of optimization you want 
  1215. performed. You can select the following options: 
  1216.  
  1217.  None 
  1218.            Perform no optimization. Select this option when you want to debug 
  1219.            your application. The equivalent command-line option is /O-. 
  1220.  
  1221.  Compact 
  1222.            Optimize for speed and size. The compiler will perform all 
  1223.            optimizations that do not increase the size of the executable. The 
  1224.            equivalent command-line option is /Oc+. 
  1225.  
  1226.  Speed 
  1227.            Optimize for speed. The compiler will perform all optimizations, 
  1228.            including those that increase the size of the executable (such as 
  1229.            loop unrolling). The equivalent command-line option is /O+. 
  1230.  
  1231.  
  1232. ΓòÉΓòÉΓòÉ 9.6. Do not perform stack pointer optimization ΓòÉΓòÉΓòÉ
  1233.  
  1234. Select the Do not perform stack pointer optimization check box to turn off 
  1235. optimizations that involve the stack pointer. 
  1236.  
  1237. Note:  Turning off stack pointer optimization is not recommended because it 
  1238.        decreases the performance of your executable file. 
  1239.  
  1240.  Selecting this item is equivalent to specifying the /Op- option on the icc 
  1241.  command line. 
  1242.  
  1243.  If you do not select this option, the default is to perform stack pointer 
  1244.  optimization if the Turn on optimization (/O) option is selected. 
  1245.  
  1246.  
  1247. ΓòÉΓòÉΓòÉ 9.7. Limit working set size while optimizing ΓòÉΓòÉΓòÉ
  1248.  
  1249. Select the Limit working set size while optimizing check box to limit the 
  1250. working set size to approximately 35Mb while optimizing. 
  1251.  
  1252. If you do not select this option, the default is to impose no limit on the 
  1253. working set size. 
  1254.  
  1255. Selecting this item is equivalent to specifying the /Om option on the icc 
  1256. command line. 
  1257.  
  1258.  
  1259. ΓòÉΓòÉΓòÉ 9.8. Preserve DS and ES segments for VDD ΓòÉΓòÉΓòÉ
  1260.  
  1261. Select the Preserve DS and ES segments for VDD check box to control handling of 
  1262. DS and ES registers.  This option is provided for virtual device driver (VDD) 
  1263. development, which is only available for C programs. 
  1264.  
  1265. If you select this item, the DS and ES registers are saved on entry to an 
  1266. external function and set to the selector for DGROUP, and then restored on exit 
  1267. from the function. 
  1268.  
  1269. Selecting this item is equivalent to specifying the /Gv+ option on the icc 
  1270. command line. 
  1271.  
  1272.  
  1273. ΓòÉΓòÉΓòÉ 9.9. Do not invoke the instruction scheduler ΓòÉΓòÉΓòÉ
  1274.  
  1275. Select the Do not invoke the instruction scheduler check box to instruct the 
  1276. compiler not to use the instruction scheduler even though the Turn on 
  1277. optimization (/O) option is selected. 
  1278.  
  1279. If you do not select this option, the default is to invoke the instruction 
  1280. scheduler if and only if the Turn on optimization option is selected. 
  1281.  
  1282. Selecting this item is equivalent to specifying the /Os- option on the icc 
  1283. command line. 
  1284.  
  1285.  
  1286. ΓòÉΓòÉΓòÉ 9.10. Data segment ΓòÉΓòÉΓòÉ
  1287.  
  1288. Use this option to specify the names of default data, uninitialized data, and 
  1289. constant segments as nameDATA32, nameBSS32, and nameCONST32_RO. You can then 
  1290. give the segments special attributes by referring to their names.  The renamed 
  1291. segments are not placed in the default data group. 
  1292.  
  1293. If you leave this field blank, the default names DATA32, BSS32, and CONST32_RO 
  1294. are used. 
  1295.  
  1296. You can also set a default name for code and text segments, with the Code 
  1297. segment option. You can rename the exception-handling segments with the /Nx 
  1298. option in the User entry field on the User page. 
  1299.  
  1300. Specifying a data segment name is equivalent to specifying the /Ndname option 
  1301. on the icc command line. 
  1302.  
  1303.  
  1304. ΓòÉΓòÉΓòÉ 9.11. Code segment ΓòÉΓòÉΓòÉ
  1305.  
  1306. In the Code segment entry field, type the default name prefix you want to use 
  1307. for code and text segments.  The name nameCODE32 is used, where name is the 
  1308. name you entered.  You can then give the segment special attributes by 
  1309. referring to its name. 
  1310.  
  1311. If you leave this field blank, the default name CODE32 is used. 
  1312.  
  1313. You can also set the name for default data and constant segments, with the Data 
  1314. segment option. You can rename the exception-handling segments with the /Nx 
  1315. option in the User entry field on the User page. 
  1316.  
  1317. Specifying a code segment name is equivalent to specifying the /Ntname option 
  1318. on the icc command line. 
  1319.  
  1320.  
  1321. ΓòÉΓòÉΓòÉ 9.12. Inlining ΓòÉΓòÉΓòÉ
  1322.  
  1323. Use the Inlining setting to control inlining of user code. 
  1324.  
  1325.      Select the Turn on check box to inline all user functions qualified with 
  1326.       the _Inline (for C) or inline (for C++) keyword.  Selecting this item is 
  1327.       equivalent to specifying the /Oi+ option on the icc command line. 
  1328.  
  1329.       Note:  When the Turn on optimization (/O) option is active, inlining is 
  1330.              turned on by default. 
  1331.      In the Threshold entry field, type a number from 1 to 65535 to inline all 
  1332.       user functions qualified with the _Inline or inline keyword or that are 
  1333.       smaller than the Threshold value in abstract code units.  If you leave 
  1334.       this field blank, all user functions qualified with the _Inline or inline 
  1335.       keyword will be inlined regardless of their size. 
  1336.  
  1337.       Selecting this item is equivalent to specifying the /Oivalue option on 
  1338.       the icc command line. 
  1339.  
  1340.  
  1341. ΓòÉΓòÉΓòÉ 9.13. Enable performance analyzer ΓòÉΓòÉΓòÉ
  1342.  
  1343. Select the Enable performance analyzer check box to enable code to be run by 
  1344. the Performance Analyzer and other profiling tools by generated hooks in 
  1345. function prologs. 
  1346.  
  1347. Note:  To enable code for the Performance Analyzer, you must also select the 
  1348.        Generate debugging information check box on the Debugging page of the 
  1349.        Compiler Options notebook. 
  1350.  
  1351.  Selecting this item is equivalent to specifying the /Gh+ option on the icc 
  1352.  command line. 
  1353.  
  1354.  
  1355. ΓòÉΓòÉΓòÉ 9.14. Remove stack probes ΓòÉΓòÉΓòÉ
  1356.  
  1357. Select the Remove stack probes check box to remove stack probes from the code 
  1358. generated by the compiler. 
  1359.  
  1360. Selecting this item is equivalent to specifying the /Gs+ option on the icc 
  1361. command line. 
  1362.  
  1363.  
  1364. ΓòÉΓòÉΓòÉ 9.15. Remove C++ exception information ΓòÉΓòÉΓòÉ
  1365.  
  1366. Select the Remove C++ exception information check box to remove C++ exception 
  1367. handling information from the code generated by the compiler. 
  1368.  
  1369. Selecting this item is equivalent to specifying the /Gx+ option on the icc 
  1370. command line. 
  1371.  
  1372.  
  1373. ΓòÉΓòÉΓòÉ 9.16. Do not generate default library info ΓòÉΓòÉΓòÉ
  1374.  
  1375. Select the Do not generate default library info check box to indicate that the 
  1376. compiler should not provide linker information about the default libraries 
  1377. according to other Object code options. All libraries you want to link to must 
  1378. then be explicitly defined for the linker. 
  1379.  
  1380. Selecting this item is equivalent to specifying the /Gn+ option on the icc 
  1381. command line. 
  1382.  
  1383. If you do not select this item, the compiler identifies the the default 
  1384. libraries for the linker to use, according to other Object code options. This 
  1385. is equivalent to specifying the /Gn- option on the icc command line. 
  1386.  
  1387.  
  1388. ΓòÉΓòÉΓòÉ 9.17. Use optlink linkage ΓòÉΓòÉΓòÉ
  1389.  
  1390. Select the Use optlink linkage check box to indicate that you want to use 
  1391. _Optlink linkage for functions.  You must include the Programmer's Toolkit 
  1392. header files to call OS/2 application programming interfaces (API). 
  1393.  
  1394. Selecting this item is equivalent to specifying the /Mp+ option on the icc 
  1395. command line. 
  1396.  
  1397. If you do not select this option, _System linkage for functions will be used. 
  1398. You must include the VisualAge C++ library header files to call VisualAge C++ 
  1399. functions.  This is equivalent to specifying the /Ms+ option on the icc command 
  1400. line. 
  1401.  
  1402. You can also use _cdecl and _stdcall linkage, by specifying /Mc or /Mt in the 
  1403. User entry field on the User page. 
  1404.  
  1405.  
  1406. ΓòÉΓòÉΓòÉ 9.18. Use tiled memory ΓòÉΓòÉΓòÉ
  1407.  
  1408. Select the Use tiled memory check box to enable all variables to be passed to 
  1409. 16-bit functions.  Static and external variables are mapped into 16-bit 
  1410. segments.  Variables larger than 64K will be aligned on, but will still cross, 
  1411. 64K boundaries. 
  1412.  
  1413. When this option is selected, the memory management functions calloc, free, 
  1414. malloc, and realloc are mapped to the tiled versions _tcalloc, _tfree, 
  1415. _tmalloc, and _trealloc. 
  1416.  
  1417. Selecting this item is equivalent to specifying the /Gt+ option on the icc 
  1418. command line. 
  1419.  
  1420.  
  1421. ΓòÉΓòÉΓòÉ 9.19. Use fast floating point method ΓòÉΓòÉΓòÉ
  1422.  
  1423. Select the Use fast floating point method check box to indicate that you want 
  1424. the compiler to use fast floating-point execution. 
  1425.  
  1426. If your program does not need to abide by ANSI rules regarding the processing 
  1427. of double and float types, you can use this option to increase your program's 
  1428. performance. 
  1429.  
  1430. Because the floating-point method does not perform all the conversions 
  1431. specified by the ANSI standards, the results obtained may differ from results 
  1432. obtained using ANSI methods, but are often more precise. 
  1433.  
  1434. Selecting this item is equivalent to specifying the /Gf+ option on the icc 
  1435. command line. 
  1436.  
  1437.  
  1438. ΓòÉΓòÉΓòÉ 9.20. Generate code to run at ring 0 ΓòÉΓòÉΓòÉ
  1439.  
  1440. Select the Generate code to run at ring 0 check box to indicate that you want 
  1441. to generate object code to run at ring 0. Use this option if you are writing 
  1442. code such as device drivers or operating systems, that will run at ring 0 
  1443. instead of ring 3. 
  1444.  
  1445. If you select this item, you should also set the Executable environment option 
  1446. to Subsystem. Set this option on the first page under the Objects notebook tab. 
  1447.  
  1448. Selecting Generate code to run at ring 0 is equivalent to specifying the /Gr+ 
  1449. option on the icc command line. 
  1450.  
  1451.  
  1452. ΓòÉΓòÉΓòÉ 9.21. Remove unused data in intermediate files ΓòÉΓòÉΓòÉ
  1453.  
  1454. Select the Remove unused data in intermediate files check box to tell the 
  1455. compiler that external functions may not use data defined in the intermediate 
  1456. files being linked.  The data is only used within the intermediate files being 
  1457. linked, with the exception of data qualified with the _Export keyword. 
  1458.  
  1459. Selecting this item is equivalent to specifying the /Gu+ option on the icc 
  1460. command line. 
  1461.  
  1462. If you do not select this option, external functions will be allowed to use 
  1463. data in the intermediate files being linked (equivalent to specifying the /Gu- 
  1464. option on the icc command line). 
  1465.  
  1466.  
  1467. ΓòÉΓòÉΓòÉ 9.22. Invoke intermediate code linker ΓòÉΓòÉΓòÉ
  1468.  
  1469. Select the Invoke intermediate code linker check box to instruct the compiler 
  1470. to pass code through the intermediate code linker before generating an object 
  1471. file. 
  1472.  
  1473. Selecting this item is equivalent to specifying the /Ol+ option on the icc 
  1474. command line. 
  1475.  
  1476. See  Using the Intermediate Code Linker for more information on intermediate 
  1477. code. 
  1478.  
  1479.  
  1480. ΓòÉΓòÉΓòÉ 9.23. Generate FWAIT after load ΓòÉΓòÉΓòÉ
  1481.  
  1482. Select the Generate FWAIT after load check box to generate the FWAIT 
  1483. instruction after each floating-point load instruction.  This allows the 
  1484. program to take a floating-point stack overflow exception immediately after the 
  1485. load instruction that caused it. 
  1486.  
  1487. Note:  This option is not recommended because it increases the size of your 
  1488.        executable file and greatly decreases its performance. 
  1489.  
  1490.  Selecting this item is equivalent to specifying the /Gw+ option on the icc 
  1491.  command line. 
  1492.  
  1493.  
  1494. ΓòÉΓòÉΓòÉ 9.24. Use fast integer method ΓòÉΓòÉΓòÉ
  1495.  
  1496. Select the Use fast integer method check box to use fast integer execution. 
  1497.  
  1498. If you are shifting bits by a variable amount, you can use fast integer 
  1499. execution to ensure that for values greater than 31, the bits are shifted by 
  1500. the result of a modulo 32 of the value.  Otherwise, the result of the shift is 
  1501. 0. 
  1502.  
  1503. Note:  If your shift value is a constant greater than 32, the result will 
  1504.        always be 0. 
  1505.  
  1506.  Selecting this item is equivalent to specifying the /Gi+ option on the icc 
  1507.  command line. 
  1508.  
  1509.  
  1510. ΓòÉΓòÉΓòÉ 10. Preprocessor ΓòÉΓòÉΓòÉ
  1511.  
  1512. Use the Preprocessor page to set compiler options that let you control the use 
  1513. of the preprocessor. 
  1514.  
  1515. You have the following options: 
  1516.  
  1517.  Send the output to stdout 
  1518.            Send preprocessor output to sdout (/Pd) 
  1519.  
  1520.  Retain comments 
  1521.            Retain source code comments in preprocessor output (/Pc) 
  1522.  
  1523.  No line numbers 
  1524.            Suppress creation of #line directives in preprocessor output (/Pe) 
  1525.  
  1526.  Remove all user-defined macros 
  1527.            Remove user-defined macros from preprocessor output (/U*) 
  1528.  
  1529.  Remove 
  1530.            Remove specified macros from preprocessor output (/Umacro 
  1531.  
  1532.  Define 
  1533.            Define preprocessor macros (/Dname) 
  1534.  
  1535.  
  1536. ΓòÉΓòÉΓòÉ 10.1. Send the output to stdout ΓòÉΓòÉΓòÉ
  1537.  
  1538. Select Send the output to stdout check box to send the preprocessor output to 
  1539. the stream specified by stdout. 
  1540.  
  1541. Selecting this item is equivalent to specifying the /Pd+ option on the icc 
  1542. command line. 
  1543.  
  1544. If you do not select this item, the created preprocessor output file will have 
  1545. the same name as the source file with a .I file name extension.  This is 
  1546. equivalent to specifying the /Pd- option on the icc command line. 
  1547.  
  1548.  
  1549. ΓòÉΓòÉΓòÉ 10.2. Retain comments ΓòÉΓòÉΓòÉ
  1550.  
  1551. Select the Retain comments check box to include the source code comments in the 
  1552. generated preprocessor output file. 
  1553.  
  1554. Selecting this item is equivalent to specifying the /Pc+ option on the icc 
  1555. command line. 
  1556.  
  1557.  
  1558. ΓòÉΓòÉΓòÉ 10.3. No line numbers ΓòÉΓòÉΓòÉ
  1559.  
  1560. Select the No line numbers check box to suppress the creation of #line 
  1561. directives in preprocessor output. 
  1562.  
  1563. Selecting this item is equivalent to specifying the /Pe+ option on the icc 
  1564. command line. 
  1565.  
  1566.  
  1567. ΓòÉΓòÉΓòÉ 10.4. Remove all user-defined macros ΓòÉΓòÉΓòÉ
  1568.  
  1569. Select the Remove all user-defined macros check box to remove all macros that 
  1570. are user-defined. 
  1571.  
  1572. Note:  This option does not affect macros such as _DATE_, _TIME_, _TIMESTAMP_, 
  1573.        _FILE_, and _FUNCTION_, nor does it undefine macros defined in source 
  1574.        code. 
  1575.  
  1576.  Selecting this item is equivalent to specifying the /U* option on the icc 
  1577.  command line. 
  1578.  
  1579.  
  1580. ΓòÉΓòÉΓòÉ 10.5. Remove ΓòÉΓòÉΓòÉ
  1581.  
  1582. In the Remove entry box, specify the names of macros you want to remove from 
  1583. the preprocessor output.  For example, if you want to remove the macros 
  1584. _MY_MACRO_ and _EDS_MACRO_, then you would enter: 
  1585.  
  1586. _MY_MACRO_
  1587. _EDS_MACRO_
  1588.  
  1589. Entering the names of macros in this field is equivalent to specifying the 
  1590. /Uname option on the icc command line. 
  1591.  
  1592.  
  1593. ΓòÉΓòÉΓòÉ 10.6. Define ΓòÉΓòÉΓòÉ
  1594.  
  1595. In the Define entry box, specify the names and values for each preprocessor 
  1596. macro you want to define.  For example, if you want to define the macros 
  1597. _MY_MACRO_ to the value 43 and _EDS_MACRO_, to the value 28, then you would 
  1598. enter: 
  1599.  
  1600. _MY_MACRO_=43
  1601. _EDS_MACRO_=28
  1602.  
  1603. The macros you define in the Define list box will override macros already 
  1604. defined in your source code. 
  1605.  
  1606. Selecting this item is equivalent to specifying the /Dname[::n], or /Dname[=n] 
  1607. option on the icc command line. 
  1608.  
  1609.  
  1610. ΓòÉΓòÉΓòÉ 11. Other ΓòÉΓòÉΓòÉ
  1611.  
  1612. Use the Other page to set VisualAge C++ compiler options that control linker 
  1613. parameters, logo display, default char type, and other compiler options. 
  1614.  
  1615. You have the following options: 
  1616.  
  1617.  Make default char type unsigned 
  1618.            Set unspecified char to unsigned char, for arithmetic and compare 
  1619.            operations (/J) 
  1620.  
  1621.  Display the logo 
  1622.            Display compiler logo when compiler invoked (/Q-) 
  1623.  
  1624.  Length of external names 
  1625.            Set significant length for external names (/Hnum) 
  1626.  
  1627.  Version string 
  1628.            Set version string (/V) 
  1629.  
  1630.  Parameters passed to linker 
  1631.            Pass linker command-line options to linker (/B"options") 
  1632.  
  1633.  Preload compiler components 
  1634.            Preload compiler components as required (/Tl) 
  1635.  
  1636.  Timeout 
  1637.            Set number of minutes preloaded components stay in memory 
  1638.            (/Tlminutes) 
  1639.  
  1640.  
  1641. ΓòÉΓòÉΓòÉ 11.1. Make default char type unsigned ΓòÉΓòÉΓòÉ
  1642.  
  1643. Select the Make default char type unsigned check box to set unspecified char 
  1644. declarations to unsigned char, for arithmetic and compare operations. 
  1645.  
  1646. Selecting this item is equivalent to specifying the /J+ option on the icc 
  1647. command line. 
  1648.  
  1649. If you do not select this option, unspecified char declarations will be set to 
  1650. signed char. 
  1651.  
  1652.  
  1653. ΓòÉΓòÉΓòÉ 11.2. Display the logo ΓòÉΓòÉΓòÉ
  1654.  
  1655. Select the Display the logo check box to display the compiler logo when the 
  1656. compiler is invoked.  The logo is displayed on stderr. 
  1657.  
  1658. Selecting this item is equivalent to specifying the /Q- option on the icc 
  1659. command line. 
  1660.  
  1661.  
  1662. ΓòÉΓòÉΓòÉ 11.3. Length of external names ΓòÉΓòÉΓòÉ
  1663.  
  1664. In the Length of external names entry field, type a number from 6 to 255 to set 
  1665. the significant length for external names. 
  1666.  
  1667. Setting this option is equivalent to specifying the /Hnum option on the icc 
  1668. command line. 
  1669.  
  1670.  
  1671. ΓòÉΓòÉΓòÉ 11.4. Version string ΓòÉΓòÉΓòÉ
  1672.  
  1673. In the Version string entry field, type a text string up to 256 characters long 
  1674. to include in the object and executable files. 
  1675.  
  1676. This is equivalent to specifying the /V"string" option on the icc command line. 
  1677.  
  1678.  
  1679. ΓòÉΓòÉΓòÉ 11.5. Parameters passed to linker ΓòÉΓòÉΓòÉ
  1680.  
  1681. In the Parameters passed to linker entry list box, type any parameters you want 
  1682. passed to the linker.  The icc default parameters are also passed. 
  1683.  
  1684. This is equivalent to specifying the /B"options" option on the icc command 
  1685. line. 
  1686.  
  1687.  
  1688. ΓòÉΓòÉΓòÉ 11.6. Preload compiler components ΓòÉΓòÉΓòÉ
  1689.  
  1690. Select the Yes checkbox for the Preload compiler components settings to preload 
  1691. compiler components as they are required. 
  1692.  
  1693. Once a component is loaded, it remains in memory for 10 minutes, unless you 
  1694. specified a preferred timeout length in the Timeout field. If it is not 
  1695. referenced in that time (or the compiler is invoked again with this option 
  1696. turned off), it is unloaded.  Each compiler component has its own timer. 
  1697.  
  1698. Note:  This option is not available if you are using the OS/2 2.0 level of the 
  1699.        operating system without the Service Pack updates. 
  1700.  
  1701.  Selecting this item is equivalent to specifying the /Tl option on the icc 
  1702.  command line. 
  1703.  
  1704.  
  1705. ΓòÉΓòÉΓòÉ 11.7. Timeout ΓòÉΓòÉΓòÉ
  1706.  
  1707. Enter an integer between 1 and 65535 in the Timeout entry field to indicate the 
  1708. number of minutes you want preloaded compiler components to remain in memory. 
  1709.  
  1710. If you leave this field blank, the preloaded compiler components will remain in 
  1711. memory for 10 minutes. 
  1712.  
  1713. Selecting this item is equivalent to specifying the /Tl:value option on the icc 
  1714. command line, where value is the timeout value for the preloaded compiler 
  1715. components. 
  1716.  
  1717.  
  1718. ΓòÉΓòÉΓòÉ 12. User ΓòÉΓòÉΓòÉ
  1719.  
  1720. Use the User page to enter options that are passed verbatim to the compiler. 
  1721. Enter the options in the User entry field. 
  1722.  
  1723.  
  1724. ΓòÉΓòÉΓòÉ 12.1. User ΓòÉΓòÉΓòÉ
  1725.  
  1726. In the User entry field, type any options that you want passed to the compiler, 
  1727. verbatim. Use the command-line syntax for all compiler options. See Compiler 
  1728. Options for a summary of options and their command-line syntax. 
  1729.  
  1730. Note:  No consistency checking or conflict resolution is performed on any 
  1731.        options you enter in this field until the compiler is actually invoked. 
  1732.  
  1733.  
  1734. ΓòÉΓòÉΓòÉ 13. SOM ΓòÉΓòÉΓòÉ
  1735.  
  1736. Use the controls on the SOM page to set options that relate to SOM code. You 
  1737. can choose to: 
  1738.  
  1739.      Turn on implicit SOM mode 
  1740.      Disable direct access to attributes 
  1741.      Exclude files from implicit SOM mode 
  1742.      Initialize during static initialization 
  1743.      Write the release order to a file 
  1744.      Produce IDL files 
  1745.  
  1746.  
  1747. ΓòÉΓòÉΓòÉ 13.1. Implicit SOM mode ΓòÉΓòÉΓòÉ
  1748.  
  1749. This option turns on implicit SOM mode, and also causes the file som.hh to be 
  1750. included. It is equivalent to placing #pragma SOMAsDefault(on) at the start of 
  1751. the translation unit. 
  1752.  
  1753. All classes are implicitly derived from SOMObject until a #pragma 
  1754. SOMAsDefault(off) is encountered. 
  1755.  
  1756. The equivalent command-line option is /Ga. 
  1757.  
  1758. For further details, see the Programming Guide. 
  1759.  
  1760.  
  1761. ΓòÉΓòÉΓòÉ 13.2. Disable direct access to attributes ΓòÉΓòÉΓòÉ
  1762.  
  1763. This option instructs the compiler to disable direct access to attributes. 
  1764. Instead, the get and set methods are used.  This is equivalent to specifying 
  1765. #pragma SOMNoDataDirect(on) as the first line of the translation unit. 
  1766.  
  1767. The equivalent command-line option is /Gb. 
  1768.  
  1769. For further details, see the Programming Guide. 
  1770.  
  1771.  
  1772. ΓòÉΓòÉΓòÉ 13.3. Exclude files from implicit SOM mode ΓòÉΓòÉΓòÉ
  1773.  
  1774. Use this option to exclude files in the directories specified in the 
  1775. Directories to be excluded list when implicit SOM mode is turned on (when 
  1776. classes are implicitly derived from SOM). 
  1777.  
  1778. This option is valid only when implicit SOM mode is enabled. It allows you to 
  1779. exclude the classes contained in the specified include files from being made 
  1780. into implicit SOM classes. 
  1781.  
  1782. The equivalent command-line option is /Xs. 
  1783.  
  1784.  
  1785. ΓòÉΓòÉΓòÉ 13.4. Directories to be excluded ΓòÉΓòÉΓòÉ
  1786.  
  1787. Use this entry field to enter the directories you want to exclude from implicit 
  1788. SOM mode. You must first select the Exclude files from implicit SOM mode 
  1789. checkbox. 
  1790.  
  1791.  
  1792. ΓòÉΓòÉΓòÉ 13.5. Initialize during static initialization ΓòÉΓòÉΓòÉ
  1793.  
  1794. Use this option to initialize SOM classes at their point of first use during 
  1795. the execution of your program. 
  1796.  
  1797. By default, all SOM classes used in your program are initialized at static 
  1798. initialization time. This makes your program faster, but may result in the 
  1799. initialization of classes that are not used. 
  1800.  
  1801. When you set this option, SOM classes are not initialized until they are 
  1802. actually referenced in your program at run time. This avoids the initialization 
  1803. of unused classes, but requires a run-time check before every SOM class object 
  1804. reference to ensure that the class has been initialized. 
  1805.  
  1806. The equivalent command-line option is /Gz. 
  1807.  
  1808. For further details, see the Programming Guide. 
  1809.  
  1810.  
  1811. ΓòÉΓòÉΓòÉ 13.6. Produce file ΓòÉΓòÉΓòÉ
  1812.  
  1813. The Produce file group has two options: 
  1814.  
  1815.  Release order 
  1816.            Use this option to have the compiler write the release order of the 
  1817.            specified class to stdout. The release order is written in the form 
  1818.            of a SOMReleaseOrder pragma.  You can capture the output from this 
  1819.            option when developing new SOM classes, and include the pragma in 
  1820.            the class definition. 
  1821.  
  1822.            The equivalent command-line option is /Fr. 
  1823.  
  1824.            For further details, see the Programming Guide. 
  1825.  
  1826.  IDL 
  1827.            Use this option to have the compiler generate an IDL file if a file 
  1828.            with an .hh extension is explicitly specified on the command line. 
  1829.            You can specify a path and name for the IDL file. If you do not 
  1830.            specify a name for the file, then an IDL file is created for every 
  1831.            .hh file specified, and placed in the current directory. If you set 
  1832.            this option off, then IDL files are not generated. 
  1833.  
  1834.            The equivalent command-line option is /Fs. 
  1835.  
  1836.  
  1837. ΓòÉΓòÉΓòÉ <hidden> Keys Help ΓòÉΓòÉΓòÉ
  1838.  
  1839. The list of keys is arranged in groups. 
  1840.  
  1841. Use: 
  1842.  
  1843.      HELP KEYS to get help 
  1844.  
  1845.      SYSTEM KEYS to switch between programs 
  1846.  
  1847.      WINDOW KEYS to move around in a program window 
  1848.  
  1849.      POP-UP WINDOW KEYS to make a selection in a pop-up window 
  1850.  
  1851.      EDITING KEYS to make changes in a pop-up window. 
  1852.  
  1853.  When two key names are joined by a plus sign (+), use these two keys together. 
  1854.  Hold down the first key and press the second key. 
  1855.  
  1856.  HELP KEYS 
  1857.  
  1858.  F1 
  1859.            Get help 
  1860.  F2 
  1861.            Get extended help (from within any help window) 
  1862.  F9 
  1863.            Go to a list of keys (from within any help window) 
  1864.  F11 or Shift+F1 
  1865.            Go to the help index (from within any help window) 
  1866.  Esc 
  1867.            Cancel help 
  1868.  Alt+F4 
  1869.            Close the help window 
  1870.  Shift+F10 
  1871.            Get help for help 
  1872.  
  1873.  SYSTEM KEYS 
  1874.  
  1875.  Alt+Esc 
  1876.            Switch to the next program, including full-screen programs 
  1877.  Alt+Tab 
  1878.            Switch to the next windowed program 
  1879.  Ctrl+Esc 
  1880.            Switch to the Task List 
  1881.  
  1882.  WINDOW KEYS 
  1883.  
  1884.  F10 
  1885.            Go to/from the action bar 
  1886.  Arrow keys 
  1887.            Move among choices 
  1888.  End 
  1889.            Go to the last choice in a pull-down 
  1890.  Esc 
  1891.            Cancel a pull-down, the system menu, or window 
  1892.  Home 
  1893.            Go to the first choice in a pull-down 
  1894.  PgUp 
  1895.            Scroll the contents of the window up one page 
  1896.  PgDn 
  1897.            Scroll the contents of the window down one page 
  1898.  Underlined letter 
  1899.            Move among the choices on the action bar and select pull-down items 
  1900.  Alt 
  1901.            Go to/from the action bar 
  1902.  Alt+F4 
  1903.            Close the window 
  1904.  Alt+F5 
  1905.            Restore the window 
  1906.  Alt+F7 
  1907.            Move the window 
  1908.  Alt+F8 
  1909.            Size the window 
  1910.  Alt+F9 
  1911.            Minimize the window 
  1912.  Alt+F10 
  1913.            Maximize the window 
  1914.  Ctrl+PgDn 
  1915.            Scroll the contents of the window right one page 
  1916.  Ctrl+PgUp 
  1917.            Scroll the contents of the window left one page 
  1918.  Shift+Esc or Alt+Spacebar 
  1919.            Go to/from the system menu 
  1920.  Shift+Esc or Alt 
  1921.            Go to/from the system menu of a text window 
  1922.  
  1923.  POP-UP WINDOW KEYS 
  1924.  
  1925.  Enter 
  1926.            Complete the pop-up window 
  1927.  Esc 
  1928.            Cancel the pop-up window 
  1929.  Spacebar 
  1930.            Set a check box on/off or perform the task described on the selected 
  1931.            pushbutton 
  1932.  Tab 
  1933.            Move to the next entry field or check box 
  1934.  
  1935.  EDITING KEYS 
  1936.  
  1937.  Backspace (left arrow delete) 
  1938.            Delete the character to the left of the cursor 
  1939.  Del 
  1940.            Delete the character at the cursor 
  1941.  End or Ctrl+Right Arrow key 
  1942.            Move to the end of a field 
  1943.  Home or Ctrl+Left Arrow key 
  1944.            Move to the beginning of a field. 
  1945.  
  1946.  
  1947. ΓòÉΓòÉΓòÉ <hidden> Conflicting Compiler Options ΓòÉΓòÉΓòÉ
  1948.  
  1949. You have specified two or more options that are incompatible. Select Ignore 
  1950. conflict to continue and let one option take precedence, as indicated.  Select 
  1951. Cancel to return to the Compiler Options settings notebook. 
  1952.  
  1953. The following rules apply if you specify an incompatible option: 
  1954.  
  1955.      You indicated that you wanted to perform syntax checking only, as well as 
  1956.       one or more of the following: run the preprocessor; create a listing 
  1957.       title, subtitle, and page length without actual output; any object code 
  1958.       control option; any debug option; compile and not link; a version string; 
  1959.       parameters to pass to the linker. The option to perform syntax checking 
  1960.       takes precedence over the other options selected so the other options are 
  1961.       ignored. 
  1962.  
  1963.      You indicated that you wanted to run the preprocessor, as well as one or 
  1964.       more of the following: create any file listing; any listing option; any 
  1965.       object code control option; any debug option; compile and not link; a 
  1966.       version string; parameters to pass to the linker. The option to run only 
  1967.       the preprocessor takes precedence over the other options selected so that 
  1968.       other options are ignored. 
  1969.  
  1970.      You indicated that you wanted to compile only (without performing the 
  1971.       link step) and also that you wanted to create an  .EXE file, or a linker 
  1972.       map.  The option to compile only takes precedence. 
  1973.  
  1974.      You indicated that you did not want to create an object file but also 
  1975.       that you wanted to generate debugging and/or profiling information.  The 
  1976.       option not to create an object file takes precedence. 
  1977.  
  1978.      You indicated that you wanted to enable subsystem development but also 
  1979.       indicated you wanted to use ddnames. The option to enable subsystem 
  1980.       development takes precedence. 
  1981.  
  1982.      You indicated that you wanted to use tiled memory, but also that you 
  1983.       wanted to use the debug memory management functions. The option to use 
  1984.       the tiled memory takes precedence. 
  1985.  
  1986.      You indicated that you wanted to generate executable code that runs in a 
  1987.       VisualAge C++ runtime environment, but also that you wanted to generate 
  1988.       object code to run at ring 0.  The option to generate executable code to 
  1989.       run in the runtime environment takes precedence. 
  1990.  
  1991.  
  1992. ΓòÉΓòÉΓòÉ <hidden> Ignore conflict ΓòÉΓòÉΓòÉ
  1993.  
  1994. Click on the Ignore conflict push button to indicate that you want to save your 
  1995. changes and use the options that take precedence. 
  1996.  
  1997.  
  1998. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  1999.  
  2000. Click on the Cancel push button to return to the Compiler Options notebook and 
  2001. correct conflicting options. 
  2002.  
  2003.  
  2004. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  2005.  
  2006. Click on the OK push button to save the settings you made and close the 
  2007. Compiler Options notebook 
  2008.  
  2009.  
  2010. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  2011.  
  2012. Click on the Default pushbutton to set all the options in the Compiler Options 
  2013. notebook back to their default settings. 
  2014.  
  2015.  
  2016. ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ
  2017.  
  2018. Click on the Reset push button to update the compiler options settings to their 
  2019. initial values. 
  2020.  
  2021.  
  2022. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  2023.  
  2024. Click on the Cancel push button to close the Compiler Options notebook without 
  2025. saving any changes. 
  2026.  
  2027.  
  2028. ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ
  2029.  
  2030. Click on the Help push button to get help on the Compiler Options notebook. 
  2031.  
  2032.  
  2033. ΓòÉΓòÉΓòÉ <hidden> Reset Page ΓòÉΓòÉΓòÉ
  2034.  
  2035. Click on the Reset Page push button to update the compiler options settings in 
  2036. this page to their initial values. 
  2037.  
  2038.  
  2039. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  2040.  
  2041. Click on the Default push button to update the compiler options with their 
  2042. default values. 
  2043.  
  2044.  
  2045. ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ
  2046.  
  2047. Click on the Help push button to get help on this page of the Compiler Options 
  2048. notebook. 
  2049.  
  2050.  
  2051. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2052.  
  2053. Explanation: 
  2054.  
  2055. You are using a compiler options file from a previous version of the WorkFrame 
  2056. product.  Do you want to use the default option settings? 
  2057.  
  2058. Recovery: 
  2059.  
  2060. Select Yes to open the Compiler Options notebook with the default option 
  2061. settings. Select No to cancel the current operation. 
  2062.  
  2063.  
  2064. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2065.  
  2066. Explanation: 
  2067.  
  2068. The options file for your project has been corrupted. 
  2069.  
  2070. Recovery: 
  2071.  
  2072. Use the default options and then reset them to your preferred settings. 
  2073.  
  2074.  
  2075. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2076.  
  2077. Explanation: 
  2078.  
  2079. An error occurred while trying to allocate memory.  There may be insufficient 
  2080. memory to complete the task. 
  2081.  
  2082. Recovery: 
  2083.  
  2084. Close one or more other tasks, and retry the command. 
  2085.  
  2086.  
  2087. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2088.  
  2089. Explanation: 
  2090.  
  2091. You have chosen to discard all the changes made to the Compiler Options 
  2092. settings.  Are you sure you want to discard the changes? 
  2093.  
  2094. Recovery: 
  2095.  
  2096. Select the Yes push button if you want to discard the changes and exit from the 
  2097. Compiler Options notebook.  Select the No pushbutton if you want to retain the 
  2098. changes and return to the previous page without exiting from the Compiler 
  2099. Options notebook 
  2100.  
  2101.  
  2102. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2103.  
  2104. Explanation: 
  2105.  
  2106. No files that match the specified file specifier were found. Do you want to 
  2107. ignore it? 
  2108.  
  2109. Recovery: 
  2110.  
  2111. Select Yes to ignore the file specifier, save the option settings, and close 
  2112. the Compiler Options notebook.  Select No to return to the previous page 
  2113. without closing the Compiler Options notebook. 
  2114.  
  2115.  
  2116. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2117.  
  2118. Explanation: 
  2119.  
  2120. One or more of the specified paths does not exist. Do you want to ignore it? 
  2121.  
  2122. Recovery: 
  2123.  
  2124. Select Yes to ignore the specified path, save the current settings, and close 
  2125. the Compiler Options notebook.  Select No to return to the previous page. 
  2126.  
  2127. See the OS/2* Return Codes Help for more information on the error. 
  2128.  
  2129.  
  2130. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2131.  
  2132. Explanation: 
  2133.  
  2134. One or more of the specified paths contains a directory name that is longer 
  2135. than the maximum length permitted by the operating system. 
  2136.  
  2137. Recovery: 
  2138.  
  2139. Enter a shorter directory name and try the command again. 
  2140.  
  2141. See the OS/2* Return Codes Help for more information on the error. 
  2142.  
  2143.  
  2144. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2145.  
  2146. Explanation: 
  2147.  
  2148. This field requires the names of one or more directory path names.  The path 
  2149. name must not contain the name of a file. 
  2150.  
  2151. Recovery: 
  2152.  
  2153. Type a valid directory path name in the field. 
  2154.  
  2155.  
  2156. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2157.  
  2158. Explanation:  The directory path name must be an existing path and must follow 
  2159. the naming conventions for directories: 
  2160.  
  2161.      The name must be 1 to 8 alphanumeric characters 
  2162.  
  2163.      The first character must be alphabetic 
  2164.  
  2165.      The name cannot contain embedded blanks, or the characters @, #, and $ 
  2166.  
  2167.      If you are specifying more than one path name, separate each with a 
  2168.       semicolon. 
  2169.  
  2170.  Recovery:  Type a valid directory path name in the field. 
  2171.  
  2172.  See the OS/2* Return Codes Help for more information on the error. 
  2173.  
  2174.  
  2175. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2176.  
  2177. Explanation: 
  2178.  
  2179. You have chosen to reset the compiler options to their previous settings.  Are 
  2180. you sure you want to reset the compiler options? 
  2181.  
  2182. Recovery: 
  2183.  
  2184. Select Yes if you want to reset the compiler option settings. Select No to 
  2185. retain their current settings.  You are then returned to the Compiler Options 
  2186. notebook. 
  2187.  
  2188.  
  2189. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2190.  
  2191. Explanation: 
  2192.  
  2193. You have chosen to reset the compiler options to their default settings.  Are 
  2194. you sure you want to update the compiler options with their default settings? 
  2195.  
  2196. Recovery: 
  2197.  
  2198. Select the Yes push button if you want to reset the compiler options to the 
  2199. default settings.  Select the No push button if you want to retain their 
  2200. current settings.  You are then returned to the Compiler Options notebook. 
  2201.  
  2202.  
  2203. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2204.  
  2205. Explanation: 
  2206.  
  2207. The application was unable to create a dialog panel for the Compiler Options 
  2208. notebook due to insufficient system resources. 
  2209.  
  2210. Recovery: 
  2211.  
  2212. Close one or more other tasks, and retry the command. 
  2213.  
  2214.  
  2215. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2216.  
  2217. Explanation: 
  2218.  
  2219. The system path length could not be obtained. 
  2220.  
  2221. Recovery: 
  2222.  
  2223. See the OS/2* Return Codes Help for more information on the error. 
  2224.  
  2225.  
  2226. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2227.  
  2228. Explanation: 
  2229.  
  2230. An integer between 1 and 65535 is expected for the Timeout field for preloaded 
  2231. compiler components. You may also leave this field blank. 
  2232.  
  2233. Recovery: 
  2234.  
  2235. Type a number between 1 and 65535, or leave the field blank. 
  2236.  
  2237.  
  2238. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2239.  
  2240. Explanation: 
  2241.  
  2242. An unknown error has been detected. 
  2243.  
  2244. Recovery: 
  2245.  
  2246. See the OS/2* Return Codes Help for more information on the error. 
  2247.  
  2248.  
  2249. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2250.  
  2251. Explanation: 
  2252.  
  2253. An integer between 1 and 65535 is expected for the Stop on error count of 
  2254. field.  You may also leave this field blank. 
  2255.  
  2256. Recovery: 
  2257.  
  2258. Type a number between 1 and 65535, or leave the field blank. 
  2259.  
  2260.  
  2261. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2262.  
  2263. Explanation: 
  2264.  
  2265. An integer between 15 and 65535 is expected for the Page length field. 
  2266.  
  2267. Recovery: 
  2268.  
  2269. Type a number between 15 and 65535. 
  2270.  
  2271.  
  2272. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2273.  
  2274. Explanation: 
  2275.  
  2276. An integer between 6 and 255 is expected for the Length of external names 
  2277. field. 
  2278.  
  2279. Recovery: 
  2280.  
  2281. Type a number between 6 and 255. 
  2282.  
  2283.  
  2284. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2285.  
  2286. Explanation: 
  2287.  
  2288. An integer between 1 and 65535 is expected for the left and right margins.  The 
  2289. right margin value must be greater than that specified for the left margin. 
  2290.  
  2291. Recovery: 
  2292.  
  2293. Type a number between 1 and 65535 for the right and left margin fields. 
  2294. Specify a number for the right margin that is greater than that specified for 
  2295. the left margin. 
  2296.  
  2297.  
  2298. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2299.  
  2300. Explanation: 
  2301.  
  2302. An integer between 1 and 65535 is expected for the left and right sequence 
  2303. numbers.  The right sequence value must be an asterisk (*) to denote no right 
  2304. sequence column or an integer greater than that specified for the left sequence 
  2305. column. 
  2306.  
  2307. Recovery: 
  2308.  
  2309. Type a number between 1 and 65535 for the right and left sequence numbers.  For 
  2310. the right sequence column, specify an asterisk or a number that is greater than 
  2311. that specified for the left sequence column. 
  2312.  
  2313.  
  2314. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2315.  
  2316. Explanation: 
  2317.  
  2318. An integer between 1 and 65535 is expected for the inlining threshold. You may 
  2319. also leave this field blank. 
  2320.  
  2321. Recovery: 
  2322.  
  2323. Enter a number between 1 and 65535 or leave the field blank. 
  2324.  
  2325.  
  2326. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2327.  
  2328. Explanation: 
  2329.  
  2330. There is not enough storage allocated to store the compile options string. 
  2331.  
  2332. Recovery: 
  2333.  
  2334. Use the Language Profile Management window to change one or both of the Maximum 
  2335. compile string and Maximum compile size field values in the language profile so 
  2336. that more storage is allocated. 
  2337.  
  2338.  
  2339. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2340.  
  2341. Explanation: 
  2342.  
  2343. You are using a Compiler Options file from a previous version of the WorkFrame 
  2344. product. Would you like to convert the old compiler option settings to the new 
  2345. version? 
  2346.  
  2347. Recovery: 
  2348.  
  2349. Select Yes to indicate that you want an automatic conversion to be performed 
  2350. using the old compiler options file. 
  2351.  
  2352. Note:  Options have been added, changed, or deleted since the last version. 
  2353.        Please read through the option settings in the Compiler Options notebook 
  2354.        after the conversion has been completed. 
  2355.  
  2356.  Select No to use the default options. 
  2357.  
  2358.  
  2359. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2360.  
  2361. Explanation: 
  2362.  
  2363. The compiler options dialog needs to store information with the project file. 
  2364. Because the project file does not exist yet, you cannot set the compiler 
  2365. options at this time. 
  2366.  
  2367. Recovery: 
  2368.  
  2369. For Version 1.1 of the WorkFrame/2, finish creating the project by specifying 
  2370. any other options (except those for the compiler), and then selecting the OK 
  2371. push button. Once the project has been created, you can set the compiler 
  2372. options from the Options pull down on the WorkFrame/2 menu bar. 
  2373.  
  2374. See the OS/2* Return Codes Help for more information on the error. 
  2375.  
  2376.  
  2377. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2378.  
  2379. Explanation: 
  2380.  
  2381. The specified file could not be found.  A symbolic file name in the original 
  2382. source file might have caused this error. Occurrences of the indicated file 
  2383. will be commented out in the created makefile. 
  2384.  
  2385. Recovery: 
  2386.  
  2387.    1. Verify that the INCLUDE environment variable is set up correctly. 
  2388.  
  2389.    2. Verify that the file exists. 
  2390.  
  2391.    3. You can have the Make Make ignore the error by selecting the Ignore push 
  2392.       button. The file will appear in the generated make file, but it will not 
  2393.       be checked for any further include files. 
  2394.  
  2395.  
  2396. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2397.  
  2398. Explanation: 
  2399.  
  2400. Make Make could not acquire enough storage to complete the make file generation 
  2401.  
  2402. Recovery: 
  2403.  
  2404. Close other sessions, or make more room on the disk for the OS/2 swap file, 
  2405. then try the operation again. 
  2406.  
  2407.  
  2408. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2409.  
  2410. Explanation: 
  2411.  
  2412. The name of the specified #include file may be too long or may contain invalid 
  2413. characters. 
  2414.  
  2415. Recovery: 
  2416.  
  2417. Verify the name of the invalid #include file in the source. 
  2418.  
  2419.  
  2420. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2421.  
  2422. Explanation: 
  2423.  
  2424. The specified #include uses a preprocressor variable that could not be 
  2425. resolved. 
  2426.  
  2427. Recovery: 
  2428.  
  2429. Do one of the following to recover: 
  2430.  
  2431.    1. Have Make Make ignore the error by selecting the Ignore push button.  The 
  2432.       file will not appear as a dependency in the generated make file. You can 
  2433.       then manually update the make file later. 
  2434.  
  2435.    2. Restructure the C/C++ source file to remove the preprocessor variable 
  2436.       construct so that the #include can be resolved by the make file creation 
  2437.       utility, then try the operation again. 
  2438.  
  2439.  
  2440. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2441.  
  2442. Explanation: 
  2443.  
  2444. The make file creation utility encountered an error while reading the specified 
  2445. file.  If the file is on a removable medium, you may have deleted or moved it. 
  2446. If it is on a LAN, the connection to the LAN server may have been broken. 
  2447.  
  2448. Recovery: 
  2449.  
  2450. Verify that the specified file is in the expected location and that it is 
  2451. accessible, then retry the operation.  If the problem persists, contact your 
  2452. IBM Service Representative. 
  2453.  
  2454.  
  2455. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2456.  
  2457. Explanation: 
  2458.  
  2459. The make file creation utility was able to find the file, but could not open 
  2460. it.  Another process may have the file open, or the file name may specify a 
  2461. directory. 
  2462.  
  2463. Recovery: 
  2464.  
  2465. Do one of the following to recover: 
  2466.  
  2467.    1. You can have the Make Make ignore the error by selecting the Ignore push 
  2468.       button. The indicated file will appear in the generated make file, but it 
  2469.       will not be checked for any further include files. 
  2470.  
  2471.    2. Halt the other process that is using the specified file then retry the 
  2472.       operation. 
  2473.  
  2474.    3. Correct the source in which this file name appears then retry the 
  2475.       operation. 
  2476.  
  2477.  
  2478. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2479.  
  2480. Explanation: 
  2481.  
  2482. The specified file may not exist or may be in use by another process. 
  2483.  
  2484. Recovery: 
  2485.  
  2486. Ensure that the file exists and that it is not in use by another process, then 
  2487. try the operation again. 
  2488.  
  2489.  
  2490. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2491.  
  2492. Explanation: 
  2493.  
  2494. The specified file may be in use by another process, or there may not be enough 
  2495. disk space to write the new information on disk. 
  2496.  
  2497. Recovery: 
  2498.  
  2499. Ensure that the file is not in use by another process, and that there is enough 
  2500. disk space to save the information by deleting or moving unecessary files. 
  2501.  
  2502.  
  2503. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2504.  
  2505. Explanation: 
  2506.  
  2507. The specified project file may be corrupt or invalid. 
  2508.  
  2509. Recovery: 
  2510.  
  2511. Ensure that the specified project file is a valid WorkFrame V2.0 project file. 
  2512.  
  2513.  
  2514. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2515.  
  2516. Explanation: 
  2517.  
  2518. The file could not be found, may be in use by another process, or a system 
  2519. error could have occurred. 
  2520.  
  2521. Recovery: 
  2522.  
  2523. Ensure that the file exists in the expected location and that it is not in use 
  2524. by another process, then retry the operation. 
  2525.  
  2526. If this error persists, contact your IBM Service Representative. 
  2527.  
  2528.  
  2529. ΓòÉΓòÉΓòÉ <hidden> Retry ΓòÉΓòÉΓòÉ
  2530.  
  2531. Click on the Retry push button to try the operation again. 
  2532.  
  2533.  
  2534. ΓòÉΓòÉΓòÉ <hidden> Abort ΓòÉΓòÉΓòÉ
  2535.  
  2536. Click on the Abort push button to terminate the current operation.  No make 
  2537. files will be generated. 
  2538.  
  2539.  
  2540. ΓòÉΓòÉΓòÉ <hidden> Ignore ΓòÉΓòÉΓòÉ
  2541.  
  2542. Click on the Ignore pushbutton to continue without acknowledging the specified 
  2543. error.  The make file will be generated but ignoring the error may cause a 
  2544. related component to be left out of the make file. 
  2545.  
  2546.  
  2547. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2548.  
  2549. Explanation: 
  2550.  
  2551. The application was unable to access the project file.  This may be caused by 
  2552. one of the following reasons: 
  2553.  
  2554.      The drive was not ready.  Make sure there is a diskette in the drive you 
  2555.       want to save the file to. 
  2556.  
  2557.      The diskette or disk you wanted to write to may be full.  Delete some 
  2558.       files or specify another disk to write to. 
  2559.  
  2560.      The diskette or disk may be write-protected.  Remove the write protection 
  2561.       on the disk to save the file on it. 
  2562.  
  2563.      The specified path may not exist in your system.  If you have made a 
  2564.       typing error, re-enter the path.  Otherwise, create the path on your 
  2565.       system or specify another path. 
  2566.  
  2567.      The file permissions may be set to read-only.  Change the file permission 
  2568.       to allow writes or specify another filename to save the file to. 
  2569.  
  2570.  See the OS/2* Return Codes Help for more information on the error. 
  2571.  
  2572.  
  2573. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  2574.  
  2575. For more information on a message, select it from the list below: 
  2576.  
  2577.      Compiler DLL internal error - insufficient heap 
  2578.  
  2579.      Invalid #include in file <filename> - include name = <include name> 
  2580.  
  2581.      Indeterminate #include in file <filename> - include name = <include name> 
  2582.  
  2583.      Cannot open file <filename> 
  2584.  
  2585.      Cannot find file <filename> 
  2586.  
  2587.      Error reading file <filename> 
  2588.  
  2589.  
  2590.  
  2591. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2592.  
  2593. The listing file includes information from the compiler but is not intended for 
  2594. use as a programming interface.