home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional Developers Kit 1992 November / Disc01 / Disc01.mdf / runnable / ibmwf / help / dde3prof.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1992-08-27  |  28.6 KB  |  1,111 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Special 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 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, denoted by an asterisk (*) in this help, are trademarks of 
  22. the IBM Corporation in the United States and/or other countries: 
  23.  
  24.  C/2 
  25.  C Set/2 
  26.  IBM 
  27.  OS/2 
  28.  Operating System/2 
  29.  Presentation Manager 
  30.  WorkFrame/2 
  31.  
  32.  This help contains examples of data and reports used in daily business 
  33.  operations. To illustrate them as completely as possible, the examples include 
  34.  the names of individuals, companies, brands, and products. All of these names 
  35.  are fictitious and any similarity to the names and addresses used by an actual 
  36.  business enterprise is entirely coincidental. 
  37.  
  38.  
  39. ΓòÉΓòÉΓòÉ 2. Language Profile Management ΓòÉΓòÉΓòÉ
  40.  
  41. Use this window to create, change, or delete language profiles. 
  42.  
  43. If a language product is designed to be used with the WorkFrame/2* product, it 
  44. will likely come with a language profile. However, if you have a language 
  45. product that is not designed for use with the WorkFrame/2* product, you can 
  46. create one. The WorkFrame/2* product also provides a default language profile 
  47. that you can modify for use with most compilers. 
  48.  
  49. To create a new language profile: 
  50.  
  51.   1. Look at the Language name list box to see if any of the profiles are 
  52.      similar to the one you want to create. If there is a similar profile, 
  53.      select it to initialize the settings of the New Language Profile window. 
  54.  
  55.   2. Select the New pushbutton to open the New Language Profile window. 
  56.  
  57.  To change a language profile: 
  58.  
  59.   1. Select the profile in the Language name list box. 
  60.  
  61.   2. Select the Change pushbutton to open the Change Language Profile window. 
  62.  
  63.  To delete a language profile: 
  64.  
  65.   1. Select the language profile you want to delete in the Language name list 
  66.      box. 
  67.  
  68.   2. Select the Delete pushbutton to delete the language profile. 
  69.  
  70.  Note:  If you delete a language profile, you need to change any projects using 
  71.         the deleted profile so that they use another language profile. Or, if 
  72.         you no longer need those projects, you can delete them. 
  73.  
  74.  
  75. ΓòÉΓòÉΓòÉ <hidden> Controls ΓòÉΓòÉΓòÉ
  76.  
  77.  Language Names 
  78.  
  79.  New 
  80.  
  81.  Delete 
  82.  
  83.  Change 
  84.  
  85.  OK 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ <hidden> Language Names ΓòÉΓòÉΓòÉ
  89.  
  90. Use this list box to select which language profiles you want to create, change, 
  91. or delete. 
  92.  
  93. To create a new language profile: 
  94.  
  95.   1. Look at the Language name list box to see if any of the profiles are 
  96.      similar to the one you want to create. If there is a similar profile, 
  97.      select it to initialize the settings of the New Language Profile window. 
  98.  
  99.   2. Select the New pushbutton to open the New Language Profile window. 
  100.  
  101.  To change a language profile: 
  102.  
  103.   1. Select the profile in the Language name list box. 
  104.  
  105.   2. Select the Change pushbutton to open the Change Language Profile window. 
  106.  
  107.  To delete a language profile: 
  108.  
  109.   1. Select the language profile you want to delete in the Language name list 
  110.      box. 
  111.  
  112.   2. Select the Delete pushbutton to delete the language profile. 
  113.  
  114.  Note:  If you delete a language profile, you need to change any projects using 
  115.         the deleted profile so that they use another language profile. Or, if 
  116.         you no longer need those projects, you can delete them. 
  117.  
  118.  
  119. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  120.  
  121. Select OK to remove the window. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ <hidden> New ΓòÉΓòÉΓòÉ
  125.  
  126. Select this pushbutton to open the New Language Profile window. This window 
  127. lets you create a new language profile. 
  128.  
  129. To create a new language profile: 
  130.  
  131.   1. Look at the Language name list box to see if any of the profiles are 
  132.      similar to the one you want to create. If there is a similar profile, 
  133.      select it to initialize the settings of the New Language Profile window. 
  134.  
  135.   2. Select the New pushbutton to open the New Language Profile window. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ <hidden> Change ΓòÉΓòÉΓòÉ
  139.  
  140. Select this pushbutton to open the Change Language Profile window. This window 
  141. lets you change the contents of a language profile. 
  142.  
  143. To change a language profile: 
  144.  
  145.   1. Select the profile in the Language name list box. 
  146.  
  147.   2. Select the Change pushbutton to open the Change Language Profile window. 
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ <hidden> Delete ΓòÉΓòÉΓòÉ
  151.  
  152. Select this pushbutton to delete the selected language profile. 
  153.  
  154. To delete a language profile: 
  155.  
  156.   1. Select the language profile you want to delete in the Language name list 
  157.      box. 
  158.  
  159.   2. Select the Delete pushbutton to delete the language profile. 
  160.  
  161.  Note:  If you delete a language profile, you need to change any projects using 
  162.         the deleted profile so that they use another language profile. Or, if 
  163.         you no longer need those projects, you can delete them. 
  164.  
  165.  
  166. ΓòÉΓòÉΓòÉ 3. New Language Profile ΓòÉΓòÉΓòÉ
  167.  
  168. Use this window to create a new language profile. 
  169.  
  170. To create a new profile: 
  171.  
  172.   1. Define the characteristics of the language by specifying the options in 
  173.      the window. 
  174.  
  175.   2. If you want to specify paths used to find include files and libraries, 
  176.      select the Language variables pushbutton. 
  177.  
  178.  The directory indicated in the top left part of the window shows where the 
  179.  profile will be saved. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 4. Change Language Profile ΓòÉΓòÉΓòÉ
  183.  
  184. Use this window to change a language profile. 
  185.  
  186. To change a language profile: 
  187.  
  188.   1. Type over the characteristics of the language you want to change. 
  189.  
  190.   2. If you want to change the paths used to find include files and libraries, 
  191.      select the Language variables pushbutton. 
  192.  
  193.  The directory indicated in the top left part of the window shows where the 
  194.  profile will be saved. 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ <hidden> Controls ΓòÉΓòÉΓòÉ
  198.  
  199.  Language Variables 
  200.  
  201.  File Name 
  202.  
  203.  Language Name 
  204.  
  205.  Language Eyecatcher 
  206.  
  207.  Language Extension 
  208.  
  209.  Language Compiler 
  210.  
  211.  Compile Options Dynamic Link Library 
  212.  
  213.  Language Linker 
  214.  
  215.  Link Options Dynamic Link Library 
  216.  
  217.  Language Maker 
  218.  
  219.  Maker Options Dynamic Link Library 
  220.  
  221.  Language Debugger 
  222.  
  223.  Debugger Options Dynamic Link Library 
  224.  
  225.  Default Make String 
  226.  
  227.  Default Debug String 
  228.  
  229.  Maximum Compiler Size 
  230.  
  231.  Maximum Compiler String 
  232.  
  233.  Maximum Linker Size 
  234.  
  235.  Maximum Linker String 
  236.  
  237.  Debugger Program Type 
  238.  
  239.  Used Eyecatchers 
  240.  
  241.  OK 
  242.  
  243.  Reset 
  244.  
  245.  Default 
  246.  
  247.  Clear 
  248.  
  249.  Cancel 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ <hidden> Controls ΓòÉΓòÉΓòÉ
  253.  
  254.  Language Variables 
  255.  
  256.  File Name 
  257.  
  258.  Language Name 
  259.  
  260.  Language Eyecatcher 
  261.  
  262.  Language Extension 
  263.  
  264.  Language Compiler 
  265.  
  266.  Compile Options Dynamic Link Library 
  267.  
  268.  Language Linker 
  269.  
  270.  Link Options Dynamic Link Library 
  271.  
  272.  Language Maker 
  273.  
  274.  Maker Options Dynamic Link Library 
  275.  
  276.  Language Debugger 
  277.  
  278.  Debugger Options Dynamic Link Library 
  279.  
  280.  Default Make String 
  281.  
  282.  Default Debug String 
  283.  
  284.  Maximum Compiler Size 
  285.  
  286.  Maximum Compiler String 
  287.  
  288.  Maximum Linker Size 
  289.  
  290.  Maximum Linker String 
  291.  
  292.  Debugger Program Type 
  293.  
  294.  Used Eyecatchers 
  295.  
  296.  OK 
  297.  
  298.  Reset 
  299.  
  300.  Default 
  301.  
  302.  Clear 
  303.  
  304.  Cancel 
  305.  
  306.  
  307. ΓòÉΓòÉΓòÉ <hidden> File Name ΓòÉΓòÉΓòÉ
  308.  
  309. If you are creating a language profile, enter the file name you want to keep 
  310. the language profile  information in. Select a name that is meaningful and 
  311. unique among the other language profiles. For convenience, you can use the same 
  312. name for the language eyecatcher as the File name. 
  313.  
  314. Do not specify a path or extension (as in my_lang). The file is stored in the 
  315. WorkFrame/2* installation directory with the extension .PRF. 
  316.  
  317. If you are changing a language profile, the File name entry field shows you 
  318. which file will be updated. You cannot change the File name of the language 
  319. profile from the Change Language Profile window. 
  320.  
  321.  
  322. ΓòÉΓòÉΓòÉ <hidden> Language Name ΓòÉΓòÉΓòÉ
  323.  
  324. Enter a title for the language profile  (such as My Language V1.0). 
  325.  
  326. The Language name identifies the language in windows and messages. 
  327.  
  328.  
  329. ΓòÉΓòÉΓòÉ <hidden> Language Variables ΓòÉΓòÉΓòÉ
  330.  
  331. Select this pushbutton to specify paths used to search for include files and 
  332. libraries. 
  333.  
  334. The path you specify for the include files is searched before that specified in 
  335. the INCLUDE environment variable. The path you specify for the libraries is 
  336. searched before that specified in the LIB environment variable. 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ <hidden> Language Eyecatcher ΓòÉΓòÉΓòÉ
  340.  
  341. Enter a meaningful and unique identifier of up to eight characters (such as 
  342. MY_LANG). Identifiers of less than eight characters are padded with blanks to 
  343. make up the difference. Refer to the Used Eyecatchers list box to see which 
  344. eyecatchers have already been specified. 
  345.  
  346. When you create a project, you specify a language profile. The language 
  347. eyecatcher is stored with the project's control file to identify the language 
  348. profile to the WorkFrame/2* product. 
  349.  
  350. For example, suppose MY_LANG is the eyecatcher for the My Language profile and 
  351. its compiler is my_compl.exe. When you compile a project which uses the My 
  352. Language profile, the MY_LANG eyecatcher identifies which language profile 
  353. contains the name of the compiler (my_compl.exe) to be started by the 
  354. WorkFrame/2* product. 
  355.  
  356. Eyecatchers beginning with the letters IBM are reserved for the use of 
  357. International Business Machines Corporation. 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ <hidden> Language Extension ΓòÉΓòÉΓòÉ
  361.  
  362. Specify the file extension of source files for the language. 
  363.  
  364. If the compiler recognizes more than one extension, separate the extensions 
  365. with a blank. 
  366.  
  367. For example, if you are using the C Set/2* compiler, you might want both the 
  368. original C source code (with the extension .c) and output from the preprocessor 
  369. (with the extension .i) to be recognized as source code. Then you would specify 
  370. the following extensions: 
  371.  
  372. .c .i
  373. to identify source code. 
  374.  
  375.  
  376. ΓòÉΓòÉΓòÉ <hidden> Language Compiler ΓòÉΓòÉΓòÉ
  377.  
  378. Specify the path and name of the compiler for the language. 
  379.  
  380. If you do not specify a path (as in compile.exe), the WorkFrame/2* uses the 
  381. PATH environment variable to find the file. 
  382.  
  383.  
  384. ΓòÉΓòÉΓòÉ <hidden> Compile Options Dynamic Link Library ΓòÉΓòÉΓòÉ
  385.  
  386. Enter the name of the dynamic link library (DLL) (such as c_opts) used to 
  387. specify compiler options for the language. Do not specify a path or extension. 
  388.  
  389. This DLL lets you specify the options used when the language compiler is 
  390. started from the WorkFrame/2* window. 
  391.  
  392. Note:  The WorkFrame/2* product provides the dynamic link library dde3defl.dll 
  393.        as a generic interface for specifying options to a compiler. Enter 
  394.        dde3defl if you want to use it. 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ <hidden> Language Linker ΓòÉΓòÉΓòÉ
  398.  
  399. Specify the path and name of the linker for the language. 
  400.  
  401. If you do not specify a path (as in link386.exe), the WorkFrame/2* uses the 
  402. PATH environment variable to find the file. 
  403.  
  404.  
  405. ΓòÉΓòÉΓòÉ <hidden> Link Options Dynamic Link Library ΓòÉΓòÉΓòÉ
  406.  
  407. Enter the name of the dynamic link library (DLL) (such as l_opts) used to 
  408. specify linker options for the language. Do not specify a path or extension. 
  409.  
  410. This DLL lets you specify the options used when the language linker is started 
  411. from the WorkFrame/2* window. 
  412.  
  413. Note:  The WorkFrame/2* product provides the dynamic link library dde3defl.dll 
  414.        as a generic interface for specifying options to a linker. Enter 
  415.        dde3defl if you want to use it. 
  416.  
  417.  If you are using either the link.exe or link386.exe linkers provided with the 
  418.  OS/2* operating system, enter dde3link to use the link options DLL provided 
  419.  with the WorkFrame/2* product. 
  420.  
  421.  
  422. ΓòÉΓòÉΓòÉ <hidden> Language Maker ΓòÉΓòÉΓòÉ
  423.  
  424. Specify the path and name of the make utility for the language. 
  425.  
  426. If you do not specify a path (as in make.exe), the WorkFrame/2* uses the PATH 
  427. environment variable to find the file. 
  428.  
  429.  
  430. ΓòÉΓòÉΓòÉ <hidden> Maker Options Dynamic Link Library ΓòÉΓòÉΓòÉ
  431.  
  432. Enter the name of the dynamic link library (DLL) (such as m_opts) used to 
  433. specify make utility options for the language. Do not specify a path or 
  434. extension. 
  435.  
  436. This DLL lets you specify the options used when the language make utility is 
  437. started from the WorkFrame/2* window. 
  438.  
  439. Note:  The WorkFrame/2* product provides the dynamic link library dde3defl.dll 
  440.        as a generic interface for specifying options to a make utility. Enter 
  441.        dde3defl if you want to use it. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ <hidden> Language Debugger ΓòÉΓòÉΓòÉ
  445.  
  446. Specify the path and name of the debugger for the language. 
  447.  
  448. If you do not specify a path (as in debug.exe), the WorkFrame/2* uses the PATH 
  449. environment variable to find the file. 
  450.  
  451.  
  452. ΓòÉΓòÉΓòÉ <hidden> Debugger Options Dynamic Link Library ΓòÉΓòÉΓòÉ
  453.  
  454. Enter the name of the dynamic link library (DLL) (such as d_opts) used to 
  455. specify debugger options for the language. Do not specify a path or extension. 
  456.  
  457. This DLL lets you specify the options used when the language debugger is 
  458. started from the WorkFrame/2* window. 
  459.  
  460. Note:  The WorkFrame/2* product provides the dynamic link library dde3defl.dll 
  461.        as a generic interface for specifying options to a debugger. Enter 
  462.        dde3defl if you want to use it. 
  463.  
  464.  
  465. ΓòÉΓòÉΓòÉ <hidden> Default Make String ΓòÉΓòÉΓòÉ
  466.  
  467. Specify the string you want to use by default if the make options are not 
  468. specified for a project. 
  469.  
  470. For the make string, you can use the following symbols: 
  471.  
  472.  %o        Can be substituted for the current project's target file name. 
  473.  
  474.  %m        Can be substituted for the project's make file name. 
  475.  
  476.  Therefore, if: 
  477.  
  478.  o The project's make file name is make_it.mak 
  479.  
  480.  o The project's target file name is make_me.exe 
  481.  
  482.  o The make string is 
  483.  
  484.        /f %m /L%o
  485.  
  486.  then the string sent to the make utility would be 
  487.  
  488.    /f make_it.mak /Lmake_me.exe
  489.  
  490.  The %o and %m symbols are the only meaningful ones for the make utility that 
  491.  comes with the OS/2* operating system. If you also specify substitution 
  492.  variables, they will be replaced by their corresponding strings. 
  493.  
  494.  
  495. ΓòÉΓòÉΓòÉ <hidden> Default Debug String ΓòÉΓòÉΓòÉ
  496.  
  497. Specify the strings you want to use by default if the debug options are not 
  498. specified for a project. 
  499.  
  500. For the debug string, you can use the following symbols: 
  501.  
  502.  %o        Can be substituted for the current project's target file name. 
  503.  
  504.  %r        Can be substituted for the current project's run options string. 
  505.  
  506.  For example, assume: 
  507.  
  508.  o The project's target file name is eds_prog.exe 
  509.  
  510.  o Its run options are  prof.ipf /W 
  511.  
  512.  o The debug string is  %o %r /L 
  513.  
  514.  Then the string sent to the debugger would be 
  515.  
  516.    eds_prog.exe prof.ipf /W /L
  517.  
  518.  The %o and %r symbols are meaningful ones for most debuggers. If you also 
  519.  specify substitution variables, they will be replaced by their corresponding 
  520.  strings. 
  521.  
  522.  
  523. ΓòÉΓòÉΓòÉ <hidden> Maximum Compiler Size ΓòÉΓòÉΓòÉ
  524.  
  525. Specify how large a buffer (in bytes) is to be allocated to hold the compile 
  526. options saved with the project. 
  527.  
  528. Make the buffer large enough to hold the greatest amount of data that could be 
  529. required when the WorkFrame/2* product is exchanging information with the 
  530. compile options dynamic link library. 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ <hidden> Maximum Compiler String ΓòÉΓòÉΓòÉ
  534.  
  535. Specify how large a buffer (in bytes) is to be allocated to hold the string 
  536. sent to the compiler. 
  537.  
  538. Make the buffer large enough to hold the greatest amount of data that could be 
  539. required when the WorkFrame/2* product is exchanging information with the 
  540. compiler. 
  541.  
  542.  
  543. ΓòÉΓòÉΓòÉ <hidden> Maximum Linker Size ΓòÉΓòÉΓòÉ
  544.  
  545. Specify how large a buffer (in bytes) is to be allocated to hold the link 
  546. options saved with the project. 
  547.  
  548. Make the buffer large enough to hold the greatest amount of data that could be 
  549. required when the WorkFrame/2* product is exchanging information with the link 
  550. options dynamic link library. 
  551.  
  552.  
  553. ΓòÉΓòÉΓòÉ <hidden> Maximum Linker String ΓòÉΓòÉΓòÉ
  554.  
  555. Specify how large a buffer (in bytes) is to be allocated to hold the string 
  556. sent to the linker. 
  557.  
  558. Make the buffer large enough to hold the greatest amount of data that could be 
  559. required when the WorkFrame/2* product is exchanging information with the 
  560. linker. 
  561.  
  562.  
  563. ΓòÉΓòÉΓòÉ <hidden> Debugger Program Type ΓòÉΓòÉΓòÉ
  564.  
  565. Use these radio buttons to specify what type of program the debugger is: 
  566.  
  567.  Program determines 
  568.            Runs the program as specified in the header of its executable file. 
  569.  
  570.  Full screen 
  571.            Runs the program in an OS/2* full screen. 
  572.  
  573.  Text windowed 
  574.            Runs the program in an OS/2* window. 
  575.  
  576.  PM 
  577.            Runs the program as a Presentation Manager* program application. 
  578.  
  579.  Under ordinary circumstances, select Program determines. 
  580.  
  581.  By specifying another option, you can override the specification in the header 
  582.  of the executable file. You could, for example, start a windowed tool as a 
  583.  full screen tool. Do not start an application that is not a Presentation 
  584.  Manager* program as a Presentation Manager* program or vice versa. 
  585.  
  586.  
  587. ΓòÉΓòÉΓòÉ <hidden> Used Eyecatchers ΓòÉΓòÉΓòÉ
  588.  
  589. This list box displays the eyecatchers already being used. 
  590.  
  591. When you are specifying a new eyecatcher, look at this list box to ensure you 
  592. do not use the name of one that already exists. 
  593.  
  594.  
  595. ΓòÉΓòÉΓòÉ 5. Language Variables ΓòÉΓòÉΓòÉ
  596.  
  597. Use this window to specify paths used to search for include files and 
  598. libraries. 
  599.  
  600.  
  601. ΓòÉΓòÉΓòÉ <hidden> Controls ΓòÉΓòÉΓòÉ
  602.  
  603.  Include Search Path 
  604.  
  605.  Library Search Path 
  606.  
  607.  OK 
  608.  
  609.  Cancel 
  610.  
  611.  
  612. ΓòÉΓòÉΓòÉ <hidden> Include Search Path ΓòÉΓòÉΓòÉ
  613.  
  614. Specify any paths to be searched for include files. 
  615.  
  616. For example, 
  617.  
  618.    d:\c\include;e:\fortran\incl;
  619.  
  620. The path you specify for the include files is searched before that specified in 
  621. the INCLUDE environment variable. 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ <hidden> Library Search Path ΓòÉΓòÉΓòÉ
  625.  
  626. Specify any paths to be searched for libraries. 
  627.  
  628. For example, 
  629.  
  630.    d:\c\lib;e:\fortran\library;
  631.  
  632. The path you specify for the libraries is searched before that specified in the 
  633. LIB environment variable. 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  637.  
  638. Select OK to save the paths you specified and remove the window. 
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ <hidden> Confirm Deletion ΓòÉΓòÉΓòÉ
  642.  
  643. Select Yes if you want to delete the language profile. 
  644.  
  645. Select NO if you do not want to delete the language profile. 
  646.  
  647.  
  648. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  649.  
  650. Select OK to create the language profile  and remove the window. 
  651.  
  652.  
  653. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  654.  
  655. Select OK to change the language profile  and remove the window. 
  656.  
  657.  
  658. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  659.  
  660. Select Default to set the options to their default values. 
  661.  
  662.  
  663. ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ
  664.  
  665. Select Reset to set the options to the values they had when the window was 
  666. opened. 
  667.  
  668.  
  669. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  670.  
  671. Select Cancel to remove the window without making any changes. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ <hidden> Clear ΓòÉΓòÉΓòÉ
  675.  
  676. Select Clear to remove the contents of all the entry fields in the window. 
  677.  
  678.  
  679. ΓòÉΓòÉΓòÉ <hidden> Keys Help ΓòÉΓòÉΓòÉ
  680.  
  681. The list of keys is arranged in groups. 
  682.  
  683. Use: 
  684.  
  685.  o HELP KEYS to get help 
  686.  
  687.  o SYSTEM KEYS to switch between programs 
  688.  
  689.  o WINDOW KEYS to move around in a program window 
  690.  
  691.  o POP-UP WINDOW KEYS to make a selection in a pop-up window 
  692.  
  693.  o EDITING KEYS to make changes in a pop-up window. 
  694.  
  695.  When two key names are joined by a plus sign (+), use these two keys together. 
  696.  Hold down the first key and press the second key. 
  697.  
  698.  HELP KEYS 
  699.  
  700.  F1 
  701.            Get help 
  702.  F2 
  703.            Get extended help (from within any help window) 
  704.  F9 
  705.            Go to a list of keys (from within any help window) 
  706.  F11 or Shift+F1 
  707.            Go to the help index (from within any help window) 
  708.  Esc 
  709.            Cancel help 
  710.  Alt+F4 
  711.            Close the help window 
  712.  Alt+F6 
  713.            Move among windows 
  714.  Shift+F10 
  715.            Get help for help 
  716.  
  717.  SYSTEM KEYS 
  718.  
  719.  Alt+Esc 
  720.            Switch to the next program, including full-screen programs 
  721.  Alt+Tab 
  722.            Switch to the next windowed program 
  723.  Ctrl+Esc 
  724.            Switch to the Task List 
  725.  
  726.  WINDOW KEYS 
  727.  
  728.  F10 
  729.            Go to/from the action bar 
  730.  Arrow keys 
  731.            Move among choices 
  732.  End 
  733.            Go to the last choice in a pulldown 
  734.  Esc 
  735.            Cancel a pulldown, the system menu, or window 
  736.  Home 
  737.            Go to the first choice in a pulldown 
  738.  PgUp 
  739.            Scroll the contents of the window up one page 
  740.  PgDn 
  741.            Scroll the contents of the window down one page 
  742.  Underlined letter 
  743.            Move among the choices on the action bar and select pulldown items 
  744.  Alt 
  745.            Go to/from the action bar 
  746.  Alt+F4 
  747.            Close the window 
  748.  Alt+F5 
  749.            Restore the window 
  750.  Alt+F7 
  751.            Move the window 
  752.  Alt+F8 
  753.            Size the window 
  754.  Alt+F9 
  755.            Minimize the window 
  756.  Alt+F10 
  757.            Maximize the window 
  758.  Ctrl+PgDn 
  759.            Scroll the contents of the window right one page 
  760.  Ctrl+PgUp 
  761.            Scroll the contents of the window left one page 
  762.  Shift+Esc or Alt+Spacebar 
  763.            Go to/from the system menu 
  764.  Shift+Esc or Alt 
  765.            Go to/from the system menu of a text window 
  766.  
  767.  POP-UP WINDOW KEYS 
  768.  
  769.  Enter 
  770.            Complete the pop-up window 
  771.  Esc 
  772.            Cancel the pop-up window 
  773.  Spacebar 
  774.            Set a check box on/off or perform the task described on the selected 
  775.            pushbutton 
  776.  Tab 
  777.            Move to the next entry field or check box 
  778.  
  779.  EDITING KEYS 
  780.  
  781.  Backspace (left arrow delete) 
  782.            Delete the character to the left of the cursor 
  783.  Del 
  784.            Delete the character at the cursor 
  785.  End or Ctrl+Right Arrow key 
  786.            Move to the end of a field 
  787.  Home or Ctrl+Left Arrow key 
  788.            Move to the beginning of a field. 
  789.  
  790.  
  791. ΓòÉΓòÉΓòÉ <hidden> Language Profile - Definition ΓòÉΓòÉΓòÉ
  792.  
  793. Each project you develop must have an associated language profile. The language 
  794. profile defines a number of things, including: 
  795.  
  796.  o The executable files for the compiler, linker, debugger, and make utility to 
  797.    be used for the project. 
  798.  o The dynamic link libraries that let you specify options for the above 
  799.    programs. 
  800.  o The default invocation string (if applicable) for the make utility and 
  801.    debugger program. 
  802.  o Search paths for include files and libraries. 
  803.  
  804.  If a language product is designed to be used with the WorkFrame/2* product, it 
  805.  will likely come with a language profile. However, if you have a language 
  806.  product that is not designed for use with the WorkFrame/2* product, you can 
  807.  create one. The WorkFrame/2* product also provides a default language profile 
  808.  that you can modify for use with most compilers. 
  809.  
  810.  
  811. ΓòÉΓòÉΓòÉ <hidden> Substitution Variables - Definition ΓòÉΓòÉΓòÉ
  812.  
  813. Substitution variables are symbols you can specify in an invocation parameters. 
  814.  
  815. The WorkFrame/2* product supports the following substitution variables: 
  816.  
  817.  %a...%z   Will be replaced by all the file names selected in the corresponding 
  818.            listbox. The file names will be separated by the characters 
  819.            specified between the 'a' and the '%' of the %z substitution 
  820.            variable. 
  821.  
  822.            For example, if the selected files are cat.obj, dog.obj, and 
  823.            bird.obj, the substitution variable %a+-%z will result in the string 
  824.  
  825.                       cat.obj+-dog.obj+-bird.obj
  826.  
  827.            The only substitution variable allowed within the %a...%z 
  828.            substitution variables are %% and %d. 
  829.  
  830.  %d        Will be replaced with the directory of the current project. Use this 
  831.            substitution variable to qualify the name of file as in %d\%f or 
  832.            %d\%n.%e. 
  833.  
  834.  %e        Will be replaced by the extension (without the period) of the first 
  835.            selected file. 
  836.  
  837.  %f        Will be replaced with the first file selected in the corresponding 
  838.            listbox. 
  839.  
  840.            Specifying %f is the same as specifying %n.%e. 
  841.  
  842.  %m        Will be replaced by the make file name specified when the project 
  843.            was created. 
  844.  
  845.  %n        Will be replaced by the file name (without an extension) of the 
  846.            first selected file. 
  847.  
  848.  %o        Will be replaced by the target file name specified when the project 
  849.            was created. 
  850.  
  851.  %r        Will be replaced by the run options set for the current project. 
  852.  
  853.  %%        Will be replaced by a % symbol. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ <hidden> Installation Directory - Definition ΓòÉΓòÉΓòÉ
  857.  
  858. The installation directory is the directory where the WorkFrame/2* product is 
  859. installed. This directory was specified from the installation program and 
  860. contains: 
  861.  
  862.  o Project Control Files (which have the extension .PRJ). 
  863.  
  864.  o Preference Files (which have the extension .INI). 
  865.  
  866.  o Language Profiles (which have the extension .PRF). 
  867.  
  868.  o Backup Files (which have the extension .BAK). 
  869.  
  870.  
  871. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  872.  
  873. Do not specify a path in the <name_of_entry_field> entry field. 
  874.  
  875. This entry field requires a file name without a path. You have included a path 
  876. instead. 
  877.  
  878. Recovery 
  879.  
  880. Enter an file name without a path. 
  881.  
  882.  
  883. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  884.  
  885. The <name_of_entry_field> entry field cannot be left blank. 
  886.  
  887. Enter a value or string in the entry field identified in the message. 
  888.  
  889. Recovery 
  890.  
  891. Enter a valid name. 
  892.  
  893.  
  894. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  895.  
  896. Not enough memory to complete task. 
  897.  
  898. An error occurred while trying to allocate memory. There may be insufficient 
  899. memory to complete the task. 
  900.  
  901. Recovery 
  902.  
  903. Close one or more other tasks, and retry the command. 
  904.  
  905.  
  906. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  907.  
  908. This eyecatcher already exists. 
  909.  
  910. The eyecatcher you have entered in the Eyecatcher entry field already exists. 
  911.  
  912. Recovery 
  913.  
  914. Choose an eyecatcher name that is not listed in the Used Eyecatchers list box. 
  915.  
  916.  
  917. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  918.  
  919. The language profile <name_of_profile>: could not be deleted. return code = 
  920. return_code. 
  921.  
  922. An error occurred while attempting to delete the file. 
  923.  
  924. Recovery 
  925.  
  926. Make sure that the file is not already being used. Verify that the file is not 
  927. set for read only. See the OS/2* operating system return code description for 
  928. more information. 
  929.  
  930.  
  931. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  932.  
  933. Size must be between 16 and 63000. 
  934.  
  935. Enter a number between 16 and 63000. 
  936.  
  937. Recovery 
  938.  
  939. Correct the size, and retry the command. 
  940.  
  941.  
  942. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  943.  
  944. This profile file name already exists. 
  945.  
  946. The file name you have entered in the File name entry field already exists. 
  947.  
  948. Recovery 
  949.  
  950. Choose another file name. 
  951.  
  952.  
  953. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  954.  
  955. Unrecognized Substitution Variable. 
  956.  
  957. An unrecognized substitution variable was used. 
  958.  
  959. See the Default Make String help or the Default Make String help for more 
  960. information. 
  961.  
  962. Recovery 
  963.  
  964. Either remove the substitution variable, change it to a recognized one. 
  965.  
  966.  
  967. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  968.  
  969. Incorrect extension or character. 
  970.  
  971. Some extensions and characters cannot be used: 
  972.  
  973. o Extensions
  974.  
  975.   DEF  DEP  DLL  EXE  HLP  IPF
  976.   LIB  MAK  MSG  OBJ  RES  TXT
  977.   RC
  978.  
  979. o Characters
  980.  
  981.   <  > \  / *
  982.  
  983. Recovery 
  984.  
  985. Choose another extension or character. 
  986.  
  987.  
  988. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  989.  
  990. Language profile: <name_of_profile> cannot be accessed: return code = 
  991. return_code. 
  992.  
  993. The indicated language profile cannot be opened or read. 
  994.  
  995. Recovery 
  996.  
  997. Depending on the return code from the OS/2* operating system, you may have a 
  998. sharing conflict with another process. Switch to the other session and release 
  999. the file. 
  1000.  
  1001.  
  1002. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1003.  
  1004. The language profile <name_of_profile> is not valid. 
  1005.  
  1006. A file with an extension of .PRF has been found in the WorkFrame/2* 
  1007. installation directory. This file is not a valid language profile. 
  1008.  
  1009. Recovery 
  1010.  
  1011. If the file identified by profile name is not valid, switch to the WorkFrame/2* 
  1012. installationdirectory and delete it. 
  1013.  
  1014.  
  1015. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1016.  
  1017. There was an unexpected return code from a file call: return code = 
  1018. return_code. 
  1019.  
  1020. An unexpected error was returned from a file call. 
  1021.  
  1022. Recovery 
  1023.  
  1024. See the OS/2* operating system return code description for more information. 
  1025.  
  1026.  
  1027. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1028.  
  1029. Cannot display window: <name_of_window>. 
  1030.  
  1031. The program cannot display the indicated window. There may not be enough memory 
  1032. available. 
  1033.  
  1034. Recovery 
  1035.  
  1036. Stop any large processes that are running, and try the action again. 
  1037.  
  1038.  
  1039. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1040.  
  1041. Not enough memory to update list box. 
  1042.  
  1043. An error occurred while trying to update the list box. There may not be 
  1044. sufficient memory. 
  1045.  
  1046. Recovery 
  1047.  
  1048. Close one or more other tasks, and try again. 
  1049.  
  1050.  
  1051. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1052.  
  1053. The directory name <name_of_directory> is incorrect, return code = return_code. 
  1054.  
  1055. One or more of the paths contains a string that is not a directory. 
  1056.  
  1057. Recovery 
  1058.  
  1059. Correct the directory name and try the command again. 
  1060.  
  1061.  
  1062. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1063.  
  1064. The file name <name_of_file> was entered rather than a directory. 
  1065.  
  1066. One or more of the paths contains a string that is a file name rather than a 
  1067. directory. 
  1068.  
  1069. Recovery 
  1070.  
  1071. Correct the path string and try the command again. 
  1072.  
  1073.  
  1074. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1075.  
  1076. The directory name <name_of_directory> is longer than the maximum length 
  1077. <maximum_length> permitted by the operating system. 
  1078.  
  1079. One or more of the paths contains a directory name that is longer than that 
  1080. allowed by the operating system. 
  1081.  
  1082. Recovery 
  1083.  
  1084. Enter a shorter directory name and try the command again. 
  1085.  
  1086.  
  1087. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1088.  
  1089. There was an unexpected return code while validating the path: 
  1090. <path_being_validated>, return code = return_code 
  1091.  
  1092. An unexpected error occured while a path was being selected. 
  1093.  
  1094. Recovery 
  1095.  
  1096. See the OS/2* operating system return code description for more information. 
  1097.  
  1098.  
  1099. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  1100.  
  1101. The directory <name_of_directory> does not exist, return code = return_code Do 
  1102. you want to ignore it? 
  1103.  
  1104. The program could not find the directory. 
  1105.  
  1106. Recovery 
  1107.  
  1108. Select No if you want to respecify the directory. Otherwise, select Yes to 
  1109. continue. 
  1110.  
  1111. See the OS/2* operating system return code description for more information.