home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional Developers Kit 1992 November / Disc01 / Disc01.mdf / runnable / ibmwf / help / dde3defl.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1992-08-27  |  16.6 KB  |  610 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. Compile Options ΓòÉΓòÉΓòÉ
  40.  
  41. Use this window to specify the parameters to be passed to the compiler. 
  42.  
  43. In this window you can: 
  44.  
  45. o Specify the options you want to pass to the compiler. 
  46.  
  47. o Save the options to the project. 
  48.  
  49. o Specify whether or not you want to change the options when the compiler is 
  50.   started. 
  51.  
  52. If you want to create your own Options dynamic link library, you can use the 
  53. DEFL_DLL sample project supplied with the WorkFrame/2 as a template. 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 2.1. Enter Compile Options ΓòÉΓòÉΓòÉ
  57.  
  58. Enter the options you want to pass to the compiler. 
  59.  
  60. For the compile string, you can use the symbol %f to represent the name of the 
  61. file containing the source code. 
  62.  
  63. Therefore, if the file name is make_it.c and the compile string is 
  64.  
  65.   /Fa %f /S2
  66.  
  67. the string sent to the compiler would be 
  68.  
  69.   /Fa make_it.c /S2
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 2.2. Error Message Template ΓòÉΓòÉΓòÉ
  73.  
  74. Specify the format of the error messages generated by the compiler. 
  75.  
  76. The template is used to parse the error message into: 
  77.  
  78. o The file name (represented by %f). 
  79.  
  80. o The line at which the error occurred (represented by %i). 
  81.  
  82. o The column at which the error occurred (represented by %c). 
  83.  
  84. o The text of the error message. (represented by %t). 
  85.  
  86. This information is used by the WorkFrame/2 product if an the editor is started 
  87. from a message line in a Monitor window. 
  88.  
  89. Specify each symbol once in the template and separate them with one or more 
  90. characters. 
  91.  
  92. For example, if the error message is in the form 
  93.  
  94.   <make_it.c : 238, 12> Text of the error message.
  95.  
  96. the error message template should be specified as 
  97.  
  98.   <%f : %i, %c> %t
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 3. Link Options ΓòÉΓòÉΓòÉ
  102.  
  103. Use this window to specify the parameters to be passed to the linker. 
  104.  
  105. In this window you can: 
  106.  
  107. o Specify the options you want to pass to the linker. 
  108.  
  109. o Save the options to the project. 
  110.  
  111. If you want to create your own Options dynamic link library, you can use the 
  112. DEFL_DLL sample project supplied with the WorkFrame/2 as a template. 
  113.  
  114.  
  115. ΓòÉΓòÉΓòÉ 3.1. Enter Link Options ΓòÉΓòÉΓòÉ
  116.  
  117. Enter the options you want to pass to the linker. 
  118.  
  119. In addition to the link options, specify what characters are to be used to 
  120. separate the object module file names passed to the linker. Place the 
  121. characters between the %a and %z substitution variables. The default character 
  122. is a plus sign ('+'). 
  123.  
  124. You can also use the substitution variable %o for the target file name. 
  125.  
  126. For example, if the link options are specified as 
  127.  
  128.   /STACK:16384 /NOF %a/../%z
  129.  
  130. and the object modules x.obj yy.obj and zzz.obj were being linked, then the 
  131. string passed to the linker would be: 
  132.  
  133.   /STACK:16384 /NOF x.obj/../yy.obj/../zzz.obj
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 4. Make Options ΓòÉΓòÉΓòÉ
  137.  
  138. Use this window to specify the parameters to be passed to the make utility. 
  139.  
  140. In this window you can: 
  141.  
  142. o Specify the options you want to pass to the make utility. 
  143.  
  144. o Save the options to the project. 
  145.  
  146. o Specify whether or not you want to change the options when the make utility 
  147.   is started. 
  148.  
  149. If you want to create your own Options dynamic link library, you can use the 
  150. DEFL_DLL sample project supplied with the WorkFrame/2 as a template. 
  151.  
  152.  
  153. ΓòÉΓòÉΓòÉ 4.1. Enter Make Options ΓòÉΓòÉΓòÉ
  154.  
  155. Enter the options you want to pass to the make utility. 
  156.  
  157. For the make string, you can use the following symbols: 
  158.  
  159. %o        Can be substituted for the current project's target file name. 
  160.  
  161. %m        Can be substituted for the project's make file name. 
  162.  
  163. Therefore, if: 
  164.  
  165. o The project's make file name is make_it.mak 
  166.  
  167. o The project's target file name is make_me.exe 
  168.  
  169. o The make string is 
  170.  
  171.      /f %m /L%o
  172.  
  173. then the string sent to the make utility would be 
  174.  
  175.  /f make_it.mak /Lmake_me.exe
  176.  
  177. The %o and %m symbols are the only meaningful ones for the make utility that 
  178. comes with the OS/2* operating system. If you also specify substitution 
  179. variables, they will be replaced by their corresponding strings. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 5. Debug Options ΓòÉΓòÉΓòÉ
  183.  
  184. Use this window to specify the parameters to be passed to the language 
  185. debugger. 
  186.  
  187. In this window you can: 
  188.  
  189. o Specify the options you want to pass to the language debugger. 
  190.  
  191. o Save the options to the project. 
  192.  
  193. o Specify whether or not you want to change the options when the language 
  194.   debugger is started. 
  195.  
  196. If you want to create your own Options dynamic link library, you can use the 
  197. DEFL_DLL sample project supplied with the WorkFrame/2 as a template. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 5.1. Enter Debug Options ΓòÉΓòÉΓòÉ
  201.  
  202. Enter the options you want to pass to the language debugger. 
  203.  
  204. For the debug string, you can use the following symbols: 
  205.  
  206. %o        Can be substituted for the current project's target file name. 
  207.  
  208. %r        Can be substituted for the current project's run options string. 
  209.  
  210. For example, assume: 
  211.  
  212. o The project's target file name is eds_prog.exe 
  213.  
  214. o Its run options are  prof.ipf /W 
  215.  
  216. o The debug string is  %o %r /L 
  217.  
  218. Then the string sent to the debugger would be 
  219.  
  220.  eds_prog.exe prof.ipf /W /L
  221.  
  222. The %o and %r symbols are meaningful ones for most debuggers. If you also 
  223. specify substitution variables, they will be replaced by their corresponding 
  224. strings. 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 6. Prompt ΓòÉΓòÉΓòÉ
  228.  
  229. Select Prompt to be prompted when the action is started. You can then specify 
  230. additional options or change those specified in the Enter action options entry 
  231. field. 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 7. Save With Project ΓòÉΓòÉΓòÉ
  235.  
  236. Select Save with project to save the options with the other information of the 
  237. project you are currently working on. Otherwise, the changes only remain in 
  238. effect until the WorkFrame/2 session is closed. 
  239.  
  240.  
  241. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  242.  
  243. Select OK to save the changes you made and close the window. 
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ
  247.  
  248. Select Reset to set the options to the values they had when the window was 
  249. opened. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  253.  
  254. Select Default to set the options to their default values. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  258.  
  259. Select Cancel to remove the window without making any changes. 
  260.  
  261.  
  262. ΓòÉΓòÉΓòÉ <hidden> Keys Help ΓòÉΓòÉΓòÉ
  263.  
  264. The list of keys is arranged in groups. 
  265.  
  266. Use: 
  267.  
  268. o HELP KEYS to get help 
  269.  
  270. o SYSTEM KEYS to switch between programs 
  271.  
  272. o WINDOW KEYS to move around in a program window 
  273.  
  274. o POP-UP WINDOW KEYS to make a selection in a pop-up window 
  275.  
  276. o EDITING KEYS to make changes in a pop-up window. 
  277.  
  278. When two key names are joined by a plus sign (+), use these two keys together. 
  279. Hold down the first key and press the second key. 
  280.  
  281. HELP KEYS 
  282.  
  283. F1 
  284.           Get help 
  285. F2 
  286.           Get extended help (from within any help window) 
  287. F9 
  288.           Go to a list of keys (from within any help window) 
  289. F11 or Shift+F1 
  290.           Go to the help index (from within any help window) 
  291. Esc 
  292.           Cancel help 
  293. Alt+F4 
  294.           Close the help window 
  295. Alt+F6 
  296.           Move among windows 
  297. Shift+F10 
  298.           Get help for help 
  299.  
  300. SYSTEM KEYS 
  301.  
  302. Alt+Esc 
  303.           Switch to the next program, including full-screen programs 
  304. Alt+Tab 
  305.           Switch to the next windowed program 
  306. Ctrl+Esc 
  307.           Switch to the Task List 
  308.  
  309. WINDOW KEYS 
  310.  
  311. F10 
  312.           Go to/from the action bar 
  313. Arrow keys 
  314.           Move among choices 
  315. End 
  316.           Go to the last choice in a pulldown 
  317. Esc 
  318.           Cancel a pulldown, the system menu, or window 
  319. Home 
  320.           Go to the first choice in a pulldown 
  321. PgUp 
  322.           Scroll the contents of the window up one page 
  323. PgDn 
  324.           Scroll the contents of the window down one page 
  325. Underlined letter 
  326.           Move among the choices on the action bar and select pulldown items 
  327. Alt 
  328.           Go to/from the action bar 
  329. Alt+F4 
  330.           Close the window 
  331. Alt+F5 
  332.           Restore the window 
  333. Alt+F7 
  334.           Move the window 
  335. Alt+F8 
  336.           Size the window 
  337. Alt+F9 
  338.           Minimize the window 
  339. Alt+F10 
  340.           Maximize the window 
  341. Ctrl+PgDn 
  342.           Scroll the contents of the window right one page 
  343. Ctrl+PgUp 
  344.           Scroll the contents of the window left one page 
  345. Shift+Esc or Alt+Spacebar 
  346.           Go to/from the system menu 
  347. Shift+Esc or Alt 
  348.           Go to/from the system menu of a text window 
  349.  
  350. POP-UP WINDOW KEYS 
  351.  
  352. Enter 
  353.           Complete the pop-up window 
  354. Esc 
  355.           Cancel the pop-up window 
  356. Spacebar 
  357.           Set a check box on/off or perform the task described on the selected 
  358.           pushbutton 
  359. Tab 
  360.           Move to the next entry field or check box 
  361.  
  362. EDITING KEYS 
  363.  
  364. Backspace (left arrow delete) 
  365.           Delete the character to the left of the cursor 
  366. Del 
  367.           Delete the character at the cursor 
  368. End or Ctrl+Right Arrow key 
  369.           Move to the end of a field 
  370. Home or Ctrl+Left Arrow key 
  371.           Move to the beginning of a field. 
  372.  
  373.  
  374. ΓòÉΓòÉΓòÉ <hidden> Substitution Variables - Definition ΓòÉΓòÉΓòÉ
  375.  
  376. Substitution variables are symbols you can specify as invocation parameters. 
  377.  
  378. The WorkFrame/2 product supports the following substitution variables: 
  379.  
  380. %a...%z   Will be replaced by all the file names selected in the corresponding 
  381.           listbox. The file names will be separated by the characters specified 
  382.           between the 'a' and the '%' of the %z substitution variable. 
  383.  
  384.           For example, if the selected files are cat.obj, dog.obj, and 
  385.           bird.obj, the substitution variable %a+-%z will result in the string 
  386.  
  387.                     cat.obj+-dog.obj+-bird.obj
  388.  
  389.           The only substitution variable allowed within the %a...%z 
  390.           substitution variables are %% and %d. 
  391.  
  392. %d        Will be replaced with the directory of the current project. Use this 
  393.           substitution variable to qualify the name of file as in %d\%f or 
  394.           %d\%n.%e. 
  395.  
  396. %e        Will be replaced by the extension (without the period) of the first 
  397.           selected file. 
  398.  
  399. %f        Will be replaced with the first file selected in the corresponding 
  400.           listbox. 
  401.  
  402.           Specifying %f is the same as specifying %n.%e. 
  403.  
  404. %m        Will be replaced by the make file name specified when the project was 
  405.           created. 
  406.  
  407. %n        Will be replaced by the file name (without an extension) of the first 
  408.           selected file. 
  409.  
  410. %o        Will be replaced by the target file name specified when the project 
  411.           was created. 
  412.  
  413. %r        Will be replaced by the run options set for the current project. 
  414.  
  415. %%        Will be replaced by a % symbol. 
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  419.  
  420. The default options string exceeds the maximum options size. 
  421.  
  422. The program cannot store the default options. 
  423.  
  424. Recovery 
  425.  
  426. The maximum options size is 400 characters. Ensure the options do not exceed 
  427. this limit. 
  428.  
  429.  
  430. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  431.  
  432. Options string is too long. 
  433.  
  434. There is not enough storage allocated to store the options string. 
  435.  
  436. Recovery 
  437.  
  438. The maximum options string is 400 characters. Ensure the options string does 
  439. not exceed this limit. 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  443.  
  444. Unrecognized Substitution Variable. 
  445.  
  446. An unrecognized substitution variable was used. 
  447.  
  448. Recovery 
  449.  
  450. Either remove the substitution variable, change it to a recognized one. 
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  454.  
  455. Not enough space in the link options string to store the specified options. 
  456.  
  457. There is not enough storage allocated to store the default link options string. 
  458.  
  459. Recovery 
  460.  
  461. Use the Language Profile Management window to change the Maximum link string in 
  462. the language profile so that more storage is allocated. 
  463.  
  464.  
  465. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  466.  
  467. Not enough space to store the default link options. 
  468.  
  469. There is not enough storage allocated to store the default link options. 
  470.  
  471. Recovery 
  472.  
  473. Use the Language Profile Management window to change the Maximum link size in 
  474. the language profile so that more storage is allocated. 
  475.  
  476.  
  477. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  478.  
  479. Either the %a...%z or %o declaration is incorrect. 
  480.  
  481. In addition to the link options, specify what characters are to be used to 
  482. separate the object module file names passed to the linker. Place the 
  483. characters between the %a and %z substitution variables. The default character 
  484. is a plus sign ('+'). 
  485.  
  486. You can also use the substitution variable %o for the target file name. 
  487.  
  488. For example, if the link options are specified as 
  489.  
  490.   /STACK:16384 /NOF %a/../%z
  491.  
  492. and the object modules x.obj yy.obj and zzz.obj were being linked, then the 
  493. string passed to the linker would be: 
  494.  
  495.   /STACK:16384 /NOF x.obj/../yy.obj/../zzz.obj
  496.  
  497.  
  498. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  499.  
  500. The link options must contain one instance of %a...%z string. 
  501.  
  502. In addition to the link options, specify what characters are to be used to 
  503. separate the object module file names passed to the linker. Place the 
  504. characters between the %a and %z substitution variables. The default character 
  505. is a plus sign ('+'). 
  506.  
  507. You can also use the substitution variable %o for the target file name. 
  508.  
  509. For example, if the link options are specified as 
  510.  
  511.   /STACK:16384 /NOF %a/../%z
  512.  
  513. and the object modules x.obj yy.obj and zzz.obj were being linked, then the 
  514. string passed to the linker would be: 
  515.  
  516.   /STACK:16384 /NOF x.obj/../yy.obj/../zzz.obj
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  520.  
  521. Not enough space to store the default compile options. 
  522.  
  523. There is not enough storage allocated to store the default compile options. 
  524.  
  525. Recovery 
  526.  
  527. Use the Language Profile Management window to change the Maximum compile size 
  528. in the language profile so that more storage is allocated. 
  529.  
  530.  
  531. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  532.  
  533. Not enough space in the compile string to store the specified options. 
  534.  
  535. There is not enough storage allocated to store the default compile options. 
  536.  
  537. Recovery 
  538.  
  539. Use the Language Profile Management window to change the Maximum compile size 
  540. in the language profile so that more storage is allocated. 
  541.  
  542.  
  543. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  544.  
  545. Not enough space in the compile options string to store the specified options. 
  546.  
  547. There is not enough storage allocated to store the default compile options 
  548. string. 
  549.  
  550. Recovery 
  551.  
  552. Use the Language Profile Management window to change the Maximum compile string 
  553. in the language profile so that more storage is allocated. 
  554.  
  555.  
  556. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  557.  
  558. Only one instance each of the symbol %f is allowed. 
  559.  
  560. For the compile string, you can use the symbol %f to represent the name of the 
  561. file containing the source code. 
  562.  
  563. Therefore, if the file name is make_it.c and the compile string is 
  564.  
  565.   /Fa %f /S2
  566.  
  567. the string sent to the compiler would be 
  568.  
  569.   /Fa make_it.c /S2
  570.  
  571.  
  572. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  573.  
  574. Only one instance each of the symbols %f, %i, and %t is allowed. 
  575.  
  576. Specify each symbol once in the template and separate them with one or more 
  577. characters. 
  578.  
  579. For example, if the error message is in the form 
  580.  
  581.   <make_it.c : 238, 12> Text of the error message.
  582.  
  583. the error message template should be specified as 
  584.  
  585.   <%f : %i, %c> %t
  586.  
  587.  
  588. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  589.  
  590. Inconsistent options 
  591.  
  592. The options structure or data is incorrect. 
  593.  
  594. If you want to use the default options, select Yes. Otherwise, select No. 
  595.  
  596. Recovery 
  597.  
  598. Either remove one or both of the inconsistent options. 
  599.  
  600.  
  601. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  602.  
  603. Not enough memory to complete task. 
  604.  
  605. An error occurred while trying to allocate memory. There may be insufficient 
  606. memory to complete the task. 
  607.  
  608. Recovery 
  609.  
  610. Close one or more other tasks, and retry the command.