home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / docs / cmcmdref.inf (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1993-08-15  |  180.7 KB  |  6,834 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Setup Commands ΓòÉΓòÉΓòÉ
  3.  
  4. This chapter describes the Communications Manager setup commands. Each command 
  5. description includes the purpose of the command, a syntax diagram, a list of 
  6. parameters, a discussion of the options, remarks, and examples. 
  7.  
  8. CMSETUP can be invoked from the OS/2 command line or the Communications 
  9. Manager/2 folder on the desktop. 
  10.  
  11. For more information on installation, refer to Workstation Installation and 
  12. Configuration Guide and IBM Communications Manager/2 Version 1.0 Network 
  13. Administration and Subsystem Management Guide. 
  14.  
  15. To view the list of setup commands, press Ctrl+C to return to the Contents. 
  16. Next, select the plus sign (+) or press the + key. 
  17.  
  18.  
  19. ΓòÉΓòÉΓòÉ 1.1. CMREPL ΓòÉΓòÉΓòÉ
  20.  
  21. CMREPL 
  22.  
  23.  Purpose 
  24.  
  25.           Allows you to replace the name of the default startup configuration 
  26.           with the name of a different configuration. 
  27.  
  28.  Syntax 
  29.  
  30.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMREPLΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  31.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      ΓööΓöÇconfigurationΓöÇΓöÿ
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  35.  
  36. Specifies the drive for the command you want to process. 
  37.  
  38.  
  39. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  40.  
  41. Specifies the exact location of the command you want to process. 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ <hidden> configuration ΓòÉΓòÉΓòÉ
  45.  
  46. The name of the configuration that will become the new default startup 
  47. configuration for Communications Manager. Do not include the file extension. 
  48. Any file extension is ignored and assumed to be .CFG. 
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  52.  
  53. CMREPL can be executed from the Communications Manager/2 folder or from the 
  54. command line. 
  55.  
  56. To execute CMREPL from the Communications Manager/2 folder, select Replace 
  57. Default Configuration. 
  58.  
  59. When you execute CMREPL from the command line, you can issue the command with 
  60. or without the configuration parameter. 
  61.  
  62. Executing CMREPL without the configuration parameter has the same result as 
  63. selecting Replace Default Configuration from the Communications Manager/2 
  64. folder (a Presentation Manager window appears). 
  65.  
  66. CMREPL can be executed from any directory; however, the new default 
  67. configuration must be in the \CMLIB directory prior to executing CMREPL. 
  68.  
  69. Use the following sequence of commands to stop Communications Manager, change 
  70. the default configuration, and start Communications Manager using the new 
  71. default configuration: 
  72.  
  73.            1. CMSTOP 
  74.            2. CMREPL configuration 
  75.            3. CM 
  76.  
  77.           Only a verified IBM Communications Manager. file may be specified as 
  78.           the new default configuration when using CMREPL. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  82.  
  83. The following are examples of CMREPL usage: 
  84.  
  85.           o To execute CMREPL with a command line parameter, type: 
  86.  
  87.                              CMREPL MYNEW.CFG
  88.  
  89.           o To execute CMREPL without a command line parameter, type: 
  90.  
  91.                              CMREPL
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 1.2. CMLAN ΓòÉΓòÉΓòÉ
  95.  
  96. CMLAN 
  97.  
  98.  Purpose 
  99.  
  100.           Allows you to install a redirected workstation. The configuration 
  101.           file is upgraded if it is from a previous version of Communications 
  102.           Manager. 
  103.  
  104.  Syntax 
  105.  
  106.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMLANΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  107.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  108.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  109.                       Γö£ΓöÇ/IΓöÇΓöÇ configurationΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  110.                       Γö£ΓöÇ/DΓöÇΓöÇ [drive]ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  111.                       Γöé        ΓööΓöÇ/QΓöÇΓöÇΓöÇΓöÿ           Γöé
  112.                       Γö£ΓöÇ/KΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  113.                       Γö£ΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  114.                       ΓööΓöÇ/RΓöÇΓöÇ response_fileΓöÇΓöÇΓö¼ΓöÇ/GΓöÇΓöÇ general_pathΓöÇΓö¼ΓöÇΓöÿ
  115.                                  Γö£ΓöÇ/L1ΓöÇ log_file1ΓöÇΓöÇΓöÇΓöÇΓöñ
  116.                                  Γö£ΓöÇ/L2ΓöÇ log_file2ΓöÇΓöÇΓöÇΓöÇΓöñ
  117.                                  ΓööΓöÇ/QΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  118.  
  119.  
  120. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  121.  
  122. Specifies the drive for the command you want to process. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  126.  
  127. Specifies the exact location of the command you want to process. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ <hidden> /I configuration ΓòÉΓòÉΓòÉ
  131.  
  132. Allows you to install or update IBM Communications Manager/2 Version 1.1 based 
  133. on the specified configuration file. CONFIGURATION is a mandatory subparameter 
  134. and is a fully qualified configuration file name that must have an extension of 
  135. .CFG. 
  136.  
  137. You must enter either a colon or a space after the parameter. You do not need 
  138. to enter the file extension on the command line. The configuration file option 
  139. is mutually exclusive of the other options.  When you specify this option, the 
  140. setup processor installs according to the specified configuration file without 
  141. requiring that you enter configuration services. You are returned to the 
  142. command line after you exit the installation program.  The specified 
  143. configuration file is then copied to the \CMLIB subdirectory and upgraded if 
  144. necessary. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ <hidden> /D drive ΓòÉΓòÉΓòÉ
  148.  
  149. Allows you to remove an installed Communications Manager on your machine. This 
  150. option removes the Communications Manager executable code, the Communications 
  151. Manager/2 folder, and the CONFIG.SYS updates. The Communications Manager 
  152. configuration files and audit trail file are not removed. 
  153.  
  154. You do not have to type the blank or specify the disk drive. The default disk 
  155. drive is the current drive. 
  156.  
  157. This request is rejected if Communications Manager is running.  This request is 
  158. also rejected if the drive specified does not contain Communications Manager or 
  159. if the drive is not specified and Communications Manager is not installed on 
  160. any drive. 
  161.  
  162. Note:  /d is optional, if /d is used with /q then it is required. 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  166.  
  167. Indicates that Communications Manager should be deleted from the specified 
  168. drive on your machine. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ <hidden> /Q ΓòÉΓòÉΓòÉ
  172.  
  173. When specified with the /d parameter, indicates that the deletion of files is 
  174. done in "quiet" mode (without windows). 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ <hidden> /K ΓòÉΓòÉΓòÉ
  178.  
  179. Allows you to request that features not needed by the default configuration 
  180. file be removed.  The default configuration file and contents of the target 
  181. drive are compared, and any unneeded features are removed. 
  182.  
  183. This parameter is not supported if CMLAN was invoked from install 
  184. diskettes/images.  This request is rejected if Communications Manager is 
  185. running with a configuration other than the default configuration. 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  189.  
  190. Allows you to display the command line syntax on your screen. The command line 
  191. syntax is displayed when any unrecognized parameters are entered. 
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ <hidden> /R response_file ΓòÉΓòÉΓòÉ
  195.  
  196. This parameter applies only when you are performing a response_file 
  197. installation or configuration of Communications Manager. Allows you to request 
  198. the following installation actions based on the specified response file: 
  199.  
  200.           o Install IBM Communications Manager. on a drive with no 
  201.             Communications Manager 
  202.  
  203.           o Upgrade a previous Communications Manager release to IBM 
  204.             Communications Manager/2 Version 1.1 (including installation and 
  205.             configuration) 
  206.  
  207.           o Configuration change with installation of additional features if 
  208.             necessary 
  209.  
  210.           o Configuration change without installation 
  211.  
  212.           o Re-install Communications Manager 
  213.  
  214.           o Remove communication features (based on the default configuration) 
  215.  
  216.           Response_file is a mandatory sub-parameter and is a fully qualified 
  217.           response file name that must have an extension of .RSP. This 
  218.           extension need not be entered on the command line. You must use a 
  219.           blank or colon after the /R parameter. The response file parameter is 
  220.           mutually exclusive of the previous parameters. 
  221.  
  222.           Response files are processed when Communications Manager is installed 
  223.           and configured using the /R parameter. For more information on 
  224.           response files and remote installation, refer to the online IBM 
  225.           Communications Manager/2 Version 1.1 Response File Reference. 
  226.  
  227.  
  228. ΓòÉΓòÉΓòÉ <hidden> /G ΓòÉΓòÉΓòÉ
  229.  
  230. This parameter applies only when you are performing a response_file 
  231. installation or configuration of Communications Manager. Specifies the path to 
  232. a directory on the server that can contain a general response file or other 
  233. data files.  You may not specify a diskette drive. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ <hidden> /L1 ΓòÉΓòÉΓòÉ
  237.  
  238. This parameter applies only when you are performing a response_file 
  239. installation or configuration of Communications Manager. Specifies the fully 
  240. qualified name of the file into which the log file for remote installation and 
  241. configuration is to be copied. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ <hidden> /L2 ΓòÉΓòÉΓòÉ
  245.  
  246. This parameter applies only when you are performing a response_file 
  247. installation or configuration of Communications Manager. Specifies the fully 
  248. qualified name of the file into which the installation log file is to be 
  249. copied. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ <hidden> /Q ΓòÉΓòÉΓòÉ
  253.  
  254. This parameter applies only when you are performing a response_file 
  255. installation or configuration of Communications Manager. When specified with 
  256. the /R parameter, indicates that response file processing is done in "quiet" 
  257. mode (without windows). 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  261.  
  262. Command line parameters for this command are not case sensitive.  You must use 
  263. a colon or a space after any of the key parameter letters. 
  264.  
  265. If Communications Manager is not already installed, Communications Manager 
  266. determines the location of the product code required for installation by 
  267. examining the CMLAN invocation. 
  268.  
  269. For example, if the product code is on diskette images on LAN drive X, you 
  270. would type X:\CMLAN at the command prompt. 
  271.  
  272. After you are prompted to specify the target drive (the drive that will receive 
  273. the product files), you can complete all the configuration and feature 
  274. selections. 
  275.  
  276. If Communications Manager is already installed, you are asked for the location 
  277. of the Communications Manager product files required for installation. The 
  278. location of the target drive is assumed to be the same as the current 
  279. installation. 
  280.  
  281. The Interactive Configuration Interface is an additional function which is 
  282. installed by default.  If you do not want to install this additional function, 
  283. select Options from the menu bar on the CMLAN window and select Remove 
  284. Additional Functions. You can select the functions you want to remove. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  288.  
  289. The following are some examples of CMLAN usage: 
  290.  
  291.           o To install MY.CFG located on D:\CMLIB, type the following and press 
  292.             Enter: 
  293.  
  294.                              CMLAN /I D:\CMLIB\MY.CFG
  295.  
  296.           o To enter configuration services and open MY.CFG in D:\CMLIB, type 
  297.             the following and press Enter: 
  298.  
  299.                              CMLAN /C D:\CMLIB\MY.CFG
  300.  
  301.           o To remove all features not associated with the default 
  302.             configuration, type the following and press Enter: 
  303.  
  304.                              CMLAN /K
  305.  
  306.           o To remove Communications Manager from the D drive, type the 
  307.             following and press Enter: 
  308.  
  309.                              CMLAN /D D:
  310.  
  311.           Use the following statement to do all of the following: 
  312.  
  313.           o Process a response file named JOE.RSP on the Z drive in the 
  314.             directory CMUSERS. 
  315.  
  316.           o Use Z:\GENERAL as the general path for additional files. 
  317.  
  318.           o Keep a record of the processing in Z:\CMOUTPUT\JOE.LOG. 
  319.  
  320.                          CMLAN /R Z:\CMUSERS\JOE.RSP /G Z:\GENERAL
  321.                               /L1 z:\CMOUTPUT\JOE.LOG
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 1.3. CMSETUP ΓòÉΓòÉΓòÉ
  325.  
  326. CMSETUP 
  327.  
  328.  Purpose 
  329.  
  330.           Allows you to configure and install Communications Manager. The 
  331.           configuration file is upgraded if it is from a previous version of 
  332.           Communications Manager. 
  333.  
  334.  Syntax 
  335.  
  336.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMSETUPΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  337.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  338.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  339.                       Γö£ΓöÇ/CΓöÇΓöÇ configurationΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  340.                       Γö£ΓöÇ/IΓöÇΓöÇ configurationΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  341.                       Γö£ΓöÇ/DΓöÇΓöÇ [drive]ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  342.                       Γöé        ΓööΓöÇ/QΓöÇΓöÇΓöÇΓöÿ            Γöé
  343.                       Γö£ΓöÇ/KΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  344.                       Γö£ΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  345.                       ΓööΓöÇ/RΓöÇΓöÇ response_fileΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  346.                                  Γö£ΓöÇ/SΓöÇΓöÇ source_pathΓöÇΓöÇΓöÇΓöÇΓöñ
  347.                                  Γö£ΓöÇ/GΓöÇΓöÇ general_pathΓöÇΓöÇΓöÇΓöñ
  348.                                  Γö£ΓöÇ/L1ΓöÇ log_file1ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  349.                                  Γö£ΓöÇ/L2ΓöÇ log_file2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  350.                                  Γö£ΓöÇ/CRΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  351.                                  Γö£ΓöÇ/MGΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöñ
  352.                                  Γöé    ΓööΓöÇmigr_fileΓöÇΓöÿ  Γöé
  353.                                  Γö£ΓöÇ/KLΓöÇ passwordΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  354.                                  ΓööΓöÇ/QΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  355.  
  356.  
  357. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  358.  
  359. Specifies the drive for the command you want to process. 
  360.  
  361.  
  362. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  363.  
  364. Specifies the exact location of the command you want to process. 
  365.  
  366.  
  367. ΓòÉΓòÉΓòÉ <hidden> /C configuration ΓòÉΓòÉΓòÉ
  368.  
  369. Allows you to create or change a configuration file. CONFIGURATION is a 
  370. mandatory subparameter that indicates the fully qualified name of a 
  371. configuration file that must have an extension of .CFG. 
  372.  
  373. You must enter either a colon or a space after the parameter. You do not need 
  374. to enter the file extension on the command line. The configuration file option 
  375. is mutually exclusive with the other options. 
  376.  
  377. When you specify this option, the setup processor invokes configuration 
  378. services directly for interactive modification of the specified configuration 
  379. file.  You are returned to the command line after you exit configuration 
  380. services and complete any resulting installation activities. 
  381.  
  382. This request is rejected if the Interactive Configuration Interface is not 
  383. installed. 
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ <hidden> /I configuration ΓòÉΓòÉΓòÉ
  387.  
  388. Allows you to install or update IBM Communications Manager/2 Version 1.1 based 
  389. on the specified configuration file.  CONFIGURATION is a mandatory subparameter 
  390. and is a fully qualified configuration file name that must have an extension of 
  391. .CFG. 
  392.  
  393. You must enter either a colon or a space after the parameter. You do not need 
  394. to enter the file extension on the command line. The configuration file option 
  395. is mutually exclusive of the other options.  When you specify this option, the 
  396. setup processor installs according to the specified configuration file without 
  397. requiring that you enter configuration services. You are returned to the 
  398. command line after you exit the installation program.  The specified 
  399. configuration file is then copied to the \CMLIB subdirectory and upgraded if 
  400. necessary. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ <hidden> /D drive ΓòÉΓòÉΓòÉ
  404.  
  405. Allows you to remove an installed Communications Manager on your machine. This 
  406. option removes the Communications Manager executable code, the Communications 
  407. Manager/2 folder, and the CONFIG.SYS updates. The Communications Manager 
  408. configuration files and audit trail file are not removed. 
  409.  
  410. You do not have to type the blank or specify the disk drive. The default disk 
  411. drive is the current drive. 
  412.  
  413. This request is rejected if Communications Manager is running.  This request is 
  414. also rejected if the drive specified does not contain Communications Manager or 
  415. if the drive is not specified and Communications Manager is not installed on 
  416. any drive. 
  417.  
  418. Note:  /d is optional, if /d is used with /q then it is required. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  422.  
  423. Indicates that Communications Manager should be deleted from the specified 
  424. drive on your machine. 
  425.  
  426.  
  427. ΓòÉΓòÉΓòÉ <hidden> /Q ΓòÉΓòÉΓòÉ
  428.  
  429. When specified with the /d parameter, indicates that the deletion of files is 
  430. done in "quiet" mode (without windows). 
  431.  
  432.  
  433. ΓòÉΓòÉΓòÉ <hidden> /K ΓòÉΓòÉΓòÉ
  434.  
  435. Allows you to request that features not needed by the default configuration 
  436. file be removed.  The default configuration file and contents of the target 
  437. drive are compared, and any unneeded features are removed. 
  438.  
  439. This parameter is not supported if CMSETUP was invoked from install 
  440. diskettes/images.  This request is rejected if Communications Manager is 
  441. running with a configuration other than the default configuration. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  445.  
  446. Allows you to display the command line syntax on your screen.  The command line 
  447. syntax is displayed when any unrecognized parameters are entered. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ <hidden> /R response_file ΓòÉΓòÉΓòÉ
  451.  
  452. This parameter applies only when you are performing a response_file 
  453. installation or configuration of Communications Manager. Allows you to request 
  454. the following installation actions based on the specified response file: 
  455.  
  456.           o Install IBM Communications Manager. on a drive with no 
  457.             Communications Manager 
  458.  
  459.           o Upgrade a previous Communications Manager release to IBM 
  460.             Communications Manager/2 Version 1.1 (including installation and 
  461.             configuration) 
  462.  
  463.           o Configuration change with installation of additional features if 
  464.             necessary 
  465.  
  466.           o Configuration change without installation 
  467.  
  468.           o Re-install Communications Manager 
  469.  
  470.           o Remove communication features (based on the default configuration) 
  471.  
  472.           Response_file is a mandatory sub-parameter and is a fully qualified 
  473.           response file name that must have an extension of .RSP. This 
  474.           extension need not be entered on the command line. You must use a 
  475.           blank or colon after the /R parameter. The response file parameter is 
  476.           mutually exclusive of the previous parameters. 
  477.  
  478.           Response files are processed when Communications Manager is installed 
  479.           and configured using the /R parameter. For more information on 
  480.           response files and remote installation, refer to the online IBM 
  481.           Communications Manager/2 Version 1.1 Response File Reference. 
  482.  
  483.  
  484. ΓòÉΓòÉΓòÉ <hidden> /S ΓòÉΓòÉΓòÉ
  485.  
  486. This parameter applies only when you are performing a response_file 
  487. installation or configuration of Communications Manager. Specifies the path to 
  488. the product image files existing on the server. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ <hidden> /G ΓòÉΓòÉΓòÉ
  492.  
  493. This parameter applies only when you are performing a response_file 
  494. installation or configuration of Communications Manager. Specifies the path to 
  495. a directory on the server that can contain a general response file or other 
  496. data files.  You may not specify a diskette drive. 
  497.  
  498.  
  499. ΓòÉΓòÉΓòÉ <hidden> /L1 ΓòÉΓòÉΓòÉ
  500.  
  501. This parameter applies only when you are performing a response_file 
  502. installation or configuration of Communications Manager. Specifies the fully 
  503. qualified name of the file into which the log file for remote installation and 
  504. configuration is to be copied. 
  505.  
  506.  
  507. ΓòÉΓòÉΓòÉ <hidden> /L2 ΓòÉΓòÉΓòÉ
  508.  
  509. This parameter applies only when you are performing a response_file 
  510. installation or configuration of Communications Manager. Specifies the fully 
  511. qualified name of the file into which the installation log file is to be 
  512. copied. 
  513.  
  514.  
  515. ΓòÉΓòÉΓòÉ <hidden> /CR ΓòÉΓòÉΓòÉ
  516.  
  517. This parameter applies only when you are performing a response_file 
  518. installation or configuration of Communications Manager. Indicates that the 
  519. response file is a "current response file" and that no check should be made to 
  520. determine if it contains Extended Services specific keywords that need to be 
  521. converted.  If this parameter is not specified, the entire response file is 
  522. checked to determine the level of the keywords.  If they are the current level, 
  523. remote installation or configuration continues normally. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ <hidden> /MG ΓòÉΓòÉΓòÉ
  527.  
  528. This parameter applies only when you are performing a response_file 
  529. installation or configuration of Communications Manager. Indicates that the 
  530. response file will be migrated and that the migrated response file should be 
  531. saved as migr_file upon completion of the remote installation/configuration 
  532. request. The path, if not specified, defaults to \CMLIB. 
  533.  
  534. This parameter is only used when you are migrating from an Extended Services 
  535. response file and you want to save the output of the migration step.  If you do 
  536. not specify a migration file name, the default file name rspfile.mig is used 
  537. (where rspfile is the name of your response file). 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ <hidden> /KL ΓòÉΓòÉΓòÉ
  541.  
  542. This parameter applies only when you are performing a response_file 
  543. installation or configuration of Communications Manager. Specifies the keylock 
  544. password of the configuration file. 
  545.  
  546.  
  547. ΓòÉΓòÉΓòÉ <hidden> /Q ΓòÉΓòÉΓòÉ
  548.  
  549. This parameter applies only when you are performing a response_file 
  550. installation or configuration of Communications Manager. When specified with 
  551. the /R parameter, indicates that response file processing is done in "quiet" 
  552. mode (without windows). 
  553.  
  554.  
  555. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  556.  
  557. Command line parameters for this command are not case sensitive.  You must use 
  558. a colon or a space after any of the key parameter letters. 
  559.  
  560. If Communications Manager is not already installed, Communications Manager 
  561. determines the location of the product code required for installation by 
  562. examining the CMSETUP invocation. 
  563.  
  564. For example, if the product code is on diskette images on LAN drive X, you 
  565. would type X:\CMSETUP at the command prompt. 
  566.  
  567. After you are prompted to specify the target drive (the drive that will receive 
  568. the product files), you can complete all the configuration and feature 
  569. selections. 
  570.  
  571. If Communications Manager is already installed, you are asked for the location 
  572. of the Communications Manager product files required for installation. The 
  573. location of the target drive is assumed to be the same as the current 
  574. installation. 
  575.  
  576. The Interactive Configuration Interface is an additional function which is 
  577. installed by default.  If you do not want to install this additional function, 
  578. select Options from the menu bar on the CMSETUP window and select Remove 
  579. Additional Functions. You can select the functions you want to remove. 
  580.  
  581.  
  582. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  583.  
  584. The following are some examples of CMSETUP usage: 
  585.  
  586.           o To install MY.CFG located on D:\CMLIB, type the following and press 
  587.             Enter: 
  588.  
  589.                              CMSETUP /I D:\CMLIB\MY.CFG
  590.  
  591.           o To enter configuration services and open MY.CFG in D:\CMLIB, type 
  592.             the following and press Enter: 
  593.  
  594.                              CMSETUP /C D:\CMLIB\MY.CFG
  595.  
  596.           o To remove all features not associated with the default 
  597.             configuration, type the following and press Enter: 
  598.  
  599.                              CMSETUP /K
  600.  
  601.           o To remove Communications Manager from the D drive, type the 
  602.             following and press Enter: 
  603.  
  604.                              CMSETUP /D D:
  605.  
  606.           Use the following statement to do all of the following: 
  607.  
  608.           o Process a response file named JOE.RSP on the Z drive in the 
  609.             directory CMUSERS. 
  610.  
  611.           o Use Z:\GENERAL as the general path for additional files. 
  612.  
  613.           o Keep a record of the processing in Z:\CMOUTPUT\JOE.LOG. 
  614.  
  615.                          CMSETUP /R Z:\CMUSERS\JOE.RSP /G Z:\GENERAL
  616.                               /L1 z:\CMOUTPUT\JOE.LOG
  617.  
  618.  
  619. ΓòÉΓòÉΓòÉ 1.4. CMSERVER ΓòÉΓòÉΓòÉ
  620.  
  621. CMSERVER 
  622.  
  623.  Purpose 
  624.  
  625.  Syntax 
  626.  
  627.                     >>ΓöÇΓöÇCMSERVERΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  628.                            ΓööΓöÇ/?ΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ/SΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ/TΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ/FWΓöÇΓöÇΓöÿ
  629.  
  630.  
  631. ΓòÉΓòÉΓòÉ <hidden> /? ΓòÉΓòÉΓòÉ
  632.  
  633. Help (or any other incorrect parameter). 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ <hidden> /S ΓòÉΓòÉΓòÉ
  637.  
  638. Source drive of diskette or images (required for installation). 
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ <hidden> /T ΓòÉΓòÉΓòÉ
  642.  
  643. Target drive CMLIB (default to working directory) must be at the same CM level 
  644. (e.g. CM 1.1). 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ <hidden> /F filename ΓòÉΓòÉΓòÉ
  648.  
  649. Create report of available feature for redirected workstations (default to 
  650. CMSERVER.LOG). 
  651.  
  652.  
  653. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  654.  
  655. There is no remove option (removed with all CM). 
  656.  
  657. /F without any other parameters will generate a report file without performing 
  658. any installation. 
  659.  
  660. Note:  CMSERVER is an interactive command and is not supported to be run by a 
  661. CID process.  To install server capability remotely, put CMSERVER=1 in the CM 
  662. response file and issue the CMSETUP /R filename.rsp command. 
  663.  
  664.  
  665. ΓòÉΓòÉΓòÉ 1.5. CMUPGRAD ΓòÉΓòÉΓòÉ
  666.  
  667. CMUPGRAD 
  668.  
  669.  Purpose 
  670.  
  671.           Allows you to upgrade Communications Manager configuration files from 
  672.           the previous version of Communications Manager. This upgrade can take 
  673.           place without installing or going through the configuration dialog. 
  674.  
  675.  Syntax 
  676.  
  677.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMUPGRADΓöÇΓöÇfilenameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  678.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  679.  
  680.           Your current working drive must be the drive where Communications 
  681.           Manager resides. Your current working directory must be \CMLIB. 
  682.  
  683.  
  684. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  685.  
  686. The drive where Communications Manager resides.  Specify this drive only if it 
  687. is not the default drive. 
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  691.  
  692. The path designator. Your current working directory must be \CMLIB. Use this 
  693. path only if the file is not in the default path. 
  694.  
  695.  
  696. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  697.  
  698. The name of the configuration file to be upgraded.  This configuration file 
  699. must reside in the \CMLIB directory. 
  700.  
  701. Warning: Your source configuration file will be overwritten.  If you wish to 
  702. retain a copy of your original configuration file, make a backup prior to using 
  703. the CMUPGRAD command. 
  704.  
  705.  
  706. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  707.  
  708. The upgrade facility files are in the \CMLIB\DLL directory. Make sure this 
  709. directory is defined in the LIBPATH statement before using the CMUPGRAD 
  710. command.  Usually, this directory is included automatically in LIBPATH when you 
  711. install Communications Manager. 
  712.  
  713. The log file UPGRADE.LOG is created after each upgrade and is located in the 
  714. \CMLIB directory. In addition to the common .CFG file, there are 
  715. configuration-related files created for some specific features such as APPN and 
  716. LAN Adapter and Protocol Support (LAPS).  These new files are saved in 
  717. predefined directories.  For example, .NDF and .CF2 files are saved for APPN 
  718. and stored in \CMLIB. 
  719.  
  720. Note: 
  721.  
  722.            1. If you are upgrading from Extended Edition 1.30.1, make sure you 
  723.               run LAPS configuration to upgrade the information before you run 
  724.               Communications Manager configuration. 
  725.  
  726.            2. LAN Adapter and Protocol Support (LAPS) is available as part of 
  727.               Network Transport Services/2 (a separately orderable product). 
  728.  
  729.           Any autotrace selections you may have saved in your configuration are 
  730.           lost when you upgrade to IBM Communications Manager/2 Version 1.1. 
  731.           Trace selections in IBM Communications Manager/2 Version 1.1 are 
  732.           perpetual and there is no need for autotrace. 
  733.  
  734.  
  735. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  736.  
  737. The following is an example of CMUPGRAD usage: 
  738.  
  739.           o To upgrade an Extended Edition 1.30.1 or Extended Services 
  740.             configuration file to an IBM Communications Manager/2 Version 1.1 
  741.             format, follow these steps: 
  742.  
  743.               1. Duplicate and rename your original configuration file as an 
  744.                  archive copy. 
  745.  
  746.               2. Set your working directory to \CMLIB.  For example: 
  747.  
  748.                                        CD C:\CMLIB
  749.                  Drive C, in this example, is a variable and changes depending 
  750.                  on which drive Communications Manager resides. 
  751.  
  752.               3. Type the command followed by the name of the configuration 
  753.                  file to be upgraded.  For example: 
  754.  
  755.                                        CMUPGRAD MY.CFG
  756.  
  757.  
  758. ΓòÉΓòÉΓòÉ 1.6. CMVERIFY ΓòÉΓòÉΓòÉ
  759.  
  760. CMVERIFY 
  761.  
  762.  Purpose 
  763.  
  764.           Verifies a Communications Manager configuration. 
  765.  
  766.  Syntax 
  767.  
  768.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMVERIFYΓöÇΓöÇfilenameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  769.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ            ΓööΓöÇ/cΓöÇΓöÇ filenameΓöÇΓöÿ  ΓööΓöÇ/eΓöÇΓöÇΓöÇΓöÿ
  770.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  771.                       ΓööΓöÇ/iΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ  ΓööΓöÇ/kΓöÇΓöÇ keyΓöÇΓöÿ  ΓööΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÿ
  772.                          ΓööΓöÇnetiniΓöÇΓöÿ
  773.  
  774.  
  775. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  776.  
  777. The drive where the CMVERIFY.EXE file resides.  Specify this drive only if it 
  778. is not the default drive. 
  779.  
  780.  
  781. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  782.  
  783. The path designator that specifies where the CMVERIFY.EXE file resides. Use 
  784. this path only if the file is not in the default path. 
  785.  
  786.  
  787. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  788.  
  789. Indicates the name of the configuration file to be verified.  The specified 
  790. name is also used when the .CF2 and .SEC files are created. 
  791.  
  792.  
  793. ΓòÉΓòÉΓòÉ <hidden> /c filename ΓòÉΓòÉΓòÉ
  794.  
  795. Specifies a control file other than APPNV.CTL. 
  796.  
  797.  
  798. ΓòÉΓòÉΓòÉ <hidden> /e ΓòÉΓòÉΓòÉ
  799.  
  800. Updates Communications Manager Systems Network Architecture (SNA) information 
  801. if the configuration file is verified successfully.  This update process is 
  802. possible without stopping and restarting Communications Manager (dynamic 
  803. updating).  When using this option, an error message indicates if you have 
  804. requested a dynamic update that is not possible. 
  805.  
  806.  
  807. ΓòÉΓòÉΓòÉ <hidden> /i netini ΓòÉΓòÉΓòÉ
  808.  
  809. Indicates that ISDN parameters should be verified.  The optional filename 
  810. "netini" can be given to specify an alternate NETWORK.INI file to be used 
  811. during ISDN verification. "netini" may be fully qualified or have relative or 
  812. no path information included. 
  813.  
  814. The default file is NETWORK.INI, which is located in the active \CMLIB 
  815. directory. 
  816.  
  817.  
  818. ΓòÉΓòÉΓòÉ <hidden> /k key ΓòÉΓòÉΓòÉ
  819.  
  820. Specifies the key value (service or master) to unlock the configuration.  If 
  821. keylocked, you cannot update the .CF2 configuration file or dynamically update 
  822. the active .CFG configuration file without supplying the correct service or 
  823. master key. 
  824.  
  825. The key value must be between 1 and 8 alphanumeric characters. 
  826.  
  827.  
  828. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  829.  
  830. Displays syntax and help for CMVERIFY. 
  831.  
  832.  
  833. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  834.  
  835. CMVERIFY verifies a Communications Manager configuration and creates a binary 
  836. SNA data configuration file (.CF2) and security file (.SEC) if an ASCII SNA 
  837. data configuration file (.NDF) exists for the configuration. 
  838.  
  839. CMVERIFY uses the .NDF file to create the binary .CF2 file, which is used by 
  840. Communications Manager during execution. If you choose to manually alter the 
  841. SNA data in an .NDF file, or if a .CF2 file does not exist, you must run 
  842. CMVERIFY on that configuration in order for the changes to be effective. 
  843.  
  844.  
  845. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  846.  
  847. The following is an example of CMVERIFY usage: 
  848.  
  849.           o To verify the configuration "NODES" and update Communications 
  850.             Manager SNA information with the new configuration, type the 
  851.             following and press Enter: 
  852.  
  853.                              CMVERIFY nodes /e
  854.  
  855.           o To verify the configuration "ISDN1" including all ISDN parameters, 
  856.             type the following and press Enter : 
  857.  
  858.                              CMVERIFY isdn1 /i
  859.  
  860.             Note:  The default NETWORK.INI file is used in this case. 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 1.7. KEYLOCK ΓòÉΓòÉΓòÉ
  864.  
  865. KEYLOCK 
  866.  
  867.  Purpose 
  868.  
  869.           Allows you to protect a configuration against unauthorized or 
  870.           accidental changes. 
  871.  
  872.  Syntax 
  873.  
  874.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇKEYLOCKΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  875.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      Γö£ΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  876.                                      ΓööΓöÇΓöñ A Γö£ΓöÇΓöÿ
  877.                     Γö£ΓöÇΓöÇconfig_file_nameΓöÇΓöÇΓöñ B Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  878.                     Γö£ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  879.                       ΓööΓöÇcurrent_pswdΓöÇΓöÇΓö¼ΓöÇ/LΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇ/CMΓöÇΓöÇΓöÇnew_mstr_pswdΓöÇΓö¼ΓöÇΓöÇΓöñ C Γö£ΓöÇΓöÿ
  880.                               ΓööΓöÇ/UΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ/EMΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  881.                     Γö£ΓöÇΓöÇΓö¼ΓöÇ/CSΓöÇΓöÇΓöÇnew_srvc_pswdΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  882.                       ΓööΓöÇ/ESΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  883.  
  884.  
  885. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  886.  
  887. The drive where the KEYLOCK.EXE file resides.  Specify this drive only if it is 
  888. not the default drive. 
  889.  
  890.  
  891. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  892.  
  893. The path designator that specifies where the KEYLOCK.EXE file resides. Use this 
  894. path only if the file is not in the default path. 
  895.  
  896.  
  897. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  898.  
  899. Causes help text to be sent to STDOUT (usually the screen). If ? appears on the 
  900. command line, it must be the first command line parameter. Help is displayed 
  901. when an unrecognized keyword is encoutered or when no parameters are specified. 
  902.  
  903.  
  904. ΓòÉΓòÉΓòÉ <hidden> config_file_name ΓòÉΓòÉΓòÉ
  905.  
  906. The name of the configuration file in \CMLIB to change the password. 
  907.  
  908.  
  909. ΓòÉΓòÉΓòÉ <hidden> current_pswd ΓòÉΓòÉΓòÉ
  910.  
  911. The existing master or service password, if one exists. 
  912.  
  913.  
  914. ΓòÉΓòÉΓòÉ <hidden> /L ΓòÉΓòÉΓòÉ
  915.  
  916. Locks the configuration file, protecting it from updates. This can only be 
  917. specified if current_pswd supplied is either the master password or the service 
  918. password. 
  919.  
  920.  
  921. ΓòÉΓòÉΓòÉ <hidden> /U ΓòÉΓòÉΓòÉ
  922.  
  923. Unlocks the configuration file, allowing updates to the configuration. This can 
  924. only be specified if current_pswd supplied is either the master password or the 
  925. service password. 
  926.  
  927.  
  928. ΓòÉΓòÉΓòÉ <hidden> /CM new_master_pswd ΓòÉΓòÉΓòÉ
  929.  
  930. The new master password.  This can only be specified if the current_pswd 
  931. supplied is the master password or if the configuration currently has no 
  932. password. 
  933.  
  934.  
  935. ΓòÉΓòÉΓòÉ <hidden> /CS new_service_pswd ΓòÉΓòÉΓòÉ
  936.  
  937. The new service password.  This can only be specified if the current_pswd 
  938. supplied is either the master password or the service password, or if the 
  939. configuration currently has no password. 
  940.  
  941.  
  942. ΓòÉΓòÉΓòÉ <hidden> /EM ΓòÉΓòÉΓòÉ
  943.  
  944. Erases the existing master password.  This can only be specified if the 
  945. current_pswd supplied is the master password. 
  946.  
  947.  
  948. ΓòÉΓòÉΓòÉ <hidden> /ES ΓòÉΓòÉΓòÉ
  949.  
  950. Erases the existing service password.  This can only be specified if the 
  951. current_pswd supplied is either the master password or the service password. 
  952.  
  953.  
  954. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  955.  
  956. KEYLOCK can be executed from the Communications Manager/2 folder or from the 
  957. command line. 
  958.  
  959. To execute KEYLOCK from the Communications Manager/2 folder, select Keylock. 
  960.  
  961. When you execute KEYLOCK from the command line, you can issue the command with 
  962. or without parameters. 
  963.  
  964. Executing KEYLOCK without parameters has the same result as selecting Keylock 
  965. from the Communications Manager/2 folder (a Presentation Manager window 
  966. appears). 
  967.  
  968. If you issue the command with parameters, no windows will be shown, and errors 
  969. will be written to STDOUT.  If you want errors to be written to a file, provide 
  970. a file name as follows: 
  971.  
  972.      KEYLOCK :[parameters:] >error.file
  973. where error.file is the name of the file the errors are written to. 
  974.  
  975. KEYLOCK can be executed from any directory. 
  976.  
  977. If you use KEYLOCK on a configuration from a prior release of Communications 
  978. Manager, the Upgrade window appears. 
  979.  
  980.  
  981. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  982.  
  983. The following are examples of KEYLOCK usage: 
  984.  
  985.           o To use the windowed interface with the default config file name 
  986.             type: 
  987.  
  988.                              KEYLOCK
  989.  
  990.           o To use the windowed interface with config file "mycfg" type: 
  991.  
  992.                              KEYLOCK mycfg
  993.  
  994.           o To write help text to STDOUT type: 
  995.  
  996.                              KEYLOCK ?
  997.  
  998.           o To use the command line interface with config file "mycfg" and 
  999.             erase the master password type: 
  1000.  
  1001.                              KEYLOCK mycfg mstrpwd /EM
  1002.  
  1003.           o To use the non-windowed interface with config file "mycfg" and 
  1004.             change the master password type: 
  1005.  
  1006.                              KEYLOCK mycfg mstrpwd /CM newmstr
  1007.  
  1008.           o To use the non-windowed interface with config file "mycfg" and 
  1009.             change the service password type: 
  1010.  
  1011.                              KEYLOCK mycfg mstrpwd /CS newsvc
  1012.             or 
  1013.  
  1014.                              KEYLOCK mycfg svcpwd /CS newsvc
  1015.  
  1016.           o To use the non-windowed interface with config file "mycfg", erase 
  1017.             the service password, and have errors written to file USER57.ERR, 
  1018.             type: 
  1019.  
  1020.                              KEYLOCK mycfg svcpwd /ES >user57.err
  1021.  
  1022.           o To use the non-windowed interface with config file "mycfg" and lock 
  1023.             the configuration file type: 
  1024.  
  1025.                              KEYLOCK mycfg svcpwd /L
  1026.  
  1027.           o To use the non-windowed interface with config file "mycfg" and 
  1028.             unlock the configuration file type: 
  1029.  
  1030.                              KEYLOCK mycfg svcpwd /U
  1031.  
  1032.  
  1033. ΓòÉΓòÉΓòÉ 1.8. VHAPINST.EXE ΓòÉΓòÉΓòÉ
  1034.  
  1035. VHAPINST.EXE 
  1036.  
  1037.  Purpose 
  1038.  
  1039.           Adds or deletes the EHLLAPI virtual device driver statement. 
  1040.  
  1041.  Syntax 
  1042.  
  1043.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇVHAPINST.EXEΓöÇΓöÇ/DΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  1044.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  1045.  
  1046.  
  1047. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  1048.  
  1049. The drive where the VHAPINST.EXE file resides. Specify this drive only if it is 
  1050. not the default drive. 
  1051.  
  1052.  
  1053. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  1054.  
  1055. The path designator that specifies where the VHAPINST.EXE file resides. Use 
  1056. this path only if the file is not in the default path. 
  1057.  
  1058.  
  1059. ΓòÉΓòÉΓòÉ <hidden> /D ΓòÉΓòÉΓòÉ
  1060.  
  1061. Deletes the EHLLAPI virtual device driver statement from your CONFIG.SYS file. 
  1062.  
  1063.  
  1064. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  1065.  
  1066. By default, VHAPINST.EXE adds the EHLLAPI virtual device driver statement to 
  1067. your CONFIG.SYS file.  To delete the EHLLAPI virtual device driver statement 
  1068. from your CONFIG.SYS file, use the /D optional parameter. 
  1069.  
  1070.  
  1071. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  1072.  
  1073.      C:\CMLIB\VHAPINST.EXE
  1074.  
  1075.      C:\CMLIB\VHAPINST.EXE /D
  1076.  
  1077.  
  1078. ΓòÉΓòÉΓòÉ 2. Communications Commands ΓòÉΓòÉΓòÉ
  1079.  
  1080. This chapter describes Communications Manager communications commands. Each 
  1081. command description includes the purpose of the command, a syntax diagram, a 
  1082. list of parameters, a discussion of the options, remarks, and examples. 
  1083.  
  1084. In addition to using the Presentation Manager interface to perform 
  1085. Communications Manager functions, you can issue commands to start certain 
  1086. functions from the OS/2 command line. Unless otherwise specified, directions in 
  1087. this book assume you are invoking commands from the OS/2 command line. 
  1088.  
  1089. To view the list of communications commands, press Ctrl+C to return to the 
  1090. Contents. Next, select the plus sign (+) or press the + key. 
  1091.  
  1092.  
  1093. ΓòÉΓòÉΓòÉ 2.1. CM ΓòÉΓòÉΓòÉ
  1094.  
  1095. CM 
  1096.  
  1097.  Purpose 
  1098.  
  1099.           Starts Communications Manager from the OS/2 command line. 
  1100.  
  1101.  Syntax 
  1102.  
  1103.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  1104.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ    ΓööΓöÇfilenameΓöÇΓöÿ  ΓööΓöÇ/IΓöÇΓöÇΓöÇΓöÇΓöÿ
  1105.  
  1106.  
  1107. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  1108.  
  1109. Specifies the drive for the command you want to process. 
  1110.  
  1111.  
  1112. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  1113.  
  1114. Specifies the exact location of the command you want to process. 
  1115.  
  1116.  
  1117. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  1118.  
  1119. Name of the configuration that you want to use when you start Communications 
  1120. Manager.  If you do not specify this parameter, Communications Manager uses the 
  1121. default startup configuration specified in the initialization file CM.INI. Do 
  1122. not include the file extension.  Any file extension is ignored and assumed to 
  1123. be .CFG. 
  1124.  
  1125.  
  1126. ΓòÉΓòÉΓòÉ <hidden> I ΓòÉΓòÉΓòÉ
  1127.  
  1128. Specifies that you want the Communications Manager icon displayed in the window 
  1129. list.  The default is not to display the Communications Manager icon in the 
  1130. window list. 
  1131.  
  1132. Note:  If you start Communications Manager using this parameter and then select 
  1133. Communications Manager in the window list, the Communications Manager window 
  1134. appears.  This window contains statements about Communications Manager 
  1135. initialization and startup. Minimize this window to clear your screen.  If you 
  1136. close this window, Communications Manager is stopped. 
  1137.  
  1138.  
  1139. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  1140.  
  1141. To start Communications Manager from the Communications Manager/2 folder, 
  1142. select Start Communications. 
  1143.  
  1144.  
  1145. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  1146.  
  1147. The following are examples of CM usage: 
  1148.  
  1149.           o To start Communications Manager using the default configuration 
  1150.             specified in the initialization file, type the following and press 
  1151.             Enter: 
  1152.  
  1153.                              CM
  1154.  
  1155.           o To start Communications Manager using a configuration other than 
  1156.             the one specified in the initialization file, type CM and the name 
  1157.             of the configuration you want to activate. In the following 
  1158.             example, MYCONFIG is the name of the configuration to be activated. 
  1159.  
  1160.                              CM MYCONFIG
  1161.  
  1162.  
  1163. ΓòÉΓòÉΓòÉ 2.2. CMSTOP ΓòÉΓòÉΓòÉ
  1164.  
  1165. CMSTOP 
  1166.  
  1167.  Purpose 
  1168.  
  1169.           Starts the program used to stop Communications Manager either from 
  1170.           the Communications Manager/2 folder or from the command line. 
  1171.  
  1172.  Syntax 
  1173.  
  1174.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMSTOPΓöÇΓöÇΓö¼ΓöÇNORMALΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  1175.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      ΓööΓöÇABNORMALΓöÇΓöÿ
  1176.  
  1177.  
  1178. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  1179.  
  1180. The drive where the CMSTOP.EXE file resides.  Specify this drive only if it is 
  1181. not the default drive. 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  1185.  
  1186. The path designator that specifies where the CMSTOP.EXE file resides. Use this 
  1187. path only if the file is not in the default path. 
  1188.  
  1189.  
  1190. ΓòÉΓòÉΓòÉ <hidden> NORMAL ΓòÉΓòÉΓòÉ
  1191.  
  1192. This parameter allows a normal stop of Communications Manager and all services 
  1193. that are either started or starting at the time of the request.  A normal stop 
  1194. allows for a completion of normal processing before termination. This is the 
  1195. default parameter. 
  1196.  
  1197.  
  1198. ΓòÉΓòÉΓòÉ <hidden> ABNORMAL ΓòÉΓòÉΓòÉ
  1199.  
  1200. This parameter permits an abnormal stop of Communications Manager and all 
  1201. services that are either started, starting, or stopping at the time of the 
  1202. request.  An abnormal stop terminates processing without regard to the state of 
  1203. completion. 
  1204.  
  1205.  
  1206. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  1207.  
  1208. This command can be issued from any directory. 
  1209.  
  1210.  
  1211. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  1212.  
  1213. The following is an example of CMSTOP usage: 
  1214.  
  1215.           o To stop Communications Manager abnormally from the command line, 
  1216.             type the following and press Enter: 
  1217.  
  1218.                              CMSTOP ABNORMAL
  1219.  
  1220.  
  1221. ΓòÉΓòÉΓòÉ 2.3. RECEIVE-for CICS Host ΓòÉΓòÉΓòÉ
  1222.  
  1223. RECEIVE-for CICS Host 
  1224.  
  1225.  Purpose 
  1226.  
  1227.           Receives a file from an IBM CICS host computer. 
  1228.  
  1229.  Syntax 
  1230.  
  1231.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇRECEIVEΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename1ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  1232.                       ΓööΓöÇdrive1ΓöÇΓöÿ  ΓööΓöÇpath1ΓöÇΓöÿ      ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ
  1233.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  1234.                       ΓööΓöÇ.extΓöÇΓöÿ  ΓööΓöÇid:ΓöÇΓöÿ
  1235.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  1236.                       Γöé   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  1237.                       Γöé                       Γöé Γöé
  1238.                       ΓööΓöÇ(ΓöÇΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇCRLFΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  1239.                          Γöé ΓööΓöÇNOCRLFΓöÇΓöÿ              Γöé
  1240.                          Γöé      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ       Γöé
  1241.                          Γöé             Γöé       Γöé
  1242.                          Γö£ΓöÇΓö¼ΓöÇASCIIΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇΓöñ
  1243.                          Γöé Γöé     Γö£ΓöÇH(nnnnn)ΓöÇΓöñ  Γö£ΓöÇMIGRΓöÇΓöñ Γöé Γöé
  1244.                          Γöé Γöé     ΓööΓöÇP(nnnnn)ΓöÇΓöÿ  ΓööΓöÇSUBΓöÇΓöÇΓöÿ Γöé Γöé
  1245.                          Γöé ΓööΓöÇBINARYΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γöé
  1246.                          ΓööΓöÇT(nn)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1247.  
  1248.  
  1249. ΓòÉΓòÉΓòÉ <hidden> drive1 ΓòÉΓòÉΓòÉ
  1250.  
  1251. The drive where the RECEIVE.EXE file resides.  Specify this drive only if it is 
  1252. not the default drive. 
  1253.  
  1254.  
  1255. ΓòÉΓòÉΓòÉ <hidden> path1 ΓòÉΓòÉΓòÉ
  1256.  
  1257. The path designator that specifies where the RECEIVE.EXE file resides. Use this 
  1258. path only if the file is not in the default path. 
  1259.  
  1260.  
  1261. ΓòÉΓòÉΓòÉ <hidden> drive2 ΓòÉΓòÉΓòÉ
  1262.  
  1263. The drive where you want the file that you are receiving from the host computer 
  1264. to reside.  Specify this drive only if it is not the default drive.  In the 
  1265. examples for this command, a: is the drive. 
  1266.  
  1267.  
  1268. ΓòÉΓòÉΓòÉ <hidden> path2 ΓòÉΓòÉΓòÉ
  1269.  
  1270. The path designator that specifies where the file being received is to reside. 
  1271. Specify a path if the file is not to reside in the current directory. 
  1272.  
  1273.  
  1274. ΓòÉΓòÉΓòÉ <hidden> filename1 ΓòÉΓòÉΓòÉ
  1275.  
  1276. The name of the workstation file being received from the host computer. Use the 
  1277. FAT or HPFS naming conventions described in OS/2 Technical Library. In the 
  1278. examples for this command, report is the file name for the FAT file system; 
  1279. "long filename" is the file name for HPFS. 
  1280.  
  1281.  
  1282. ΓòÉΓòÉΓòÉ <hidden> .ext ΓòÉΓòÉΓòÉ
  1283.  
  1284. The extension for the workstation FAT file being received from the host 
  1285. computer.  In the examples for this command, .dat is the extension using the 
  1286. FAT file system. 
  1287.  
  1288.  
  1289. ΓòÉΓòÉΓòÉ <hidden> id: ΓòÉΓòÉΓòÉ
  1290.  
  1291. The 1- to 8-character name that identifies the 3270 emulation session used for 
  1292. the file transfer.  If you do not supply this parameter, the first configured 
  1293. 3270 emulation session that you start is used for the file transfer.  If no 
  1294. 3270 emulation sessions are configured and started, an error message is 
  1295. returned. 
  1296.  
  1297. You can view the identifiers in the configuration file and from the File 
  1298. Transfer Operations Menu. 
  1299.  
  1300. In the examples for this command, stat2 is the ID parameter. This parameter is 
  1301. separated from the file name by a colon (:). 
  1302.  
  1303.  
  1304. ΓòÉΓòÉΓòÉ <hidden> filename2 ΓòÉΓòÉΓòÉ
  1305.  
  1306. The CICS file name of the file that you want to transfer. The CICS file name 
  1307. must be the name in the first record of the file in CICS temporary storage.  In 
  1308. the examples for this command, report is the file name. 
  1309.  
  1310.  
  1311. ΓòÉΓòÉΓòÉ <hidden> ASCII ΓòÉΓòÉΓòÉ
  1312.  
  1313. Note:  The part of the command which follows is an option. Options are 
  1314.        separated from the last parameter by a left parenthesis with one space 
  1315.        between each option.  In the examples for this command, CRLF and ASCII 
  1316.        are the options. 
  1317.  
  1318.           Causes the host program to translate workstation files from EBCDIC to 
  1319.           ASCII so that the file is readable to the workstation. When receiving 
  1320.           text files from the host computer, specify the ASCII option.  If the 
  1321.           host computer file is already in ASCII form, do not supply this 
  1322.           option.  Do not use this option when you are transferring a binary 
  1323.           file. 
  1324.  
  1325.  
  1326. ΓòÉΓòÉΓòÉ <hidden> H(nnnnn) ΓòÉΓòÉΓòÉ
  1327.  
  1328. Note:  The part of the command which follows is an option. Options are 
  1329.        separated from the last parameter by a left parenthesis with one space 
  1330.        between each option.  In the examples for this command, CRLF and ASCII 
  1331.        are the options. 
  1332.  
  1333.           Specifies the host file code page you are using for the host file 
  1334.           being received, where nnnnn is the code page number. Refer to OS/2 
  1335.           Keyboard and Code Pages for information on code pages. If you do not 
  1336.           specify a code page, the system uses the code page for the host 
  1337.           character set of the emulation that is specified in the keyboard 
  1338.           remap profile. 
  1339.  
  1340.           The host code page also specifies the file transfer command program 
  1341.           you are using. 
  1342.  
  1343.           This option is valid only when the ASCII keyword is specified. 
  1344.  
  1345.  
  1346. ΓòÉΓòÉΓòÉ <hidden> P(nnnnn) ΓòÉΓòÉΓòÉ
  1347.  
  1348. Note:  The part of the command which follows is an option. Options are 
  1349.        separated from the last parameter by a left parenthesis with one space 
  1350.        between each option.  In the examples for this command, CRLF and ASCII 
  1351.        are the options. 
  1352.  
  1353.           Specifies the workstation file code page you are using for the 
  1354.           workstation file being sent, where nnnnn is the code page number. 
  1355.           Refer to OS/2 Keyboard and Code Pages for information on code pages. 
  1356.           If you do not specify a code page, the system uses the code page for 
  1357.           the active command line screen group. 
  1358.  
  1359.           This option is valid only when the ASCII option is specified. 
  1360.  
  1361.  
  1362. ΓòÉΓòÉΓòÉ <hidden> MIGR ΓòÉΓòÉΓòÉ
  1363.  
  1364. Note:  The part of the command which follows is an option. Options are 
  1365.        separated from the last parameter by a left parenthesis with one space 
  1366.        between each option.  In the examples for this command, CRLF and ASCII 
  1367.        are the options. 
  1368.  
  1369.           Allows you to send or receive files that were transferred using 
  1370.           Extended Edition 1.30.1 or Extended Services and Communications 
  1371.           Manager/2 Version 1.0. This option applies only to files that were 
  1372.           transferred in one direction using the ASCII option.  Use this option 
  1373.           to transfer the file back to the source location. 
  1374.  
  1375.           This option is valid only if the ASCII option is also specified. If 
  1376.           MIGR is specified but the ASCII option is not, MIGR is ignored. 
  1377.  
  1378.  
  1379. ΓòÉΓòÉΓòÉ <hidden> SUB ΓòÉΓòÉΓòÉ
  1380.  
  1381. Note:  The part of the command which follows is an option. Options are 
  1382.        separated from the last parameter by a left parenthesis with one space 
  1383.        between each option.  In the examples for this command, CRLF and ASCII 
  1384.        are the options. 
  1385.  
  1386.           Specifies multiple-substitute mapping for the file transfer.  All 
  1387.           unmatched code points are mapped to a specific set of characters in 
  1388.           the target code page to enhance comprehension.  With 
  1389.           multiple-substitute mapping, a file transferred to a host computer 
  1390.           and transferred back to the workstation is not identical to the 
  1391.           original file.  Code points that do not have a match in the target 
  1392.           code page are different. 
  1393.  
  1394.           If SUB is not specified, the file transfer function uses one-to-one 
  1395.           character mapping.  One-to-one character mapping maps each unmatched 
  1396.           code point to a unique character in the target code page.  With 
  1397.           one-to-one character mapping, a file transferred to a specific host 
  1398.           computer and transferred back to the workstation is identical to the 
  1399.           original file. 
  1400.  
  1401.           This option is valid only when the ASCII option is specified.  If SUB 
  1402.           is specified but the ASCII option is not, SUB is ignored. 
  1403.  
  1404.  
  1405. ΓòÉΓòÉΓòÉ <hidden> Binary ΓòÉΓòÉΓòÉ
  1406.  
  1407. Note:  The part of the command which follows is an option. Options are 
  1408.        separated from the last parameter by a left parenthesis with one space 
  1409.        between each option.  In the examples for this command, CRLF and ASCII 
  1410.        are the options. 
  1411.  
  1412.           Causes binary files to be sent to the workstation without being 
  1413.           changed.  When receiving binary files from the host computer, always 
  1414.           specify the BINARY option. 
  1415.  
  1416.  
  1417. ΓòÉΓòÉΓòÉ <hidden> CRLF ΓòÉΓòÉΓòÉ
  1418.  
  1419. Note:  The part of the command which follows is an option. Options are 
  1420.        separated from the last parameter by a left parenthesis with one space 
  1421.        between each option.  In the examples for this command, CRLF and ASCII 
  1422.        are the options. 
  1423.  
  1424.           Causes the host program to delete carriage-return and line-feed 
  1425.           characters from the host data before sending it to the workstation. 
  1426.  
  1427.           If you specified the ASCII option, EBCDIC blanks are removed.  If you 
  1428.           specified the BINARY option, ASCII blanks are removed. 
  1429.  
  1430.  
  1431. ΓòÉΓòÉΓòÉ <hidden> NOCRLF ΓòÉΓòÉΓòÉ
  1432.  
  1433. Note:  The part of the command which follows is an option. Options are 
  1434.        separated from the last parameter by a left parenthesis with one space 
  1435.        between each option.  In the examples for this command, CRLF and ASCII 
  1436.        are the options. 
  1437.  
  1438.           Specifies that the host computer file being sent does not consist of 
  1439.           logical records delimited by carriage-return or line-feed characters. 
  1440.           The file transfer program does not split the records, and the file is 
  1441.           written into the workstation file as one long string of data. 
  1442.  
  1443.  
  1444. ΓòÉΓòÉΓòÉ <hidden> T(nn) ΓòÉΓòÉΓòÉ
  1445.  
  1446. Note:  The part of the command which follows is an option. Options are 
  1447.        separated from the last parameter by a left parenthesis with one space 
  1448.        between each option.  In the examples for this command, CRLF and ASCII 
  1449.        are the options. 
  1450.  
  1451.           Specifies the period of time that the file transfer program waits for 
  1452.           the host computer to respond before canceling the file transfer 
  1453.           request.  nn is a 2-digit integer in a range from 00 through 99 that 
  1454.           indicates the number of 30-second increments the file transfer 
  1455.           program waits for the host computer to respond.  If nn is not 
  1456.           specified, 00 is the default, which means the file transfer program 
  1457.           waits indefinitely for the host computer to respond. 
  1458.  
  1459.           The file transfer program sends a message to the screen every 30 
  1460.           seconds until the host computer responds. 
  1461.  
  1462.  
  1463. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  1464.  
  1465. You can type the RECEIVE command in a command file and run that file from the 
  1466. OS/2 command line. 
  1467.  
  1468. You can transfer more than one file at a time, as long as each file transfer is 
  1469. on a different emulation session and is initiated from a different OS/2 
  1470. session.  The maximum number of concurrent file transfers is nine. 
  1471.  
  1472. To issue multiple file transfers, specify a different emulation session for 
  1473. each file transfer with the ID in the file transfer command. The emulation 
  1474. session that corresponds to the ID that you specify must be started, and you 
  1475. must be logged on and ready to receive a command. 
  1476.  
  1477. The options you use are always those that you specify in the command or those 
  1478. implied by the command.  The options in the file at the host computer, if any, 
  1479. are never used. 
  1480.  
  1481. The options CRLF and NOCRLF are mutually exclusive. 
  1482.  
  1483. The options CRLF and ASCII imply each other if only one is specified. 
  1484.  
  1485. The options BINARY and ASCII are mutually exclusive. 
  1486.  
  1487. Warning: Unpredictable ASCII to EBCDIC translation occurs if neither ASCII nor 
  1488. BINARY is specified. 
  1489.  
  1490. The options BINARY and NOCRLF imply each other if only one is specified. 
  1491.  
  1492. If no options are specified, CRLF and ASCII are assumed. 
  1493.  
  1494. The MIGR and SUB options cannot be specified together.  If both are specified, 
  1495. an error is displayed stating that the second option is not valid. 
  1496.  
  1497. If an error occurs during an attempted file transfer, the RECEIVE command sets 
  1498. the system environment variable ERRORLEVEL to a value equal to the returned 
  1499. TRANS code minus three.  Refer to Message Reference for descriptions of the 
  1500. TRANS codes. 
  1501.  
  1502. If your host file transfer program name is not IND$FILE, use the OS/2  SET 
  1503. command before issuing the file transfer command.  To use the SET command, type 
  1504. the following and press Enter: 
  1505.  
  1506. SET IND_FILE=xxxxxxxx
  1507. where xxxxxxxx is your host file transfer name. You should use the OS/2 SET 
  1508. command in the CONFIG.SYS file to avoid typing the SET command each time. 
  1509.  
  1510.  
  1511. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  1512.  
  1513. The following are examples of RECEIVE usage: 
  1514.  
  1515.           o To receive a file with an FAT file name from an IBM CICS host 
  1516.             computer, type the RECEIVE command with the necessary parameters at 
  1517.             an OS/2 command line and press Enter.  For example: 
  1518.  
  1519.                              receive a:report.dat stat2:report (CRLF ASCII
  1520.  
  1521.           o To receive a file with an HPFS file name from an IBM CICS host 
  1522.             computer, type the RECEIVE command with the necessary parameters at 
  1523.             an OS/2 command line and press Enter.  For example: 
  1524.  
  1525.                              receive a:\firstdir\seconddir\"long filename"
  1526.                                   stat2:report (CRLF ASCII
  1527.  
  1528.             Note the use of quotation marks when specifying a filename 
  1529.             containing blanks. 
  1530.  
  1531.  
  1532. ΓòÉΓòÉΓòÉ 2.4. SEND-for CICS Host ΓòÉΓòÉΓòÉ
  1533.  
  1534. SEND-for CICS Host 
  1535.  
  1536.  Purpose 
  1537.  
  1538.           Sends a file to an IBM CICS host computer. 
  1539.  
  1540.  Syntax 
  1541.  
  1542.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇSENDΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename1ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇ>
  1543.                       ΓööΓöÇdrive1ΓöÇΓöÿ  ΓööΓöÇpath1ΓöÇΓöÿ     ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ       ΓööΓöÇ.extΓöÇΓöÿ
  1544.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  1545.                       ΓööΓöÇid:ΓöÇΓöÿ
  1546.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  1547.                       Γöé   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé  ΓööΓöÇ)commentsΓöÇΓöÿ
  1548.                       Γöé                       Γöé Γöé
  1549.                       ΓööΓöÇ(ΓöÇΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇCRLFΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  1550.                          Γöé ΓööΓöÇNOCRLFΓöÇΓöÿ              Γöé
  1551.                          Γöé      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ       Γöé
  1552.                          Γöé             Γöé       Γöé
  1553.                          Γö£ΓöÇΓö¼ΓöÇASCIIΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇΓöñ
  1554.                          Γöé Γöé     Γö£ΓöÇH(nnnnn)ΓöÇΓöñ  Γö£ΓöÇMIGRΓöÇΓöñ Γöé Γöé
  1555.                          Γöé Γöé     ΓööΓöÇP(nnnnn)ΓöÇΓöÿ  ΓööΓöÇSUBΓöÇΓöÇΓöÿ Γöé Γöé
  1556.                          Γöé ΓööΓöÇBINARYΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γöé
  1557.                          ΓööΓöÇT(nn)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1558.  
  1559.  
  1560. ΓòÉΓòÉΓòÉ <hidden> drive1 ΓòÉΓòÉΓòÉ
  1561.  
  1562. The drive where the SEND.EXE file resides.  Specify this drive only if it is 
  1563. not the default drive. 
  1564.  
  1565.  
  1566. ΓòÉΓòÉΓòÉ <hidden> path1 ΓòÉΓòÉΓòÉ
  1567.  
  1568. The path designator that specifies where the SEND.EXE file resides. Use this 
  1569. path only if the file is not in the default path. 
  1570.  
  1571.  
  1572. ΓòÉΓòÉΓòÉ <hidden> drive2 ΓòÉΓòÉΓòÉ
  1573.  
  1574. The drive where the workstation file that you want to send to the host computer 
  1575. resides.  Specify this drive only if it is not the default drive.  In the 
  1576. examples for this command, a: is the drive. 
  1577.  
  1578.  
  1579. ΓòÉΓòÉΓòÉ <hidden> path2 ΓòÉΓòÉΓòÉ
  1580.  
  1581. The path designator that specifies where the workstation file that you want to 
  1582. send resides.  Use this path only if the file is not in the current directory. 
  1583.  
  1584.  
  1585. ΓòÉΓòÉΓòÉ <hidden> filename1 ΓòÉΓòÉΓòÉ
  1586.  
  1587. The name of the workstation file that you want to send.  Use the FAT or HPFS 
  1588. naming conventions described in OS/2 Technical Library. In the examples for 
  1589. this command, report is the file name for the FAT file system; "long filename" 
  1590. is the file name for HPFS. 
  1591.  
  1592.  
  1593. ΓòÉΓòÉΓòÉ <hidden> .ext ΓòÉΓòÉΓòÉ
  1594.  
  1595. The extension for the workstation FAT file that you want to send. In the 
  1596. examples for this command, .dat is the extension. 
  1597.  
  1598.  
  1599. ΓòÉΓòÉΓòÉ <hidden> id: ΓòÉΓòÉΓòÉ
  1600.  
  1601. The 1- to 8-character name that identifies the 3270 emulation session used for 
  1602. the file transfer.  If you do not supply this parameter, the first configured 
  1603. 3270 emulation session that you start is used for the file transfer.  If no 
  1604. 3270 emulation sessions are configured and started, an error message is 
  1605. returned. 
  1606.  
  1607. You can view the identifiers in the configuration file and from the File 
  1608. Transfer Main Menu. 
  1609.  
  1610. In the examples for this command, stat2 is the ID parameter. This parameter is 
  1611. separated from the file name by a colon (:). 
  1612.  
  1613.  
  1614. ΓòÉΓòÉΓòÉ <hidden> filename2 ΓòÉΓòÉΓòÉ
  1615.  
  1616. The CICS file name of the file that you want to transfer.  The name can be up 
  1617. to 8 characters and must begin with a letter.  The file name may be a program 
  1618. name, a transaction identifier, or any other identifier selected by the CICS 
  1619. application programmer.  This name is written into the first record of the host 
  1620. computer file to allow host users, such as another transaction, to identify the 
  1621. data sent from the workstation.  In the examples for this command, report is 
  1622. the file name. 
  1623.  
  1624.  
  1625. ΓòÉΓòÉΓòÉ <hidden> ASCII ΓòÉΓòÉΓòÉ
  1626.  
  1627. Note:  The following part of the command is an option. Options are separated 
  1628.        from the last parameter by a left parenthesis with one space between 
  1629.        each option. In the examples for this command, ASCII is the option. 
  1630.  
  1631.           Causes the host program to translate work station files from ASCII to 
  1632.           EBCDIC so that the file is readable to the host computer.  When 
  1633.           sending text files to the host computer, specify the ASCII option. 
  1634.           If the workstation file is already in EBCDIC form, do not supply this 
  1635.           option. Do not use this option when you are transferring a binary 
  1636.           file. 
  1637.  
  1638.  
  1639. ΓòÉΓòÉΓòÉ <hidden> H(nnnnn) ΓòÉΓòÉΓòÉ
  1640.  
  1641. Note:  The following part of the command is an option. Options are separated 
  1642.        from the last parameter by a left parenthesis with one space between 
  1643.        each option. In the examples for this command, ASCII is the option. 
  1644.  
  1645.           Specifies the host file code page you are using for the host file 
  1646.           being received, where nnnnn is the code page number. Refer to OS/2 
  1647.           Keyboard and Code Pages for information on code pages. If you do not 
  1648.           specify a code page, the system uses the code page for the host 
  1649.           character set of the emulation that is specified in the keyboard 
  1650.           remap profile. 
  1651.  
  1652.           The host code page also specifies the file transfer command program 
  1653.           you are using. 
  1654.  
  1655.           This option is only valid when the ASCII keyword is specified. 
  1656.  
  1657.  
  1658. ΓòÉΓòÉΓòÉ <hidden> P(nnnnn) ΓòÉΓòÉΓòÉ
  1659.  
  1660. Note:  The following part of the command is an option. Options are separated 
  1661.        from the last parameter by a left parenthesis with one space between 
  1662.        each option. In the examples for this command, ASCII is the option. 
  1663.  
  1664.           Specifies the workstation file code page you are using for the 
  1665.           workstation file being sent, where nnnnn is the code page number. 
  1666.           Refer to OS/2 Keyboard and Code Pages for information on code pages. 
  1667.           If you do not specify a code page, the system uses the code page for 
  1668.           the active command-prompt screen group. 
  1669.  
  1670.           This option is valid only when the ASCII option is specified. 
  1671.  
  1672.  
  1673. ΓòÉΓòÉΓòÉ <hidden> MIGR ΓòÉΓòÉΓòÉ
  1674.  
  1675. Note:  The following part of the command is an option. Options are separated 
  1676.        from the last parameter by a left parenthesis with one space between 
  1677.        each option. In the examples for this command, ASCII is the option. 
  1678.  
  1679.           Allows you to send or receive files that were transferred using 
  1680.           Extended Edition 1.30.1 or Extended Services and Communications 
  1681.           Manager/2 Version 1.0. This option applies only to files that were 
  1682.           transferred in one direction using the ASCII option.  Use this option 
  1683.           to transfer the file back to the source location. 
  1684.  
  1685.           This option is valid only if the ASCII option is also specified.  If 
  1686.           MIGR is specified but the ASCII option is not, MIGR is ignored. 
  1687.  
  1688.  
  1689. ΓòÉΓòÉΓòÉ <hidden> SUB ΓòÉΓòÉΓòÉ
  1690.  
  1691. Note:  The following part of the command is an option. Options are separated 
  1692.        from the last parameter by a left parenthesis with one space between 
  1693.        each option. In the examples for this command, ASCII is the option. 
  1694.  
  1695.           Specifies multiple-substitute mapping for the file transfer.  All 
  1696.           unmatched code points are mapped to a specific set of characters in 
  1697.           the target code page to enhance comprehension.  With 
  1698.           multiple-substitute mapping, a file transferred to a host computer 
  1699.           and transferred back to the workstation is not identical to the 
  1700.           original file.  Code points that do not have a match in the target 
  1701.           code page are different. 
  1702.  
  1703.           If SUB is not specified, the file transfer function uses one-to-one 
  1704.           character mapping.  One-to-one character mapping maps each unmatched 
  1705.           code point to a unique character in the target code page.  With 
  1706.           one-to-one character mapping, a file transferred to a specific host 
  1707.           computer and transferred back to the workstation is identical to the 
  1708.           original file. 
  1709.  
  1710.           This option is valid only when the ASCII option is specified.  If SUB 
  1711.           is specified but the ASCII option is not, SUB is ignored. 
  1712.  
  1713.  
  1714. ΓòÉΓòÉΓòÉ <hidden> BINARY ΓòÉΓòÉΓòÉ
  1715.  
  1716. Note:  The following part of the command is an option. Options are separated 
  1717.        from the last parameter by a left parenthesis with one space between 
  1718.        each option. In the examples for this command, ASCII is the option. 
  1719.  
  1720.           Causes binary files to be sent to the host computer without being 
  1721.           changed. When sending binary files to the host computer, always 
  1722.           specify the BINARY option. 
  1723.  
  1724.  
  1725. ΓòÉΓòÉΓòÉ <hidden> CRLF ΓòÉΓòÉΓòÉ
  1726.  
  1727. Note:  The following part of the command is an option. Options are separated 
  1728.        from the last parameter by a left parenthesis with one space between 
  1729.        each option. In the examples for this command, ASCII is the option. 
  1730.  
  1731.           Causes the host program to delete carriage return and line feed 
  1732.           characters from the workstation data before storing it at the host 
  1733.           computer.  When sending an ASCII or EBCDIC file to the computer, you 
  1734.           should always supply the CRLF option so the file is readable when on 
  1735.           the host computer. 
  1736.  
  1737.           Note:  The file is written into CICS temporary storage using one item 
  1738.                  on the queue to represent each logical record.  Null records 
  1739.                  in workstation files, indicated by two carriage return or line 
  1740.                  feed characters in a row, are represented in the file in CICS 
  1741.                  temporary storage by an item with two blanks in it. 
  1742.  
  1743.           If you specify the ASCII option, the blanks inserted into the file 
  1744.           are EBCDIC blanks. 
  1745.  
  1746.           The maximum length allowed for a logical record is 32767 bytes. If a 
  1747.           logical record exceeds this size, you receive a warning message at 
  1748.           the end of the file transfer.  Data is not lost but may be 
  1749.           incorrectly formatted on the host. 
  1750.  
  1751.  
  1752. ΓòÉΓòÉΓòÉ <hidden> NOCRLF ΓòÉΓòÉΓòÉ
  1753.  
  1754. Note:  The following part of the command is an option. Options are separated 
  1755.        from the last parameter by a left parenthesis with one space between 
  1756.        each option. In the examples for this command, ASCII is the option. 
  1757.  
  1758.           Specifies that the workstation file sent does not consist of logical 
  1759.           records delimited by carriage-return or line-feed characters. The 
  1760.           file transfer program does not split the records, and the file is 
  1761.           written into CICS temporary storage using one item on the queue to 
  1762.           represent each inbound data buffer. 
  1763.  
  1764.  
  1765. ΓòÉΓòÉΓòÉ <hidden> T(nn) ΓòÉΓòÉΓòÉ
  1766.  
  1767. Note:  The following part of the command is an option. Options are separated 
  1768.        from the last parameter by a left parenthesis with one space between 
  1769.        each option. In the examples for this command, ASCII is the option. 
  1770.  
  1771.           Specifies the period of time that the file transfer program waits for 
  1772.           the host computer to respond before canceling the file transfer 
  1773.           request.  nn is a 2-digit integer in a range from 00 through 99 that 
  1774.           indicates the number of 30-second increments the file transfer 
  1775.           program waits for the host computer to respond.  If nn is not 
  1776.           specified, 00 is the default, which means the file transfer program 
  1777.           waits indefinitely for the host computer to respond. 
  1778.  
  1779.           The file transfer program sends a message to the screen every 30 
  1780.           seconds until the host computer responds. 
  1781.  
  1782.  
  1783. ΓòÉΓòÉΓòÉ <hidden> )comments ΓòÉΓòÉΓòÉ
  1784.  
  1785. Note:  The following part of the command is an option. Options are separated 
  1786.        from the last parameter by a left parenthesis with one space between 
  1787.        each option. In the examples for this command, ASCII is the option. 
  1788.  
  1789.           Allows you to supply comments or control information to be associated 
  1790.           with the host computer file. 
  1791.  
  1792.           Indicate the end of your options and the beginning of your comments 
  1793.           by typing a blank followed by a right parenthesis.  Follow the 
  1794.           parenthesis with your comments. The blank before the right 
  1795.           parenthesis is required for proper recognition of the options 
  1796.           specified. If you want to add comments without specifying any 
  1797.           options, type the left and right parentheses immediately before the 
  1798.           comments to indicate the absence of options. 
  1799.  
  1800.           Comments are written into the first record of the host computer file, 
  1801.           where they are available for another transaction to use. 
  1802.  
  1803.           In the examples for this command,  )enddata is the comment. 
  1804.  
  1805.  
  1806. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  1807.  
  1808. You can type the SEND command in a command file and run that file from the OS/2 
  1809. command line. 
  1810.  
  1811. You can transfer more than one file at a time, as long as each file transfer is 
  1812. on a different emulation session and is initiated from a different OS/2 
  1813. session.  The maximum number of concurrent file transfers is nine. 
  1814.  
  1815. To issue multiple file transfers, specify a different emulation session for 
  1816. each file transfer with the ID in the file transfer command. The emulation 
  1817. session that corresponds to the ID that you specify must be started, and you 
  1818. must be logged on and ready to receive a command. 
  1819.  
  1820. The options you use are always written into the first record of the host 
  1821. computer file, regardless of whether they were specified at the workstation. 
  1822.  
  1823. The options CRLF and NOCRLF are mutually exclusive. 
  1824.  
  1825. The options CRLF and ASCII imply each other if only one is specified. 
  1826.  
  1827. The options BINARY and ASCII are mutually exclusive. 
  1828.  
  1829. The options BINARY and NOCRLF imply each other if only one is specified. 
  1830.  
  1831. If no options are specified, CRLF and ASCII are assumed. 
  1832.  
  1833. The MIGR and SUB options cannot be specified together.  If both are specified, 
  1834. an error is displayed stating that the second option is not valid. 
  1835.  
  1836. If an error occurs during an attempted file transfer, the SEND command sets the 
  1837. system environment variable ERRORLEVEL to a value equal to the returned TRANS 
  1838. code minus three.  Refer to Message Reference for descriptions of the TRANS 
  1839. codes. 
  1840.  
  1841. If your host file transfer program name is not IND$FILE, use the OS/2  SET 
  1842. command before issuing the file transfer command.  To use the SET command, type 
  1843. the following and press Enter: 
  1844.  
  1845. SET IND_FILE=xxxxxxxx 
  1846.  
  1847. where xxxxxxxx is your host file transfer name. You should use the OS/2 SET 
  1848. command in the CONFIG.SYS file to avoid typing the SET command each time. 
  1849.  
  1850.  
  1851. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  1852.  
  1853. The following are examples of SEND usage: 
  1854.  
  1855.           o To send a file with an FAT file name to an IBM CICS host computer, 
  1856.             type the SEND command with the necessary parameters at an OS/2 
  1857.             command line and press Enter.  For example: 
  1858.  
  1859.                              send a:report.dat stat2:report (ASCII )enddata
  1860.  
  1861.           o To send a file with an HPFS file name to an IBM CICS host computer, 
  1862.             type the SEND command with the necessary parameters at an OS/2 
  1863.             command line and press Enter.  For example: 
  1864.  
  1865.                              send a:\firstdir\seconddir\"long filename"
  1866.                                   stat2:report (ASCII )enddata
  1867.  
  1868.             Note the use of quotation marks when specifying a filename 
  1869.             containing blanks. 
  1870.  
  1871.  
  1872. ΓòÉΓòÉΓòÉ 2.5. RECEIVE-for TSO Host ΓòÉΓòÉΓòÉ
  1873.  
  1874. RECEIVE-for TSO Host 
  1875.  
  1876.  Purpose 
  1877.  
  1878.           Receives a file from an IBM TSO host computer. 
  1879.  
  1880.  Syntax 
  1881.  
  1882.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇRECEIVEΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilenameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  1883.                       ΓööΓöÇdrive1ΓöÇΓöÿ  ΓööΓöÇpath1ΓöÇΓöÿ      ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ
  1884.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇdatasetnameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  1885.                       ΓööΓöÇ.extΓöÇΓöÿ  ΓööΓöÇid:ΓöÇΓöÿ        ΓööΓöÇ(membername)ΓöÇΓöÿ  ΓööΓöÇ/passwordΓöÇΓöÿ
  1886.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  1887.                       Γöé ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  1888.                       Γöé                   Γöé Γöé
  1889.                       ΓööΓöÇΓöÇΓö¼ΓöÇAPPENDΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  1890.                        Γöé     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ      Γöé
  1891.                        Γöé            Γöé      Γöé
  1892.                        Γö£ΓöÇASCIIΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöñ
  1893.                        Γöé     Γö£ΓöÇH(nnnnn)ΓöÇΓöñ  Γö£ΓöÇMIGRΓöÇΓöñ Γöé
  1894.                        Γöé     ΓööΓöÇP(nnnnn)ΓöÇΓöÿ  ΓööΓöÇSUBΓöÇΓöÇΓöÿ Γöé
  1895.                        Γö£ΓöÇCRLFΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1896.                        ΓööΓöÇT(nn)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1897.  
  1898.  
  1899. ΓòÉΓòÉΓòÉ <hidden> drive1 ΓòÉΓòÉΓòÉ
  1900.  
  1901. The drive where the RECEIVE.EXE file resides.  Specify this drive only if it is 
  1902. not the default drive. 
  1903.  
  1904.  
  1905. ΓòÉΓòÉΓòÉ <hidden> path1 ΓòÉΓòÉΓòÉ
  1906.  
  1907. The path designator that specifies where the RECEIVE.EXE file resides. Use this 
  1908. path only if the file is not in the default path. 
  1909.  
  1910.  
  1911. ΓòÉΓòÉΓòÉ <hidden> drive2 ΓòÉΓòÉΓòÉ
  1912.  
  1913. The drive where you want the data set that you are receiving from the host 
  1914. computer to reside.  Specify a drive if the file is not to reside on the 
  1915. default drive.  In the examples for this command, a: is the drive. 
  1916.  
  1917.  
  1918. ΓòÉΓòÉΓòÉ <hidden> path2 ΓòÉΓòÉΓòÉ
  1919.  
  1920. The path designator that specifies where the file being received is to reside. 
  1921. Specify a path if the file is not to reside in the current directory. 
  1922.  
  1923.  
  1924. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  1925.  
  1926. The name of the file being received from the host computer.  Use the FAT or 
  1927. HPFS naming conventions described in OS/2 Technical Library. In the examples 
  1928. for this command, myfile is the file name for the FAT file system; "long 
  1929. filename" is the name for HPFS. 
  1930.  
  1931.  
  1932. ΓòÉΓòÉΓòÉ <hidden> .ext ΓòÉΓòÉΓòÉ
  1933.  
  1934. The extension for the FAT file being received from the host computer.  The file 
  1935. name will not have an extension if you do not supply one.  In the examples for 
  1936. this command, .txt is the extension. 
  1937.  
  1938.  
  1939. ΓòÉΓòÉΓòÉ <hidden> id: ΓòÉΓòÉΓòÉ
  1940.  
  1941. The 1- to 8-character name that identifies the 3270 emulation session used for 
  1942. the file transfer.  If you do not supply this parameter, the first configured 
  1943. 3270 emulation session that you start is used for the file transfer. 
  1944.  
  1945. For 3270 emulation sessions, this parameter can be either a long session ID or 
  1946. a short session ID. 
  1947.  
  1948. You can view the identifiers in the configuration file and from the File 
  1949. Transfer Operations Menu. 
  1950.  
  1951. In the examples for this command, stat2 is the ID parameter. This parameter is 
  1952. separated from the data set name by a colon (:). 
  1953.  
  1954.  
  1955. ΓòÉΓòÉΓòÉ <hidden> datasetname ΓòÉΓòÉΓòÉ
  1956.  
  1957. The name of the TSO data set to be received.  To show that the user ID is not 
  1958. prefixed, you can Enter the data set name and member name together and enclose 
  1959. the information in quotation marks.  In the examples for this command, boss is 
  1960. the data set name. 
  1961.  
  1962.  
  1963. ΓòÉΓòÉΓòÉ <hidden> (membername) ΓòÉΓòÉΓòÉ
  1964.  
  1965. The name of a member of a partitioned data set.  The data set must already 
  1966. exist.  In the examples for this command, bossname is the member name.  Note 
  1967. that the member name is enclosed in parentheses (). 
  1968.  
  1969.  
  1970. ΓòÉΓòÉΓòÉ <hidden> /password ΓòÉΓòÉΓòÉ
  1971.  
  1972. The password that allows access to password-protected TSO data sets.  This 
  1973. parameter is required only if the data set is password-protected.  In the 
  1974. examples for this command, gky5hf is the password. Note that the password is 
  1975. preceded by a slash (/). 
  1976.  
  1977.  
  1978. ΓòÉΓòÉΓòÉ <hidden> APPEND ΓòÉΓòÉΓòÉ
  1979.  
  1980. Note:  The following part of the command is an option.  Options are separated 
  1981.        from the last parameter with one space and one additional space between 
  1982.        each option.  In the examples for this command, ASCII is the option. 
  1983.  
  1984.           Allows you to attach the host data set to the end of an existing 
  1985.           workstation file. 
  1986.  
  1987.           Warning: If APPEND is not specified and a workstation file already 
  1988.           exists with the same name, the host data set replaces the existing 
  1989.           workstation file. 
  1990.  
  1991.  
  1992. ΓòÉΓòÉΓòÉ <hidden> ASCII ΓòÉΓòÉΓòÉ
  1993.  
  1994. Note:  The following part of the command is an option.  Options are separated 
  1995.        from the last parameter with one space and one additional space between 
  1996.        each option.  In the examples for this command, ASCII is the option. 
  1997.  
  1998.           Causes the host program to translate workstation files from EBCDIC to 
  1999.           ASCII so that the file is readable to the workstation. When receiving 
  2000.           text data sets from the host computer, always specify the ASCII 
  2001.           option.  If the host data set is already in ASCII form, do not supply 
  2002.           this option.  Do not use this option when you are transferring a 
  2003.           binary file. 
  2004.  
  2005.  
  2006. ΓòÉΓòÉΓòÉ <hidden> H(nnnnn) ΓòÉΓòÉΓòÉ
  2007.  
  2008. Note:  The following part of the command is an option.  Options are separated 
  2009.        from the last parameter with one space and one additional space between 
  2010.        each option.  In the examples for this command, ASCII is the option. 
  2011.  
  2012.           Specifies the host computer file code page you are using for the host 
  2013.           file being sent, where nnnnn is the code page number. Refer to OS/2 
  2014.           Keyboard and Code Pages for information on code pages. If you do not 
  2015.           specify a code page, the system uses the code page for the host 
  2016.           character set of the terminal emulation session that is specified in 
  2017.           the keyboard remap profile. 
  2018.  
  2019.           The host code page also specifies the file transfer command program 
  2020.           you are using. 
  2021.  
  2022.           This option is only valid when the ASCII keyword is specified. 
  2023.  
  2024.  
  2025. ΓòÉΓòÉΓòÉ <hidden> P(nnnnn) ΓòÉΓòÉΓòÉ
  2026.  
  2027. Note:  The following part of the command is an option.  Options are separated 
  2028.        from the last parameter with one space and one additional space between 
  2029.        each option.  In the examples for this command, ASCII is the option. 
  2030.  
  2031.           Specifies the workstation file code page you are using for the 
  2032.           workstation file being received, where nnnnn is the code page number. 
  2033.           Refer to OS/2 Keyboard and Code Pages for information on code pages. 
  2034.           If you do not specify a code page, the system uses the code page for 
  2035.           the active command-prompt screen group. 
  2036.  
  2037.           This option is valid only when the ASCII option is specified. 
  2038.  
  2039.  
  2040. ΓòÉΓòÉΓòÉ <hidden> MIGR ΓòÉΓòÉΓòÉ
  2041.  
  2042. Note:  The following part of the command is an option.  Options are separated 
  2043.        from the last parameter with one space and one additional space between 
  2044.        each option.  In the examples for this command, ASCII is the option. 
  2045.  
  2046.           Allows you to send or receive files that were transferred using 
  2047.           Extended Edition 1.30.1 or Extended Services and Communications 
  2048.           Manager/2 Version 1.0. This option applies only to files that were 
  2049.           transferred in one direction using the ASCII option.  Use this option 
  2050.           to transfer the file back to the source location. 
  2051.  
  2052.           This option is valid only if the ASCII option is also specified.  If 
  2053.           MIGR is specified but the ASCII option is not, MIGR is ignored. 
  2054.  
  2055.  
  2056. ΓòÉΓòÉΓòÉ <hidden> SUB ΓòÉΓòÉΓòÉ
  2057.  
  2058. Note:  The following part of the command is an option.  Options are separated 
  2059.        from the last parameter with one space and one additional space between 
  2060.        each option.  In the examples for this command, ASCII is the option. 
  2061.  
  2062.           Specifies multiple-substitute mapping for the file transfer. All 
  2063.           unmatched code points are mapped to a specific set of characters in 
  2064.           the target code page to enhance comprehension.  With 
  2065.           multiple-substitute mapping, a file transferred to a host computer 
  2066.           and transferred back to the workstation is not identical to the 
  2067.           original file.  Code points that did not have a match in the target 
  2068.           code page are different. 
  2069.  
  2070.           If SUB is not specified, the file transfer function uses one-to-one 
  2071.           character mapping.  One-to-one character mapping maps each unmatched 
  2072.           code point to a unique character in the target code page.  With 
  2073.           one-to-one character mapping, a file transferred to a specific host 
  2074.           computer and transferred back to the workstation is identical to the 
  2075.           original file. 
  2076.  
  2077.           This option is valid only when the ASCII option is specified.  If SUB 
  2078.           is specified but the ASCII option is not, SUB is ignored. 
  2079.  
  2080.  
  2081. ΓòÉΓòÉΓòÉ <hidden> T(nn) ΓòÉΓòÉΓòÉ
  2082.  
  2083. Note:  The following part of the command is an option.  Options are separated 
  2084.        from the last parameter with one space and one additional space between 
  2085.        each option.  In the examples for this command, ASCII is the option. 
  2086.  
  2087.           Specifies the period of time that the file transfer program waits for 
  2088.           the host computer to respond before canceling the file transfer 
  2089.           request.  nn is a 2-digit integer in a range from 00 through 99 that 
  2090.           indicates the number of 30-second increments the file transfer 
  2091.           program waits for the host computer to respond.  If nn is not 
  2092.           specified, 00 is the default, which means the file transfer program 
  2093.           waits indefinitely for the host computer to respond. 
  2094.  
  2095.           The file transfer program sends a message to the screen every 30 
  2096.           seconds until the host computer responds. 
  2097.  
  2098.  
  2099. ΓòÉΓòÉΓòÉ <hidden> CRLF ΓòÉΓòÉΓòÉ
  2100.  
  2101. Note:  The following part of the command is an option.  Options are separated 
  2102.        from the last parameter with one space and one additional space between 
  2103.        each option.  In the examples for this command, ASCII is the option. 
  2104.  
  2105.           Causes the host program to insert carriage returns and line feed 
  2106.           characters as the last 2 characters of each line before sending the 
  2107.           data set to the workstation. 
  2108.  
  2109.  
  2110. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  2111.  
  2112. You can type the RECEIVE command in a command file and run that file from the 
  2113. OS/2 command line. 
  2114.  
  2115. You can transfer more than one file at a time, as long as each file transfer is 
  2116. on a different emulation session and is initiated from a different OS/2 
  2117. session.  The maximum number of concurrent file transfers is nine. 
  2118.  
  2119. To issue multiple file transfers, specify a different emulation session for 
  2120. each file transfer with the ID in the file transfer command.  The emulation 
  2121. session that corresponds to the ID that you specify must be started and you 
  2122. must be logged on and ready to receive a command. 
  2123.  
  2124. The MIGR and SUB options cannot be specified together.  If both are specified, 
  2125. an error is displayed stating that the second option is not valid. 
  2126.  
  2127. If an error occurs during an attempted file transfer, the RECEIVE command sets 
  2128. the system environment variable ERRORLEVEL to a value equal to the returned 
  2129. TRANS code minus three.  Refer to Message Reference for descriptions of the 
  2130. TRANS codes. 
  2131.  
  2132. If your host file transfer program name is not IND$FILE, use the OS/2 SET 
  2133. command before issuing the file transfer command.  To use the SET command, type 
  2134. the following and press Enter: 
  2135.  
  2136. SET IND_FILE=xxxxxxxx
  2137. where xxxxxxxx is your host file transfer name. You should use the OS/2 SET 
  2138. command in the CONFIG.SYS file to avoid typing the SET command each time. 
  2139.  
  2140.  
  2141. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  2142.  
  2143. The following are examples of RECEIVE usage: 
  2144.  
  2145.           o To receive a file with an FAT file name from an IBM TSO host 
  2146.             computer, type the RECEIVE command with the necessary parameters at 
  2147.             an OS/2 command line and press Enter.  For example: 
  2148.  
  2149.                              receive a:myfile.txt stat2:boss(bossname)/gky5hf ASCII
  2150.  
  2151.           o To receive a file with an HPFS file name from an IBM TSO host 
  2152.             computer, type the RECEIVE command with the necessary parameters at 
  2153.             an OS/2 command line and press Enter.  For example: 
  2154.  
  2155.                              receive a:\firstdir\seconddir\"long filename"
  2156.                                   stat2:boss(bossname)/gky5hf ASCII
  2157.  
  2158.             Note the use of quotation marks when specifying a filename 
  2159.             containing blanks. 
  2160.  
  2161.  
  2162. ΓòÉΓòÉΓòÉ 2.6. SEND-for TSO Host ΓòÉΓòÉΓòÉ
  2163.  
  2164. SEND-for TSO Host 
  2165.  
  2166.  Purpose 
  2167.  
  2168.           Sends a file to an IBM TSO host computer. 
  2169.  
  2170.  Syntax 
  2171.  
  2172.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇSENDΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilenameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇ>
  2173.                       ΓööΓöÇdrive1ΓöÇΓöÿ  ΓööΓöÇpath1ΓöÇΓöÿ     ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ       ΓööΓöÇ.extΓöÇΓöÿ
  2174.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇdatasetnameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  2175.                       ΓööΓöÇid:ΓöÇΓöÿ        ΓööΓöÇ(membername)ΓöÇΓöÿ  ΓööΓöÇ/passwordΓöÇΓöÿ
  2176.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  2177.                       Γöé ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  2178.                       Γöé                    Γöé Γöé
  2179.                       ΓööΓöÇΓöÇΓö¼ΓöÇAPPENDΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  2180.                        Γöé     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ       Γöé
  2181.                        Γöé            Γöé       Γöé
  2182.                        Γö£ΓöÇASCIIΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöñ
  2183.                        Γöé     Γö£ΓöÇH(nnnnn)ΓöÇΓöñ  Γö£ΓöÇMIGRΓöÇΓöñ  Γöé
  2184.                        Γöé     ΓööΓöÇP(nnnnn)ΓöÇΓöÿ  ΓööΓöÇSUBΓöÇΓöÇΓöÿ  Γöé
  2185.                        Γö£ΓöÇCRLFΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2186.                        Γö£ΓöÇBLKSIZE (n)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2187.                        Γö£ΓöÇLRECL (n)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2188.                        Γö£ΓöÇRECFMΓöÇΓöÇΓö¼ΓöÇ(F)ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2189.                        Γöé     Γö£ΓöÇ(U)ΓöÇΓöñ           Γöé
  2190.                        Γöé     ΓööΓöÇ(V)ΓöÇΓöÿ           Γöé
  2191.                        Γö£ΓöÇSPACE(qΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇ)ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöñ
  2192.                        Γöé     ΓööΓöÇ,iΓöÇΓöÿ  Γö£ΓöÇAVBLOCK (n)ΓöÇΓöñ  Γöé
  2193.                        Γöé          Γö£ΓöÇCYLINDERSΓöÇΓöÇΓöÇΓöñ  Γöé
  2194.                        Γöé          ΓööΓöÇTRACKSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ  Γöé
  2195.                        ΓööΓöÇT(nn)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2196.  
  2197.  
  2198. ΓòÉΓòÉΓòÉ <hidden> drive1 ΓòÉΓòÉΓòÉ
  2199.  
  2200. The drive where the SEND.EXE file resides.  Specify this drive only if it is 
  2201. not the default drive. 
  2202.  
  2203.  
  2204. ΓòÉΓòÉΓòÉ <hidden> path1 ΓòÉΓòÉΓòÉ
  2205.  
  2206. The path designator that specifies where the SEND.EXE file resides. Use this 
  2207. path only if the file is not in the default path. 
  2208.  
  2209.  
  2210. ΓòÉΓòÉΓòÉ <hidden> drive2 ΓòÉΓòÉΓòÉ
  2211.  
  2212. The drive where the workstation file that you want to send to the host computer 
  2213. resides.  Specify this drive only if it is not the default drive.  In the 
  2214. examples for this command, a: is the drive. 
  2215.  
  2216.  
  2217. ΓòÉΓòÉΓòÉ <hidden> path2 ΓòÉΓòÉΓòÉ
  2218.  
  2219. The path designator that specifies where the workstation file that you want to 
  2220. send resides.  Use this path only if the file is not in the current directory. 
  2221.  
  2222.  
  2223. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  2224.  
  2225. The name of the workstation file that you want to send. Use the FAT or HPFS 
  2226. naming conventions described in OS/2 Technical Library. In the examples for 
  2227. this command, myfile is the file name for the FAT file system; "long filename" 
  2228. is the file name for the HPFS. 
  2229.  
  2230.  
  2231. ΓòÉΓòÉΓòÉ <hidden> .ext ΓòÉΓòÉΓòÉ
  2232.  
  2233. The extension of the workstation FAT file that you want to send.  You are 
  2234. allowed 4 characters for the extension, including the period.  In the examples 
  2235. for this command, .txt is the extension. 
  2236.  
  2237.  
  2238. ΓòÉΓòÉΓòÉ <hidden> id: ΓòÉΓòÉΓòÉ
  2239.  
  2240. The 1- to 8-character name that identifies the 3270 emulation session used for 
  2241. the file transfer.  If you do not supply this parameter, the first configured 
  2242. 3270 emulation session that you start is used for the file transfer. 
  2243.  
  2244. You can view the identifiers in the configuration file and from the File 
  2245. Transfer Main Menu. 
  2246.  
  2247. In the examples for this command, stat2 is the ID parameter. This parameter is 
  2248. separated from the data set name by a colon (:). 
  2249.  
  2250.  
  2251. ΓòÉΓòÉΓòÉ <hidden> datasetname ΓòÉΓòÉΓòÉ
  2252.  
  2253. The TSO data set name for the file that you are sending.  To show that the user 
  2254. ID does not have a prefix, you can type the data set name and member name 
  2255. together and enclose the information in quotation marks.  In the examples for 
  2256. this command, boss is the data set name. 
  2257.  
  2258.  
  2259. ΓòÉΓòÉΓòÉ <hidden> (membername) ΓòÉΓòÉΓòÉ
  2260.  
  2261. The name of a member of a partitioned data set. The data set must already 
  2262. exist.  In the examples for this command, bossname is the member name.  Note 
  2263. that the member name is enclosed in parentheses (). 
  2264.  
  2265.  
  2266. ΓòÉΓòÉΓòÉ <hidden> /password ΓòÉΓòÉΓòÉ
  2267.  
  2268. The password that allows access to password-protected TSO data sets. This 
  2269. parameter is required only if the data set is password-protected. In the 
  2270. examples for this command, gky5hf is the password. Note that the password is 
  2271. preceded by a slash (/). 
  2272.  
  2273.  
  2274. ΓòÉΓòÉΓòÉ <hidden> APPEND ΓòÉΓòÉΓòÉ
  2275.  
  2276. Note:  The following part of the command is an option. Options are separated 
  2277.        from the last parameter with one space and one additional space between 
  2278.        each option. In the examples for this command, ASCII is the option. 
  2279.  
  2280.           Allows you to attach the workstation file to the end of an existing 
  2281.           host data set.  The APPEND option overrides any other values 
  2282.           specified for LRECL and RECFM. 
  2283.  
  2284.           You may not specify APPEND for members of a partitioned data set. 
  2285.  
  2286.           Warning: If APPEND is not specified and a host computer file already 
  2287.           exists with the same name, the host computer file is replaced. 
  2288.  
  2289.  
  2290. ΓòÉΓòÉΓòÉ <hidden> ASCII ΓòÉΓòÉΓòÉ
  2291.  
  2292. Note:  The following part of the command is an option. Options are separated 
  2293.        from the last parameter with one space and one additional space between 
  2294.        each option. In the examples for this command, ASCII is the option. 
  2295.  
  2296.           Causes the host program to translate workstation files from ASCII to 
  2297.           EBCDIC so that the file is readable to the host computer.  When 
  2298.           sending text files to the host computer, always specify the ASCII 
  2299.           option.  If the workstation file is already in EBCDIC form, do not 
  2300.           supply this option. 
  2301.  
  2302.  
  2303. ΓòÉΓòÉΓòÉ <hidden> H(nnnnn) ΓòÉΓòÉΓòÉ
  2304.  
  2305. Note:  The following part of the command is an option. Options are separated 
  2306.        from the last parameter with one space and one additional space between 
  2307.        each option. In the examples for this command, ASCII is the option. 
  2308.  
  2309.           Specifies the host file code page you are using for the host file 
  2310.           being received, where nnnnn is the code page number. Refer to OS/2 
  2311.           Keyboard and Code Pages for information on code pages. If you do not 
  2312.           specify a code page, the system uses the code page for the host 
  2313.           character set of the emulation that is specified in the keyboard 
  2314.           remap profile. 
  2315.  
  2316.           The host code page also specifies the file transfer command program 
  2317.           you are using. 
  2318.  
  2319.           This option is valid only when the ASCII keyword is specified. 
  2320.  
  2321.  
  2322. ΓòÉΓòÉΓòÉ <hidden> P(nnnnn) ΓòÉΓòÉΓòÉ
  2323.  
  2324. Note:  The following part of the command is an option. Options are separated 
  2325.        from the last parameter with one space and one additional space between 
  2326.        each option. In the examples for this command, ASCII is the option. 
  2327.  
  2328.           Specifies the workstation file code page you are using for the 
  2329.           workstation file being sent, where nnnnn is the code page number. 
  2330.           Refer to OS/2 Keyboard and Code Pages for information on code pages. 
  2331.           If you do not specify a code page, the system uses the code page for 
  2332.           the active command line screen group. 
  2333.  
  2334.           This option is valid only when the ASCII keyword is specified. 
  2335.  
  2336.  
  2337. ΓòÉΓòÉΓòÉ <hidden> MIGR ΓòÉΓòÉΓòÉ
  2338.  
  2339. Note:  The following part of the command is an option. Options are separated 
  2340.        from the last parameter with one space and one additional space between 
  2341.        each option. In the examples for this command, ASCII is the option. 
  2342.  
  2343.           Allows you to send or receive files that were transferred using 
  2344.           Extended Edition 1.30.1 or Extended Services and Communications 
  2345.           Manager/2 Version 1.0. This option applies only to files that were 
  2346.           transferred in one direction using the ASCII option.  Use this option 
  2347.           to transfer the file back to the source location. 
  2348.  
  2349.           This option is valid only if the ASCII option is also specified.  If 
  2350.           MIGR is specified but the ASCII option is not, MIGR is ignored. 
  2351.  
  2352.  
  2353. ΓòÉΓòÉΓòÉ <hidden> SUB ΓòÉΓòÉΓòÉ
  2354.  
  2355. Note:  The following part of the command is an option. Options are separated 
  2356.        from the last parameter with one space and one additional space between 
  2357.        each option. In the examples for this command, ASCII is the option. 
  2358.  
  2359.           Specifies multiple-substitute mapping for the file transfer.  All 
  2360.           unmatched code points are mapped to a specific set of characters in 
  2361.           the target code page to enhance comprehension.  With 
  2362.           multiple-substitute mapping, a file transferred to a host computer 
  2363.           and transferred back to the workstation is not identical to the 
  2364.           original file.  Code points that do not have a match in the target 
  2365.           code page are different. 
  2366.  
  2367.           If SUB is not specified, the file transfer function uses one-to-one 
  2368.           character mapping.  One-to-one character mapping maps each unmatched 
  2369.           code point to a unique character in the target code page.  With 
  2370.           one-to-one character mapping, a file transferred to a specific host 
  2371.           computer and transferred back to the workstation is identical to the 
  2372.           original file. 
  2373.  
  2374.           This option is valid only when the ASCII option is specified. If SUB 
  2375.           is specified but the ASCII option is not, SUB is ignored. 
  2376.  
  2377.  
  2378. ΓòÉΓòÉΓòÉ <hidden> CRLF ΓòÉΓòÉΓòÉ
  2379.  
  2380. Note:  The following part of the command is an option. Options are separated 
  2381.        from the last parameter with one space and one additional space between 
  2382.        each option. In the examples for this command, ASCII is the option. 
  2383.  
  2384.           Causes the host program to delete carriage-return and line-feed 
  2385.           characters from the workstation data before storing it in the host 
  2386.           computer.  When sending an ASCII or EBCDIC file to the host computer, 
  2387.           you should always supply the CRLF option so the file is readable when 
  2388.           on the host computer. 
  2389.  
  2390.  
  2391. ΓòÉΓòÉΓòÉ <hidden> BLKSIZE(n) ΓòÉΓòÉΓòÉ
  2392.  
  2393. Specifies the size of the host data set, where n is the length in bytes of a 
  2394. data block.  If you omit BLKSIZE, the host default is used.  The host default 
  2395. is usually LRECL for new files.  If you are replacing or appending to a file, 
  2396. BLKSIZE is ignored. 
  2397.  
  2398.  
  2399. ΓòÉΓòÉΓòÉ <hidden> LRECL(n) ΓòÉΓòÉΓòÉ
  2400.  
  2401. Note:  The following part of the command is an option. Options are separated 
  2402.        from the last parameter with one space and one additional space between 
  2403.        each option. In the examples for this command, ASCII is the option. 
  2404.  
  2405.           Provides the logical record length of the host data set, where n is 
  2406.           the number of characters in each record.  If LRECL is omitted, the 
  2407.           host defaults are used.  The host default value for new files is 
  2408.           usually 80 characters for new data sets.  If you are replacing an 
  2409.           existing data set, its record length is used as the record length of 
  2410.           the new version.  If you are appending a data set, the current record 
  2411.           length of the data set is used and the LRECL value specified is 
  2412.           ignored. When using variable-length records, set n to the maximum 
  2413.           record size that the host computer can accept.  The program 
  2414.           automatically resets the logical record length equal to the longest 
  2415.           record actually sent. 
  2416.  
  2417.  
  2418. ΓòÉΓòÉΓòÉ <hidden> RECFM F/V/U ΓòÉΓòÉΓòÉ
  2419.  
  2420. Note:  The following part of the command is an option. Options are separated 
  2421.        from the last parameter with one space and one additional space between 
  2422.        each option. In the examples for this command, ASCII is the option. 
  2423.  
  2424.           Specifies the record format and characteristics of the host computer 
  2425.           file. RECFM is followed by one of the following characters: 
  2426.  
  2427.           o F  specifies that the file contains fixed-length records. 
  2428.           o V  specifies that the file contains variable-length records. 
  2429.           o U  specifies that the data set contains undefined-length records. 
  2430.  
  2431.           For new files, the default is F, unless the CRLF option is specified, 
  2432.           in which case V is the default. 
  2433.  
  2434.  
  2435. ΓòÉΓòÉΓòÉ <hidden> SPACE(q[,i]) ΓòÉΓòÉΓòÉ
  2436.  
  2437. Note:  The following part of the command is an option. Options are separated 
  2438.        from the last parameter with one space and one additional space between 
  2439.        each option. In the examples for this command, ASCII is the option. 
  2440.  
  2441.           Specifies the amount of space allocated for a new data set, where q 
  2442.           (mandatory) is the quantity of space allocated initially for a data 
  2443.           set and i (optional) is the increment of space added to the data set 
  2444.           each time the previously allocated space is filled. 
  2445.  
  2446.           If you use SPACE, you can use one of these three options to specify 
  2447.           the units used for quantity and increment: 
  2448.  
  2449.           o AVBLOCK(n) specifies the average block length of the records to be 
  2450.             written to the data set, where n is the desired average block 
  2451.             length in bytes. 
  2452.  
  2453.           o TRACKS specifies that the unit of space is a track. 
  2454.  
  2455.           o CYLINDERS specifies that the unit of space is a cylinder. 
  2456.  
  2457.  
  2458. ΓòÉΓòÉΓòÉ <hidden> T(nn) ΓòÉΓòÉΓòÉ
  2459.  
  2460. Note:  The following part of the command is an option. Options are separated 
  2461.        from the last parameter with one space and one additional space between 
  2462.        each option. In the examples for this command, ASCII is the option. 
  2463.  
  2464.           Specifies the period of time that the file transfer program waits for 
  2465.           the host computer to respond before canceling the file transfer 
  2466.           request.  nn is a 2-digit integer in a range from 00 through 99 that 
  2467.           indicates the number of 30-second increments the file transfer 
  2468.           program waits for the host computer to respond.  If nn is not 
  2469.           specified, 00 is the default, which means the file transfer program 
  2470.           waits indefinitely for the host computer to respond. 
  2471.  
  2472.           The file transfer program sends a message to the screen every 30 
  2473.           seconds until the host computer responds. 
  2474.  
  2475.  
  2476. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  2477.  
  2478. You can type the SEND command in a command file and run that file from the OS/2 
  2479. command prompt. 
  2480.  
  2481. You can transfer more than one file at a time, as long as each file transfer is 
  2482. on a different emulation session and is initiated from a different OS/2 
  2483. session.  The maximum number of concurrent file transfers is nine. 
  2484.  
  2485. To issue multiple file transfers, specify a different emulation session for 
  2486. each file transfer with the ID in the file transfer command.  The emulation 
  2487. session that corresponds to the ID that you specify must be started, and you 
  2488. must be logged on and ready to receive a command. 
  2489.  
  2490. The options AVBLOCK, CYLINDERS, TRACKS, BLKSIZE, RECFM, and SPACE are valid 
  2491. only for physical sequential data sets. 
  2492.  
  2493. The options AVBLOCK, CYLINDERS, and TRACKS are mutually exclusive. 
  2494.  
  2495. If neither AVBLOCK, CYLINDERS, nor TRACKS is specified, the value specified for 
  2496. BLKSIZE is used as the space allocation unit. 
  2497.  
  2498. The MIGR and SUB options cannot be specified together.  If both are specified, 
  2499. an error is displayed stating that the second option is not valid. 
  2500.  
  2501. If an error occurs during an attempted file transfer, the SEND command sets the 
  2502. system environment variable ERRORLEVEL to a value equal to the returned TRANS 
  2503. code minus three.  Refer to Message Reference for descriptions of the TRANS 
  2504. codes. 
  2505.  
  2506. If your host file transfer program name is not IND$FILE, use the OS/2 SET 
  2507. command before issuing the file transfer command.  To use the SET command, type 
  2508. the following and press Enter: 
  2509.  
  2510. SET IND_FILE=xxxxxxxx 
  2511.  
  2512. where xxxxxxxx is your host file transfer name. You should use the OS/2 SET 
  2513. command in the CONFIG.SYS file to avoid typing the SET command each time. 
  2514.  
  2515.  
  2516. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  2517.  
  2518. The following are examples of SEND usage: 
  2519.  
  2520.           o To send a file with an FAT file name to an IBM TSO host computer, 
  2521.             type the SEND command with the necessary parameters at an OS/2 
  2522.             command prompt and press Enter.  For example: 
  2523.  
  2524.                              send a:myfile.txt stat2:boss(bossname)/gky5hf ASCII
  2525.  
  2526.           o To send a file with an HPFS file name to an IBM TSO host computer, 
  2527.             type the SEND command with the necessary parameters at an OS/2 
  2528.             command prompt and press Enter.  For example: 
  2529.  
  2530.                              send a:\firstdir\seconddir\"long filename"
  2531.                                   stat2:boss(bossname)/gky5hf ASCII
  2532.  
  2533.             Note the use of quotation marks when specifying a filename 
  2534.             containing blanks. 
  2535.  
  2536.  
  2537. ΓòÉΓòÉΓòÉ 2.7. RECEIVE-for VM Host ΓòÉΓòÉΓòÉ
  2538.  
  2539. RECEIVE-for VM Host 
  2540.  
  2541.  Purpose 
  2542.  
  2543.           Receives a file from an IBM VM host computer. 
  2544.  
  2545.  Syntax 
  2546.  
  2547.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇRECEIVEΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename1ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  2548.                       ΓööΓöÇdrive1ΓöÇΓöÿ  ΓööΓöÇpath1ΓöÇΓöÿ      ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ
  2549.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename2ΓöÇΓöÇfiletypeΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  2550.                       ΓööΓöÇ.extΓöÇΓöÿ  ΓööΓöÇid:ΓöÇΓöÿ            ΓööΓöÇfilemodeΓöÇΓöÿ
  2551.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  2552.                       Γöé   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  2553.                       Γöé                     Γöé Γöé
  2554.                       ΓööΓöÇ(ΓöÇΓöÇΓöÇΓö¼ΓöÇAPPENDΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  2555.                          Γöé     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ      Γöé
  2556.                          Γöé            Γöé      Γöé
  2557.                          Γö£ΓöÇASCIIΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöñ
  2558.                          Γöé     Γö£ΓöÇH(nnnnn)ΓöÇΓöñ  Γö£ΓöÇMIGRΓöÇΓöñ Γöé
  2559.                          Γöé     ΓööΓöÇP(nnnnn)ΓöÇΓöÿ  ΓööΓöÇSUBΓöÇΓöÇΓöÿ Γöé
  2560.                          Γö£ΓöÇCRLFΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2561.                          ΓööΓöÇT(nn)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2562.  
  2563.  
  2564. ΓòÉΓòÉΓòÉ <hidden> drive1 ΓòÉΓòÉΓòÉ
  2565.  
  2566. The drive where the RECEIVE.EXE file resides.  Specify this drive only if it is 
  2567. not the default drive. 
  2568.  
  2569.  
  2570. ΓòÉΓòÉΓòÉ <hidden> path1 ΓòÉΓòÉΓòÉ
  2571.  
  2572. The path designator that specifies where the RECEIVE.EXE file resides. Use this 
  2573. path only if the file is not in the default path. 
  2574.  
  2575.  
  2576. ΓòÉΓòÉΓòÉ <hidden> drive2 ΓòÉΓòÉΓòÉ
  2577.  
  2578. The drive where you want the file that you are receiving from the host computer 
  2579. to reside.  Specify this drive only if it is not the default drive.  In the 
  2580. examples for this command, a: is the drive. 
  2581.  
  2582.  
  2583. ΓòÉΓòÉΓòÉ <hidden> path2 ΓòÉΓòÉΓòÉ
  2584.  
  2585. The path designator that specifies where the file being received is to reside. 
  2586. Specify a path if the file is not to reside in the current directory. 
  2587.  
  2588.  
  2589. ΓòÉΓòÉΓòÉ <hidden> filename1 ΓòÉΓòÉΓòÉ
  2590.  
  2591. The name of the workstation file that is to receive the host computer data. 
  2592. Use the FAT or HPFS naming conventions described in OS/2 Technical Library. In 
  2593. the examples for this command, report is the file name for the FAT file system; 
  2594. "long filename" is the filename for HPFS. 
  2595.  
  2596.  
  2597. ΓòÉΓòÉΓòÉ <hidden> .ext ΓòÉΓòÉΓòÉ
  2598.  
  2599. For an FAT file, the extension for the workstation file that receives the data. 
  2600. In the examples for this command, .dat is the extension. 
  2601.  
  2602.  
  2603. ΓòÉΓòÉΓòÉ <hidden> id: ΓòÉΓòÉΓòÉ
  2604.  
  2605. The 1- to 8-character name that identifies the 3270 emulation session used for 
  2606. the file transfer.  If you do not supply this parameter, the first configured 
  2607. 3270 emulation session that you start is used for the file transfer. 
  2608.  
  2609. For 3270 emulation sessions, this parameter can be either a long session ID or 
  2610. a short session ID. 
  2611.  
  2612. You can view the identifiers in the configuration file and from the File 
  2613. Transfer Main Menu. 
  2614.  
  2615. In the examples for this command, stat2 is the ID. This parameter is separated 
  2616. from the file name by a colon (:). 
  2617.  
  2618.  
  2619. ΓòÉΓòÉΓòÉ <hidden> filename2 ΓòÉΓòÉΓòÉ
  2620.  
  2621. The VM file name of the file that you want to transfer. In the examples for 
  2622. this command, report is the file name on the VM system. 
  2623.  
  2624.  
  2625. ΓòÉΓòÉΓòÉ <hidden> filetype ΓòÉΓòÉΓòÉ
  2626.  
  2627. The VM file type of the file that you want to transfer. In the examples for 
  2628. this command, script is the file type. 
  2629.  
  2630. Warning: APPEND, ASCII, CRLF, MIGR, SUB, H(nnnnn), and P(nnnnn) are reserved 
  2631. keywords for transferring files. They should not be used as a VM file type.  If 
  2632. used as a VM file type, undesirable results can occur, including the possible 
  2633. destruction of host files. 
  2634.  
  2635.  
  2636. ΓòÉΓòÉΓòÉ <hidden> filemode ΓòÉΓòÉΓòÉ
  2637.  
  2638. The VM file mode of the file that you want to transfer.  This is an optional 
  2639. parameter.  If this parameter is omitted, the default is A1.  In the examples 
  2640. for this command, A is the file mode. 
  2641.  
  2642.  
  2643. ΓòÉΓòÉΓòÉ <hidden> APPEND ΓòÉΓòÉΓòÉ
  2644.  
  2645. Note:  The following part of the command is an option.  Options are separated 
  2646.        from the last parameter by a required left parenthesis with one space 
  2647.        between each option.  In the examples for this command, CRLF and ASCII 
  2648.        are the options. 
  2649.  
  2650.           Allows you to attach the information from the host computer file to 
  2651.           the end of an existing workstation file. 
  2652.  
  2653.           Warning: If APPEND is not specified and a workstation file already 
  2654.           exists with the same name, the file is replaced with the received 
  2655.           file. 
  2656.  
  2657.  
  2658. ΓòÉΓòÉΓòÉ <hidden> ASCII ΓòÉΓòÉΓòÉ
  2659.  
  2660. Note:  The following part of the command is an option.  Options are separated 
  2661.        from the last parameter by a required left parenthesis with one space 
  2662.        between each option.  In the examples for this command, CRLF and ASCII 
  2663.        are the options. 
  2664.  
  2665.           Causes the host program to translate the host computer file from 
  2666.           EBCDIC to ASCII so that the file is readable on the workstation. 
  2667.           When receiving text files from the host computer, specify the ASCII 
  2668.           option. If the host computer file is already in ASCII form, do not 
  2669.           supply this option. 
  2670.  
  2671.  
  2672. ΓòÉΓòÉΓòÉ <hidden> H(nnnnn) ΓòÉΓòÉΓòÉ
  2673.  
  2674. Note:  The following part of the command is an option.  Options are separated 
  2675.        from the last parameter by a required left parenthesis with one space 
  2676.        between each option.  In the examples for this command, CRLF and ASCII 
  2677.        are the options. 
  2678.  
  2679.           Specifies the host file code page you are using for the host file 
  2680.           being sent, where nnnnn is the code page number. Refer to OS/2 
  2681.           Keyboard and Code Pages for information on code pages. If you do not 
  2682.           specify a code page, the system uses the code page for the host 
  2683.           character set of the emulation that is specified in the keyboard 
  2684.           remap profile. 
  2685.  
  2686.           The host character set also specifies the file transfer command 
  2687.           program you are using. 
  2688.  
  2689.           This option is valid only when the ASCII option is specified. 
  2690.  
  2691.  
  2692. ΓòÉΓòÉΓòÉ <hidden> P(nnnnn) ΓòÉΓòÉΓòÉ
  2693.  
  2694. Note:  The following part of the command is an option.  Options are separated 
  2695.        from the last parameter by a required left parenthesis with one space 
  2696.        between each option.  In the examples for this command, CRLF and ASCII 
  2697.        are the options. 
  2698.  
  2699.           Specifies the workstation file code page you are using for the 
  2700.           workstation file received, where nnnnn is the code page number. Refer 
  2701.           to OS/2 Keyboard and Code Pages for information on code pages. If you 
  2702.           do not specify a code page, the system uses the code page for the 
  2703.           active command line screen group. 
  2704.  
  2705.           This option is valid only when the ASCII option is specified. 
  2706.  
  2707.  
  2708. ΓòÉΓòÉΓòÉ <hidden> MIGR ΓòÉΓòÉΓòÉ
  2709.  
  2710. Note:  The following part of the command is an option.  Options are separated 
  2711.        from the last parameter by a required left parenthesis with one space 
  2712.        between each option.  In the examples for this command, CRLF and ASCII 
  2713.        are the options. 
  2714.  
  2715.           Allows you to send or receive files that were transferred using 
  2716.           Extended Edition 1.30.1 or Extended Services and Communications 
  2717.           Manager/2 Version 1.0. This option applies only to files that were 
  2718.           transferred in one direction using the ASCII option.  Use this option 
  2719.           to transfer the file back to the source location. 
  2720.  
  2721.           This option is valid only if the ASCII option is also specified. If 
  2722.           MIGR is specified but the ASCII option is not, MIGR is ignored. 
  2723.  
  2724.  
  2725. ΓòÉΓòÉΓòÉ <hidden> SUB ΓòÉΓòÉΓòÉ
  2726.  
  2727. Note:  The following part of the command is an option.  Options are separated 
  2728.        from the last parameter by a required left parenthesis with one space 
  2729.        between each option.  In the examples for this command, CRLF and ASCII 
  2730.        are the options. 
  2731.  
  2732.           Specifies multiple-substitute mapping for the file transfer.  All 
  2733.           unmatched code points are mapped to a specific set of characters in 
  2734.           the target code page to enhance comprehension.  With 
  2735.           multiple-substitute mapping, a file transferred to a host computer 
  2736.           and transferred back to the workstation is not identical to the 
  2737.           original file.  Code points that do not have a match in the target 
  2738.           code page are different. 
  2739.  
  2740.           If SUB is not specified, the file transfer function uses one-to-one 
  2741.           character mapping.  One-to-one character mapping maps each unmatched 
  2742.           code point to a unique character in the target code page.  With 
  2743.           one-to-one character mapping, a file transferred to a specific host 
  2744.           computer and transferred back to the workstation is identical to the 
  2745.           original file. 
  2746.  
  2747.           This option is valid only when the ASCII option is specified.  If SUB 
  2748.           is specified but the ASCII option is not, SUB is ignored. 
  2749.  
  2750.  
  2751. ΓòÉΓòÉΓòÉ <hidden> CRLF ΓòÉΓòÉΓòÉ
  2752.  
  2753. Note:  The following part of the command is an option.  Options are separated 
  2754.        from the last parameter by a required left parenthesis with one space 
  2755.        between each option.  In the examples for this command, CRLF and ASCII 
  2756.        are the options. 
  2757.  
  2758.           Causes the host program to insert carriage-return and line-feed 
  2759.           characters as the last 2 characters of each line before sending it to 
  2760.           the workstation. 
  2761.  
  2762.  
  2763. ΓòÉΓòÉΓòÉ <hidden> T(nn) ΓòÉΓòÉΓòÉ
  2764.  
  2765. Note:  The following part of the command is an option.  Options are separated 
  2766.        from the last parameter by a required left parenthesis with one space 
  2767.        between each option.  In the examples for this command, CRLF and ASCII 
  2768.        are the options. 
  2769.  
  2770.           Specifies the period of time that the file transfer program waits for 
  2771.           the host computer to respond before canceling the file transfer 
  2772.           request.  nn is a 2-digit integer in a range from 00 through 99 that 
  2773.           indicates the number of 30-second increments the file transfer 
  2774.           program waits for the host computer to respond.  If nnis not 
  2775.           specified, 00 is the default, which means that the file transfer 
  2776.           program waits indefinitely for the host computer to respond. 
  2777.  
  2778.           The file transfer program sends a message to the screen every 30 
  2779.           seconds until the host computer responds. 
  2780.  
  2781.  
  2782. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  2783.  
  2784. You can type the RECEIVE command in a command file and run that file from the 
  2785. OS/2 command line. 
  2786.  
  2787. You can transfer more than one file at a time, as long as each file transfer is 
  2788. on a different emulation session and is initiated from a different OS/2 
  2789. session.  The maximum number of concurrent file transfers is nine. 
  2790.  
  2791. To issue multiple file transfers, specify a different emulation session for 
  2792. each file transfer with the ID in the file transfer command.  The emulation 
  2793. session that corresponds to the ID that you specify must be started, and you 
  2794. must be logged on and ready to receive a command. 
  2795.  
  2796. The MIGR and SUB options cannot be specified together.  If both are specified, 
  2797. an error is displayed stating that the second option is not valid. 
  2798.  
  2799. If an error occurs during an attempted file transfer, the RECEIVE command sets 
  2800. the system environment variable ERRORLEVEL to a value equal to the returned 
  2801. TRANS code minus three.  Refer to Message Reference for a list and description 
  2802. of the TRANS codes. 
  2803.  
  2804. If your host file transfer program name is not IND$FILE, use the OS/2 SET 
  2805. command before issuing the file transfer command.  To use the SET command, type 
  2806. the following and press Enter: 
  2807.  
  2808. SET IND_FILE=xxxxxxxx 
  2809.  
  2810. where xxxxxxxx is your host file transfer program name. You should use the OS/2 
  2811. SET command in the CONFIG.SYS file to avoid typing the SET command each time. 
  2812.  
  2813.  
  2814. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  2815.  
  2816. The following are examples of RECEIVE usage: 
  2817.  
  2818.           o To receive a file with an FAT file name from an IBM VM host 
  2819.             computer, type the RECEIVE command with the necessary parameters at 
  2820.             an OS/2 command line and press Enter.  For example: 
  2821.  
  2822.                              receive a:report.dat stat2:report script A (CRLF ASCII
  2823.  
  2824.           o To receive a file with an HPFS file name from an IBM VM host 
  2825.             computer, type the RECEIVE command with the necessary parameters at 
  2826.             an OS/2 command line and press Enter.  For example: 
  2827.  
  2828.                              receive a:\firstdir\seconddir\"long filename"
  2829.                                   stat2:report script A (CRLF ASCII
  2830.  
  2831.             Note the use of quotation marks when specifying a filename 
  2832.             containing blanks. 
  2833.  
  2834.  
  2835. ΓòÉΓòÉΓòÉ 2.8. SEND-for VM Host ΓòÉΓòÉΓòÉ
  2836.  
  2837. SEND-for VM Host 
  2838.  
  2839.  Purpose 
  2840.  
  2841.           Sends a file to an IBM VM host computer. 
  2842.  
  2843.  Syntax 
  2844.  
  2845.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇSENDΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename1ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇ>
  2846.                       ΓööΓöÇdrive1ΓöÇΓöÿ  ΓööΓöÇpath1ΓöÇΓöÿ     ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ       ΓööΓöÇ.extΓöÇΓöÿ
  2847.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilename2ΓöÇΓöÇfiletypeΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  2848.                       ΓööΓöÇid:ΓöÇΓöÿ            ΓööΓöÇfilemodeΓöÇΓöÿ
  2849.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  2850.                       Γöé   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  2851.                       Γöé                     Γöé Γöé
  2852.                       ΓööΓöÇ(ΓöÇΓöÇΓöÇΓö¼ΓöÇAPPENDΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  2853.                          Γöé     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ      Γöé
  2854.                          Γöé            Γöé      Γöé
  2855.                          Γö£ΓöÇASCIIΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöñ
  2856.                          Γöé     Γö£ΓöÇH(nnnnn)ΓöÇΓöñ  Γö£ΓöÇMIGRΓöÇΓöñ Γöé
  2857.                          Γöé     ΓööΓöÇP(nnnnn)ΓöÇΓöÿ  ΓööΓöÇSUBΓöÇΓöÇΓöÿ Γöé
  2858.                          Γö£ΓöÇCRLFΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2859.                          Γö£ΓöÇLRECL nΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2860.                          Γö£ΓöÇRECFMΓöÇΓöÇΓö¼ΓöÇFΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2861.                          Γöé     ΓööΓöÇVΓöÇΓöÿ           Γöé
  2862.                          ΓööΓöÇT(nn)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2863.  
  2864.  
  2865. ΓòÉΓòÉΓòÉ <hidden> drive1 ΓòÉΓòÉΓòÉ
  2866.  
  2867. The drive where the SEND.EXE file resides.  Specify this drive only if it is 
  2868. not the default drive. 
  2869.  
  2870.  
  2871. ΓòÉΓòÉΓòÉ <hidden> path1 ΓòÉΓòÉΓòÉ
  2872.  
  2873. The path designator that specifies where the SEND.EXE file resides. Use this 
  2874. path only if the file is not in the default path. 
  2875.  
  2876.  
  2877. ΓòÉΓòÉΓòÉ <hidden> drive2 ΓòÉΓòÉΓòÉ
  2878.  
  2879. The drive where the workstation file that you want to send to the host computer 
  2880. resides.  Specify this drive only if it is not the default drive.  In the 
  2881. examples for this command, a: is the drive. 
  2882.  
  2883.  
  2884. ΓòÉΓòÉΓòÉ <hidden> path2 ΓòÉΓòÉΓòÉ
  2885.  
  2886. The path designator that specifies where the workstation file that you want to 
  2887. send resides.  Use this path only if the file is not in the current directory. 
  2888.  
  2889.  
  2890. ΓòÉΓòÉΓòÉ <hidden> filename1 ΓòÉΓòÉΓòÉ
  2891.  
  2892. The name of the file that you want to send.  Use the File Allocation Table 
  2893. (FAT) or High Performance File System (HPFS) naming conventions described in 
  2894. OS/2 Technical Library. In the examples for this command, report is the file 
  2895. name for the FAT file system; "long filename" is the file name for the HPFS. 
  2896.  
  2897.  
  2898. ΓòÉΓòÉΓòÉ <hidden> .ext ΓòÉΓòÉΓòÉ
  2899.  
  2900. The extension for the FAT file that you want to send. In the examples for this 
  2901. command, .dat is the extension. 
  2902.  
  2903.  
  2904. ΓòÉΓòÉΓòÉ <hidden> id: ΓòÉΓòÉΓòÉ
  2905.  
  2906. The 1- to 8-character name that identifies the 3270 session used for the file 
  2907. transfer.  If you do not supply this parameter, the first configured 3270 
  2908. emulation session that you start is used for the file transfer. 
  2909.  
  2910. For 3270 emulation sessions, this parameter can be either a long session ID or 
  2911. a short session ID. 
  2912.  
  2913. You can view the identifiers in the configuration file and from the File 
  2914. Transfer Operations Menu.  This parameter is separated from the file name by a 
  2915. colon (:). 
  2916.  
  2917.  
  2918. ΓòÉΓòÉΓòÉ <hidden> filename2 ΓòÉΓòÉΓòÉ
  2919.  
  2920. The name of the file on VM into which you want to receive the data. In the 
  2921. examples for this command, report is the file name on the VM system. 
  2922.  
  2923.  
  2924. ΓòÉΓòÉΓòÉ <hidden> filetype ΓòÉΓòÉΓòÉ
  2925.  
  2926. The VM file type of the file that you want to transfer. In the examples for 
  2927. this command, script is the file type. 
  2928.  
  2929. Warning: APPEND, ASCII, CRLF, MIGR, SUB, H(nnnnn), and P(nnnnn) are reserved 
  2930. keywords for transferring files. They should not be used as a VM file type.  If 
  2931. used as a VM file type, undesirable results can occur, including the possible 
  2932. destruction of host files. 
  2933.  
  2934.  
  2935. ΓòÉΓòÉΓòÉ <hidden> filemode ΓòÉΓòÉΓòÉ
  2936.  
  2937. The VM file mode of the file that you want to transfer.  This is an optional 
  2938. parameter.  If this parameter is omitted, the default is A1.  In the examples 
  2939. for this command, A is the file mode. 
  2940.  
  2941.  
  2942. ΓòÉΓòÉΓòÉ <hidden> APPEND ΓòÉΓòÉΓòÉ
  2943.  
  2944. Note:  The following part of the command is an option.  Options are separated 
  2945.        from the last parameter by a required left parenthesis with one space 
  2946.        between each option.  In the examples for this command, CRLF and ASCII 
  2947.        are the options. 
  2948.  
  2949.           Allows you to attach the workstation file to the end of an existing 
  2950.           host computer file.  The APPEND option overrides any other values 
  2951.           specified for LRECL and RECFM. 
  2952.  
  2953.           Warning: If APPEND is not specified and a host computer file already 
  2954.           exists with the same name, the host computer file is replaced. 
  2955.  
  2956.  
  2957. ΓòÉΓòÉΓòÉ <hidden> ASCII ΓòÉΓòÉΓòÉ
  2958.  
  2959. Note:  The following part of the command is an option.  Options are separated 
  2960.        from the last parameter by a required left parenthesis with one space 
  2961.        between each option.  In the examples for this command, CRLF and ASCII 
  2962.        are the options. 
  2963.  
  2964.           Causes the host program to translate workstation files from ASCII to 
  2965.           EBCDIC so that the file is readable to the host computer.  When 
  2966.           sending text files to the host, specify the ASCII option.  If the 
  2967.           workstation file is already in EBCDIC form, do not supply this 
  2968.           option. Do not use this option when you are transferring a binary 
  2969.           file. 
  2970.  
  2971.  
  2972. ΓòÉΓòÉΓòÉ <hidden> H(nnnnn) ΓòÉΓòÉΓòÉ
  2973.  
  2974. Note:  The following part of the command is an option.  Options are separated 
  2975.        from the last parameter by a required left parenthesis with one space 
  2976.        between each option.  In the examples for this command, CRLF and ASCII 
  2977.        are the options. 
  2978.  
  2979.           Specifies the host file code page to be used for the host file being 
  2980.           received, where nnnnn is the code page number. Refer to OS/2 Keyboard 
  2981.           and Code Pages for information on code pages. If you do not specify a 
  2982.           code page, the system uses the code page for the host character set 
  2983.           of the emulation session that is specified in the keyboard remap 
  2984.           profile. 
  2985.  
  2986.           The host code page also specifies the file transfer command program 
  2987.           to be used. 
  2988.  
  2989.           This option is valid only when the ASCII option is specified. 
  2990.  
  2991.  
  2992. ΓòÉΓòÉΓòÉ <hidden> P(nnnnn) ΓòÉΓòÉΓòÉ
  2993.  
  2994. Note:  The following part of the command is an option.  Options are separated 
  2995.        from the last parameter by a required left parenthesis with one space 
  2996.        between each option.  In the examples for this command, CRLF and ASCII 
  2997.        are the options. 
  2998.  
  2999.           Specifies the workstation file code page to be used for the 
  3000.           workstation file being sent, where nnnnn is the code page number. 
  3001.           Refer to OS/2 Keyboard and Code Pages for information on code pages. 
  3002.           If you do not specify a code page, the system uses the active code 
  3003.           page for the command line screen group. 
  3004.  
  3005.           This option is valid only when the ASCII option is specified. 
  3006.  
  3007.  
  3008. ΓòÉΓòÉΓòÉ <hidden> MIGR ΓòÉΓòÉΓòÉ
  3009.  
  3010. Note:  The following part of the command is an option.  Options are separated 
  3011.        from the last parameter by a required left parenthesis with one space 
  3012.        between each option.  In the examples for this command, CRLF and ASCII 
  3013.        are the options. 
  3014.  
  3015.           Allows you to send or receive files that were transferred with 
  3016.           Extended Edition 1.30.1 or Extended Services and Communications 
  3017.           Manager/2 Version 1.0. This option applies only to files that were 
  3018.           transferred in one direction using the ASCII option.  Use this option 
  3019.           to transfer the file back to the source location. 
  3020.  
  3021.           This option is valid only if the ASCII option is also specified.  If 
  3022.           MIGR is specified but the ASCII option is not, MIGR is ignored. 
  3023.  
  3024.  
  3025. ΓòÉΓòÉΓòÉ <hidden> SUB ΓòÉΓòÉΓòÉ
  3026.  
  3027. Note:  The following part of the command is an option.  Options are separated 
  3028.        from the last parameter by a required left parenthesis with one space 
  3029.        between each option.  In the examples for this command, CRLF and ASCII 
  3030.        are the options. 
  3031.  
  3032.           Specifies multiple-substitute mapping for the file transfer.  All 
  3033.           unmatched code points are mapped to a specific set of characters in 
  3034.           the target code page to enhance comprehension.  With 
  3035.           multiple-substitute mapping, a file transferred to a host computer 
  3036.           and transferred back to the workstation is not identical to the 
  3037.           original file.  Code points that do not have a match in the target 
  3038.           code page are different. 
  3039.  
  3040.           If SUB is not specified, the file transfer function uses one-to-one 
  3041.           character mapping.  One-to-one character mapping maps each unmatched 
  3042.           code point to a unique character in the target code page.  With 
  3043.           one-to-one character mapping, a file transferred to a specific host 
  3044.           computer and transferred back to the workstation is identical to the 
  3045.           original file. 
  3046.  
  3047.           This option is valid only when the ASCII option is specified.  If SUB 
  3048.           is specified but the ASCII option is not, SUB is ignored. 
  3049.  
  3050.  
  3051. ΓòÉΓòÉΓòÉ <hidden> CRLF ΓòÉΓòÉΓòÉ
  3052.  
  3053. Note:  The following part of the command is an option.  Options are separated 
  3054.        from the last parameter by a required left parenthesis with one space 
  3055.        between each option.  In the examples for this command, CRLF and ASCII 
  3056.        are the options. 
  3057.  
  3058.           Causes the host program to delete carriage-return and line-feed 
  3059.           characters from the workstation data before storing it at the host 
  3060.           computer.  When sending an ASCII or EBCDIC file to the host computer, 
  3061.           you should supply the CRLF option so the file is readable on the host 
  3062.           computer. 
  3063.  
  3064.           Do not use this option when transferring a binary file. 
  3065.  
  3066.  
  3067. ΓòÉΓòÉΓòÉ <hidden> LRECL n ΓòÉΓòÉΓòÉ
  3068.  
  3069. Note:  The following part of the command is an option.  Options are separated 
  3070.        from the last parameter by a required left parenthesis with one space 
  3071.        between each option.  In the examples for this command, CRLF and ASCII 
  3072.        are the options. 
  3073.  
  3074.           Provides the logical record length of the host computer file, where n 
  3075.           is the number of characters in each record.  If LRECL is omitted, the 
  3076.           host defaults are used.  The host default value for new files is 
  3077.           usually 80.  If you are replacing an existing host computer file, its 
  3078.           record length is used as the record length of the new version.  If 
  3079.           you are appending a file, the current record length of the file is 
  3080.           used and the LRECL value specified is ignored.  When using 
  3081.           variable-length records, set n to the maximum record size that the 
  3082.           host computer can accept.  The program automatically resets the 
  3083.           logical record length to the length of the longest record actually 
  3084.           sent. Do not use this option when transferring a binary file. 
  3085.  
  3086.  
  3087. ΓòÉΓòÉΓòÉ <hidden> RECFM F/V ΓòÉΓòÉΓòÉ
  3088.  
  3089. Note:  The following part of the command is an option.  Options are separated 
  3090.        from the last parameter by a required left parenthesis with one space 
  3091.        between each option.  In the examples for this command, CRLF and ASCII 
  3092.        are the options. 
  3093.  
  3094.           Specifies the record format and characteristics of the host computer 
  3095.           file.  RECFM is followed by F or V: 
  3096.  
  3097.           o F  specifies that the file contains fixed-length records. 
  3098.           o V  specifies that the file contains variable-length records. 
  3099.           For new files, the default is F, unless the CRLF option is specified, 
  3100.           in which case V is the default. 
  3101.  
  3102.  
  3103. ΓòÉΓòÉΓòÉ <hidden> T(nn) ΓòÉΓòÉΓòÉ
  3104.  
  3105. Note:  The following part of the command is an option.  Options are separated 
  3106.        from the last parameter by a required left parenthesis with one space 
  3107.        between each option.  In the examples for this command, CRLF and ASCII 
  3108.        are the options. 
  3109.  
  3110.           Specifies the period of time that the file transfer program waits for 
  3111.           the host computer to respond before canceling the file transfer 
  3112.           request.  nn is a 2-digit integer in a range from 00 through 99 that 
  3113.           indicates the number of 30-second increments the file transfer 
  3114.           program waits for the host computer to respond.  If nn is not 
  3115.           specified, 00 is the default, which means the file transfer program 
  3116.           waits indefinitely for the host computer to respond. 
  3117.  
  3118.           The file transfer program sends a message to the screen every 30 
  3119.           seconds until the host computer responds. 
  3120.  
  3121.  
  3122. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3123.  
  3124. You can type the SEND command in a command file (.CMD) and run that file from 
  3125. the OS/2 command prompt. 
  3126.  
  3127. You can transfer more than one file at a time, as long as each file transfer is 
  3128. on a different emulation session and is initiated from a different OS/2 
  3129. session.  The maximum number of concurrent file transfers is nine. 
  3130.  
  3131. To issue multiple file transfers, specify a different emulation session for 
  3132. each file transfer with the ID in the file transfer command.  The emulation 
  3133. session that corresponds to the ID that you specify must be started, and you 
  3134. must be logged on and ready to receive a command. 
  3135.  
  3136. The MIGR and SUB options cannot be specified together.  If both are specified, 
  3137. an error is displayed stating that the second option is not valid. 
  3138.  
  3139. If an error occurs during an attempted file transfer, the SEND command sets the 
  3140. system environment variable ERRORLEVEL to a value equal to the returned TRANS 
  3141. code minus three.  Refer to Message Reference for descriptions of the TRANS 
  3142. codes. 
  3143.  
  3144. If your host file transfer program name is not IND$FILE, use the OS/2 SET 
  3145. command before issuing the file transfer command.  To use the SET command, type 
  3146. the following and press Enter: 
  3147.  
  3148. SET IND_FILE=xxxxxxxx 
  3149.  
  3150. where xxxxxxxx is your host file transfer program name. 
  3151.  
  3152. You should use the OS/2 SET command in the CONFIG.SYS file to avoid typing the 
  3153. SET command each time. 
  3154.  
  3155.  
  3156. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3157.  
  3158. The following are examples of SEND usage: 
  3159.  
  3160.           o To send an ASCII file with an FAT file name to an IBM VM host 
  3161.             computer, type the SEND command with the necessary parameters at an 
  3162.             OS/2 command prompt and press Enter.  For example: 
  3163.  
  3164.                              send a:report.dat stat2:report script A (CRLF ASCII
  3165.  
  3166.           o To send an ASCII file with an HPFS file name to an IBM VM host 
  3167.             computer, type the SEND command with the necessary parameters at an 
  3168.             OS/2 command prompt and press Enter.  For example: 
  3169.  
  3170.                              send a:\firstdir\seconddir\"long filename"
  3171.                                   stat2:report script A (CRLF ASCII
  3172.  
  3173.             Note the use of quotation marks when specifying a filename 
  3174.             containing blanks. 
  3175.  
  3176.  
  3177. ΓòÉΓòÉΓòÉ 3. Utilities ΓòÉΓòÉΓòÉ
  3178.  
  3179. This chapter describes Communications Manager utilities. Each command 
  3180. description includes the purpose of the command, a syntax diagram, a list of 
  3181. parameters, a discussion of options, remarks, and examples. 
  3182.  
  3183. In addition to using the Presentation Manager interface to perform 
  3184. Communications Manager functions, you can issue commands to start certain 
  3185. functions from the OS/2 command line. Unless otherwise specified, directions in 
  3186. this book assume you are invoking commands from the OS/2 command line. 
  3187.  
  3188. To view the list of utilities, press Ctrl+C to return to the Contents. Next, 
  3189. select the plus sign (+) or press the + key. 
  3190.  
  3191.  
  3192. ΓòÉΓòÉΓòÉ 3.1. APPNRST ΓòÉΓòÉΓòÉ
  3193.  
  3194. APPNRST 
  3195.  
  3196.  Purpose 
  3197.  
  3198.           Generates a detailed report of the binary configuration file (.CF2) 
  3199.           contents.  This command is also used to restore damaged or deleted 
  3200.           .NDF and .SEC files. 
  3201.  
  3202.  Syntax 
  3203.  
  3204.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇAPPNRSTΓöÇΓöÇfilenameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  3205.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ           ΓööΓöÇoutfileΓöÇΓöÿ  ΓööΓöÇ/rΓöÇΓöÇΓöÇΓöÿ
  3206.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3207.                       ΓööΓöÇ/cΓöÇΓöÇ filenameΓöÇΓöÿ  ΓööΓöÇ/wΓöÇΓöÇ(n)ΓöÇΓöÿ
  3208.  
  3209.  
  3210. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  3211.  
  3212. The drive where the APPNRST.EXE file resides.  Specify this drive only if it is 
  3213. not the default drive. 
  3214.  
  3215.  
  3216. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  3217.  
  3218. The path designator that specifies where the APPNRST.EXE file resides. Use this 
  3219. path only if the file is not in the default path. 
  3220.  
  3221.  
  3222. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  3223.  
  3224. Indicates the name of the binary configuration file (.CF2) to use for the 
  3225. report or restore operation.  A .CF2 file must exist to use the APPNRST 
  3226. command.  In the examples for this command, nodes is the file name. 
  3227.  
  3228.  
  3229. ΓòÉΓòÉΓòÉ <hidden> outfile ΓòÉΓòÉΓòÉ
  3230.  
  3231. Indicates the name of the output file to be generated, for example, a report 
  3232. file.  In the examples for this command, nodes.ndf is the output file name. 
  3233.  
  3234.  
  3235. ΓòÉΓòÉΓòÉ <hidden> /r ΓòÉΓòÉΓòÉ
  3236.  
  3237. Generates a report of the binary configuration file (.CF2).  If no output file 
  3238. is specified, creates a file with an .NDF extension.  This is not a true node 
  3239. definitions file in that it cannot be verified. 
  3240.  
  3241. When generating a report using this option, no security file is created. 
  3242.  
  3243.  
  3244. ΓòÉΓòÉΓòÉ <hidden> /c filename ΓòÉΓòÉΓòÉ
  3245.  
  3246. Specifies a control file other than APPNV.CTL. 
  3247.  
  3248.  
  3249. ΓòÉΓòÉΓòÉ <hidden> /w(n) ΓòÉΓòÉΓòÉ
  3250.  
  3251. Specifies the message level. The value n can be in the range of 0 to 3, where: 
  3252.  
  3253.           0  Disables all messages 
  3254.           1  Displays error messages 
  3255.           2  Displays error and warning messages 
  3256.           3  Displays all messages (including informational messages). 
  3257.  
  3258.  
  3259. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3260.  
  3261. After using APPNRST to restore a node definitions file, you can verify the 
  3262. restored .NDF file, create a new .CF2 file, and generate a new .SEC file using 
  3263. the CMVERIFY command. 
  3264.  
  3265.  
  3266. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3267.  
  3268. The following are examples of APPNRST usage: 
  3269.  
  3270.           o To generate a report file with the name nodes.ndf, type the 
  3271.             following and press Enter: 
  3272.  
  3273.                              APPNRST nodes.ndf /r
  3274.  
  3275.           o To restore the file nodes.NDF and create a security file nodes.SEC, 
  3276.             type the following and press Enter: 
  3277.  
  3278.                              APPNRST nodes
  3279.  
  3280.  
  3281. ΓòÉΓòÉΓòÉ 3.2. CMANSWER ΓòÉΓòÉΓòÉ
  3282.  
  3283. CMANSWER 
  3284.  
  3285.  Purpose 
  3286.  
  3287.           Enables you to receive an incoming call over a switched network for 
  3288.           the purpose of sending and receiving data. The protocols that are 
  3289.           supported once the connection has been established are LAN and SDLC. 
  3290.  
  3291.  Syntax 
  3292.  
  3293.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMANSWERΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  3294.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  3295.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3296.                       Γöé             ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  3297.                       Γöé                            Γöé Γöé
  3298.                       ΓööΓöÇ/CΓöÇΓöÇ[ALLNAME]:callnameΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  3299.                                    Γö£ΓöÇ/PΓöÇΓöÇ[ROTOCOL]:ΓöÇΓöÇΓö¼ΓöÇLANΓöÇΓöÇΓö¼ΓöÇΓöÇΓöñ
  3300.                                    Γöé         Γö£ΓöÇSDLCΓöÇΓöñ  Γöé
  3301.                                    Γöé         ΓööΓöÇIDLCΓöÇΓöÿ  Γöé
  3302.                                    Γöé         ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  3303.                                    Γöé             Γöé Γöé
  3304.                                    ΓööΓöÇ/AΓöÇΓöÇ[DAPTER]:nΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓö¼ΓöÇΓö┤ΓöÇΓöÿ
  3305.                                              ΓööΓöÇnΓöÇΓöÿ
  3306.  
  3307.           All CMANSWER parameters are optional. All parameters may be specified 
  3308.           using the first letter of the keyword. The CMANSWER window is 
  3309.           displayed if no parameters are specified. 
  3310.  
  3311.  
  3312. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  3313.  
  3314. The drive where the CMANSWER.EXE file resides.  Specify this drive only if it 
  3315. is not the default drive. 
  3316.  
  3317.  
  3318. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  3319.  
  3320. The path designator that specifies where the CMANSWER.EXE file resides. Use 
  3321. this path only if the file is not in the default path. 
  3322.  
  3323.  
  3324. ΓòÉΓòÉΓòÉ <hidden> /CALLNAME: callname ΓòÉΓòÉΓòÉ
  3325.  
  3326. An existing incoming Directory Entry Name or permanent connection name which 
  3327. has been created during connection manager configuration. The maximum length of 
  3328. a Directory Entry Name is 16 characters. 
  3329.  
  3330. If a Directory Entry Name is supplied, the remainder of the optional parameters 
  3331. can be supplied by either: 
  3332.  
  3333.           o A Directory Entry Name that has parameters defined and saved by 
  3334.             connection manager configuration 
  3335.  
  3336.           o Using the Connection Manager Answer Utility Presentation Manager 
  3337.             window 
  3338.  
  3339.           o Supplying the parameters at connection manager start-up time 
  3340.  
  3341.  
  3342. ΓòÉΓòÉΓòÉ <hidden> /PROTOCOL ΓòÉΓòÉΓòÉ
  3343.  
  3344. A protocol that is used for the link.  Use LAN for NETBIOS or IEEE 802.2 
  3345. protocols. Valid values are LAN and SDLC. 
  3346.  
  3347.  
  3348. ΓòÉΓòÉΓòÉ <hidden> /ADAPTER: n ΓòÉΓòÉΓòÉ
  3349.  
  3350. The adapter numbers that are used for the link.  You must supply at least one 
  3351. adapter number.  Maximum number of adapter numbers are: 2 for SDLC and 12 for 
  3352. LAN. Valid numbers are 0 through 11. 
  3353.  
  3354.  
  3355. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3356.  
  3357. Parameters supplied at connection manager start-up override any preconfigured 
  3358. parameters. 
  3359.  
  3360. If connection manager is started with a valid Directory Entry Name and all of 
  3361. its associated parameters are defined, connection manager initiates the request 
  3362. without requiring any further action by the user. 
  3363.  
  3364. If you do not specify a protocol type and adapter number, the Connection 
  3365. Manager Answer Utility Presentation Manager window appears. 
  3366.  
  3367. You can specify more than one adapter number.  If the first number is busy, the 
  3368. dialing utility tries the next number. 
  3369.  
  3370.  
  3371. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3372.  
  3373. The following are examples of CMANSWER usage: 
  3374.  
  3375.           o To start the dialing utility and supply all parameters 
  3376.             interactively, type the following and press Enter: 
  3377.  
  3378.                              CMANSWER
  3379.  
  3380.           o To start the dialing utility and use the directory entry name of 
  3381.             "RemoteRequesters", type the following and press Enter: 
  3382.  
  3383.                              CMANSWER /CALLNAME:RemoteRequesters
  3384.  
  3385.             Note:  If you have already configured the protocol and adapter 
  3386.                    parameters for this directory entry name, this link is 
  3387.                    established immediately.  Otherwise, use the dialing utility 
  3388.                    to define the protocol and adapter for this link. 
  3389.  
  3390.           o To start the dialer and use the directory entry name of 
  3391.             "RemoteRequesters" with a LAN protocol for adapter 0, type the 
  3392.             following and press Enter: 
  3393.  
  3394.                              CMANSWER /CALLNAME:RemoteRequesters /PROTOCOL:LAN
  3395.                                   /ADAPTER:0
  3396.  
  3397.             Note:  If you have already configured the protocol and adapter 
  3398.                    parameters for this directory entry name, the parameters 
  3399.                    supplied here override the configured parameters. 
  3400.  
  3401.  
  3402. ΓòÉΓòÉΓòÉ 3.3. CMCALL ΓòÉΓòÉΓòÉ
  3403.  
  3404. CMCALL 
  3405.  
  3406.  Purpose 
  3407.  
  3408.           Enables you to establish an outgoing call over a switched network for 
  3409.           the purpose of sending and receiving data. The protocols that are 
  3410.           supported once the connection has been established are LAN and SDLC. 
  3411.  
  3412.  Syntax 
  3413.  
  3414.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMCALLΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  3415.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  3416.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3417.                       Γöé             ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γöé
  3418.                       Γöé                            Γöé Γöé
  3419.                       ΓööΓöÇ/CΓöÇΓöÇ[ALLNAME]:callnameΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼Γö┤ΓöÇΓöÿ
  3420.                                    Γö£ΓöÇ/PΓöÇΓöÇ[ROTOCOL]:ΓöÇΓöÇΓö¼ΓöÇLANΓöÇΓöÇΓö¼ΓöÇΓöñ
  3421.                                    Γöé         ΓööΓöÇSDLCΓöÇΓöÿ Γöé
  3422.                                    Γö£ΓöÇ/AΓöÇΓöÇ[DAPTER]:nΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3423.                                    ΓööΓöÇ/NΓöÇΓöÇ[UMBER]:phone numberΓöÇΓöÿ
  3424.  
  3425.           All CMCALL parameters are optional. All parameters may be specified 
  3426.           using the first letter of the keyword. The CMCALL window is displayed 
  3427.           if no parameters are specified. 
  3428.  
  3429.  
  3430. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  3431.  
  3432. The drive where the CMCALL.EXE file resides.  Specify this drive only if it is 
  3433. not the default drive. 
  3434.  
  3435.  
  3436. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  3437.  
  3438. The path designator that specifies where the CMCALL.EXE file resides. Use this 
  3439. path only if the file is not in the default path. 
  3440.  
  3441.  
  3442. ΓòÉΓòÉΓòÉ <hidden> /CALLNAME:callname ΓòÉΓòÉΓòÉ
  3443.  
  3444. An existing outgoing Directory Entry Name or permanent connection name which 
  3445. has been created during connection manager configuration. The maximum length of 
  3446. a Directory Entry Name is 16 characters. 
  3447.  
  3448. If a Directory Entry Name is supplied, the remainder of the optional parameters 
  3449. can be supplied by either: 
  3450.  
  3451.           o A Directory Entry Name that has parameters defined and saved by 
  3452.             connection manager configuration 
  3453.  
  3454.           o Using the Connection Manager Call Utility Presentation Manager 
  3455.             window 
  3456.  
  3457.           o Supplying the parameters at connection manager start-up time 
  3458.  
  3459.  
  3460. ΓòÉΓòÉΓòÉ <hidden> /PROTOCOL ΓòÉΓòÉΓòÉ
  3461.  
  3462. A protocol that is used for the link.  Use LAN for NETBIOS or IEEE 802.2 
  3463. protocols. Valid values are LAN and SDLC. 
  3464.  
  3465.  
  3466. ΓòÉΓòÉΓòÉ <hidden> /ADAPTER:n ΓòÉΓòÉΓòÉ
  3467.  
  3468. The adapter numbers that are used for the link.  You must supply at least one 
  3469. adapter number.  Maximum number of adapter numbers are: 2 for SDLC and 12 for 
  3470. LAN. Valid numbers are 0 through 11. 
  3471.  
  3472.  
  3473. ΓòÉΓòÉΓòÉ <hidden> /NUMBER:phone number ΓòÉΓòÉΓòÉ
  3474.  
  3475. A phone number in IA5 characters, according to the formats specified in the 
  3476. appropriate number/dialing plan in the connection manager configuration.  If 
  3477. you specify this parameter, this phone number is used to establish the call 
  3478. instead of the first phone number specified in the Outgoing Directory Entry. 
  3479. The length of the phone number must be less than or equal to 40 characters. 
  3480.  
  3481.  
  3482. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3483.  
  3484. When making an outgoing call using CMCALL, you must specify the logical adapter 
  3485. number used by the application. 
  3486.  
  3487. Parameters supplied at connection manager start-up override any preconfigured 
  3488. parameters. 
  3489.  
  3490. If connection manager is started with a valid Directory Entry Name and all of 
  3491. its associated parameters are defined, connection manager initiates the request 
  3492. without requiring any further action by the user. 
  3493.  
  3494. If you do not specify a protocol type and adapter number, the Connection 
  3495. Manager Call Utility Presentation Manager window appears. 
  3496.  
  3497. You can specify more than one adapter number.  If the first number is busy, the 
  3498. dialing utility tries the next number. 
  3499.  
  3500.  
  3501. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3502.  
  3503. The following are examples of CMCALL usage: 
  3504.  
  3505.           o To start the dialing utility and supply all parameters 
  3506.             interactively, type the following and press Enter: 
  3507.  
  3508.                              CMCALL
  3509.  
  3510.           o To start the dialing utility and use the directory entry name of 
  3511.             "DowJonesBBS", type the following and press Enter: 
  3512.  
  3513.                              CMCALL /CALLNAME:DowJonesBBS
  3514.  
  3515.             Note:  If you have already configured the protocol and adapter 
  3516.                    parameters for this directory entry name, this link is 
  3517.                    established immediately.  Otherwise, use the dialing utility 
  3518.                    to define the protocol and adapter for this link. 
  3519.  
  3520.           o To start the dialing utility and use the directory entry name of 
  3521.             "DowJonesBBS" with a LAN protocol for adapter 0 and dial the phone 
  3522.             number 555-2222 instead of the phone number defined in the 
  3523.             DowJonesBBS directory, type the following and press Enter: 
  3524.  
  3525.                              CMCALL /CALLNAME:DowJonesBBS /PROTOCOL:LAN /ADAPTER:0
  3526.                                   /NUMBER:555-2222
  3527.  
  3528.             Note:  If you have already configured the protocol and adapter 
  3529.                    parameters for this directory entry name, the parameters 
  3530.                    supplied here override the configured parameters. 
  3531.  
  3532.  
  3533. ΓòÉΓòÉΓòÉ 3.4. CMGWSESS ΓòÉΓòÉΓòÉ
  3534.  
  3535. CMGWSESS 
  3536.  
  3537.  Purpose 
  3538.  
  3539.           Displays session information about your workstation through a 
  3540.           gateway. 
  3541.  
  3542.  Syntax 
  3543.  
  3544.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMGWSESSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3545.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  3546.  
  3547.  
  3548. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  3549.  
  3550. The drive where the CMGWSESS.EXE file resides.  Specify this drive only if it 
  3551. is not the default drive. 
  3552.  
  3553.  
  3554. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  3555.  
  3556. The path designator that specifies where the CMGWSESS.EXE file resides. Use 
  3557. this path only if the file is not in the default path. 
  3558.  
  3559.  
  3560. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3561.  
  3562. The CMGWSESS command invokes CMGWSESS.EXE to display the sessions that are used 
  3563. on the gateway. 
  3564.  
  3565. The CMGWSESS command must work with the remote display server program 
  3566. (RDSPSRVR.EXE) to allow remote users to obtain significant information about a 
  3567. workstation. 
  3568.  
  3569. The "Communications Manager/2 API Support Diskette" contains the source code 
  3570. for this program     . CMGWSESS.C is contained in the zip file-SNA.ZIP which 
  3571. can be unzipped using PKUNZIP2. 
  3572.  
  3573. Note:  The "Communications Manager/2 API Support Diskette" is mentioned in this 
  3574. document. Please note that a CD-ROM that contains the complete Communications 
  3575. Manager product, including all information, is also available. 
  3576.  
  3577. Making RDSPSRVR.EXE operational:  Since this program does not have security 
  3578. capability, you must take one of the following steps to make RDSPSRVR.EXE 
  3579. operational before it can be called by a remote program: 
  3580.  
  3581.           o Copy RDSPSRVR.EXE to the directory specified by the 
  3582.             DIRECTORY_FOR_INBOUND_ATTACHES statement in your .NDF file. 
  3583.  
  3584.           o Add a DEFINE_TP statement for RDSPSRVR to your .NDF file. 
  3585.  
  3586.             The following is an example: 
  3587.  
  3588.  
  3589.                          DEFINE_TP TP_NAME(RDSPSRVR)
  3590.                               FILESPEC(C:\CMLIB\RDSPSRVR.EXE)
  3591.                               CONV_SECURITY_RQD(NO)
  3592.                               CONVERSATION_TYPE(MAPPED)
  3593.                               PROGRAM_TYPE(BACKGROUND)
  3594.                               RECEIVE_ALLOCATE_TIMEOUT(100)
  3595.                               SYNC_LEVEL(EITHER)
  3596.                               TP_OPERATION(NONQUEUED_AM_STARTED)
  3597.                               DESCRIPTION(Server TP supporting
  3598.                                     remote display);
  3599.  
  3600.             After adding the DEFINE_TP statement to your .NDF file, activate 
  3601.             RDSPSRVR by using the /E option of the CMVERIFY command. From the 
  3602.             OS/2 command line, enter CMVERIFY fn /E, where fn is the filename 
  3603.             of your .NDF file. 
  3604.  
  3605.  
  3606. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3607.  
  3608. The following is an example of CMGWSESS usage: 
  3609.  
  3610.           o To display the sessions between the gateway and the host related to 
  3611.             your workstation, type the following and press Enter: 
  3612.  
  3613.                              CMGWSESS
  3614.  
  3615.  
  3616. ΓòÉΓòÉΓòÉ 3.5. CMIMAGE ΓòÉΓòÉΓòÉ
  3617.  
  3618. CMIMAGE 
  3619.  
  3620.  Purpose 
  3621.  
  3622.           Allows the network administrator to copy the Communications Manager 
  3623.           diskette images onto a hard drive in a certain subdirectory. This 
  3624.           subdirectory may then be used as the source location for the CMSETUP 
  3625.           installation program. 
  3626.  
  3627.  Syntax 
  3628.  
  3629.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMIMAGEΓöÇΓöÇ[/uΓöÇΓöÇ]ΓöÇΓöÇsource_drive:ΓöÇΓöÇtarget_drive:ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  3630.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  3631.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3632.                       ΓööΓöÇ\path_nameΓöÇΓöÿ
  3633.  
  3634.  
  3635. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  3636.  
  3637. The drive where the CMIMAGE.EXE file resides.  Specify this drive only if it is 
  3638. not the default drive. 
  3639.  
  3640.  
  3641. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  3642.  
  3643. The path designator that specifies where the CMIMAGE.EXE file resides. Use this 
  3644. path only if the file is not in the default path. 
  3645.  
  3646.  
  3647. ΓòÉΓòÉΓòÉ <hidden> /U ΓòÉΓòÉΓòÉ
  3648.  
  3649. The /U option is used to create a code server for Workgroup Client Support. The 
  3650. /U option will unbundle the files and place them in a CMLIB subdirectory within 
  3651. the target path. If a target path is not given, CMIMAGE is the default target 
  3652. path. If the target directory already exists, a warning is issued and a 
  3653. confirmation is needed to continue. 
  3654.  
  3655.  
  3656. ΓòÉΓòÉΓòÉ <hidden> source_drive: ΓòÉΓòÉΓòÉ
  3657.  
  3658. Drive where the files that are to be copied reside. 
  3659.  
  3660.  
  3661. ΓòÉΓòÉΓòÉ <hidden> target_drive: ΓòÉΓòÉΓòÉ
  3662.  
  3663. Drive where the copied files will reside. 
  3664.  
  3665.  
  3666. ΓòÉΓòÉΓòÉ <hidden> /path_name ΓòÉΓòÉΓòÉ
  3667.  
  3668. Directory where the copied files will reside. 
  3669.  
  3670.  
  3671. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3672.  
  3673.           o CMIMAGE is located on Communications Manager diskette 1 in unpacked 
  3674.             format. 
  3675.  
  3676.           o The default path_name is \CMIMAGE. 
  3677.  
  3678.           o To remove the files created by CMIMAGE, type DEL *.* in the 
  3679.             directory that the files were copied to.  If the /U option was 
  3680.             specified, remove any subdirectories that were created. 
  3681.  
  3682.           o For more information on CMIMAGE, refer to IBM Communications 
  3683.             Manager/2 Version 1.0 Network Administration and Subsystem 
  3684.             Management Guide. 
  3685.  
  3686.  
  3687. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3688.  
  3689. The following are examples of CMIMAGE usage: 
  3690.  
  3691.           o To copy files from diskette drive A: to drive X: and place the 
  3692.             files in the \IBMAPPS\CM10 directory, type the following and press 
  3693.             Enter: 
  3694.  
  3695.                              CMIMAGE A: X:\IBMAPPS\CM10
  3696.  
  3697.           o To copy files from diskette drive B: to drive V: and place the 
  3698.             files in the default directory (\CMIMAGE), type the following and 
  3699.             press Enter: 
  3700.  
  3701.                              CMIMAGE B: V:
  3702.  
  3703.  
  3704. ΓòÉΓòÉΓòÉ 3.6. CMQUERY ΓòÉΓòÉΓòÉ
  3705.  
  3706. CMQUERY 
  3707.  
  3708.  Purpose 
  3709.  
  3710.           Allows you to query information about Communications Manager. 
  3711.  
  3712.  Syntax 
  3713.  
  3714.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMQUERYΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3715.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  3716.  
  3717.  
  3718. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  3719.  
  3720. The drive where the CMQUERY.EXE file resides.  Specify this drive only if it is 
  3721. not the default drive. 
  3722.  
  3723.  
  3724. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  3725.  
  3726. The path designator that specifies where the CMQUERY.EXE file resides. Use this 
  3727. path only if the file is not in the default path. 
  3728.  
  3729.  
  3730. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  3731.  
  3732. The following is an example of CMQUERY usage: 
  3733.  
  3734.           o To get information including the status of Communications Manager, 
  3735.             the default configuration, and the active configuration, type the 
  3736.             following and press Enter: 
  3737.  
  3738.                              CMQUERY
  3739.  
  3740.  
  3741. ΓòÉΓòÉΓòÉ 3.7. CMRECORD ΓòÉΓòÉΓòÉ
  3742.  
  3743. CMRECORD 
  3744.  
  3745.  Purpose 
  3746.  
  3747.           The CMRECORD utility generates a Communications Manager response file 
  3748.           from the default configuration and the installation parameters of the 
  3749.           machine on which it is run, or from any existing Communications 
  3750.           Manager configuration. CMRECORD ignores keylock, allowing you to 
  3751.           create a response file from a keylocked configuration. The response 
  3752.           file generated by CMRECORD is not complete to use with the CMSETUP /R 
  3753.           command. You must edit the response file to add the appropriate 
  3754.           update type (CMUpdateType) or additional control keyword entries. 
  3755.  
  3756.           Note:  The OS/2 command line limit of 255 characters applies to the 
  3757.                  CMRECORD command. 
  3758.  
  3759.  Syntax 
  3760.  
  3761.                     >>ΓöÇΓöÇCMRECORDΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇcfg_nameΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  3762.                            ΓööΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ/DΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ/O output.filΓöÇΓöÿ
  3763.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  3764.                       Γö£ΓöÇ/M model.filΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3765.                       Γöé     ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ              Γöé
  3766.                       Γöé         Γöé              Γöé
  3767.                       ΓööΓöÇ/K ΓöÇΓöÇΓöÇlistΓöÇΓö┤ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  3768.                                 ΓööΓöÇINSTALLΓöÇΓöÿ  ΓööΓöÇCONFIGΓöÇΓöÿ
  3769.  
  3770.           Note:  You must use a colon or a space to separate keywords from 
  3771.           their parameters. 
  3772.  
  3773.           For example, you might enter the following: 
  3774.  
  3775.                     CMRECORD MYFILE.CFG /O CONFIG1.RSP /M MYMODEL.FIL
  3776.           where MYFILE.CFG is the configuration you want to record, /O 
  3777.           CONFIG1.RSP is the name of the output file, and /M MYMODEL.FIL is the 
  3778.           name of the model response file. 
  3779.  
  3780.  
  3781. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  3782.  
  3783. Causes help text to be sent to STDOUT (usually the screen). If ? appears on the 
  3784. command line, it must be the first command line parameter. Help will also be 
  3785. displayed when an unrecognized keyword is encountered or when no parameters are 
  3786. specified. 
  3787.  
  3788.  
  3789. ΓòÉΓòÉΓòÉ <hidden> cfg_name ΓòÉΓòÉΓòÉ
  3790.  
  3791. Specifies the Communications Manager configuration to record. An extension of 
  3792. .CFG is assumed. 
  3793.  
  3794. A file with the name of the configuration and the extension .CFG must exist on 
  3795. the path specified, and it must be a valid Communications Manager configuration 
  3796. file. The .CF2, .NDF, and .SEC files that may be part of the configuration are 
  3797. assumed to be in the same directory. 
  3798.  
  3799.  
  3800. ΓòÉΓòÉΓòÉ <hidden> /D ΓòÉΓòÉΓòÉ
  3801.  
  3802. Records the workstation's default configuration, as specified in \CMLIB\CM.INI. 
  3803. If you specify this option, do not specify cfg_name. 
  3804.  
  3805.  
  3806. ΓòÉΓòÉΓòÉ <hidden> /O output.fil ΓòÉΓòÉΓòÉ
  3807.  
  3808. Optionally specifies a file for the output.  The default is a file with the 
  3809. configuration name and a .RSP extension. If the file already exists, it will be 
  3810. overwritten upon successful completion. The CMRECORD utility writes the 
  3811. keywords to the file in the following order:  install keywords, followed by 
  3812. .CFG file configuration keywords, followed by .CF2 file configuration keywords. 
  3813. Note that passwords will not be recorded. For the X.25 route records, the ORDER 
  3814. keyword is not recorded. Lines can be output longer than 255, since the input 
  3815. line length max is 384 characters. If the output file has lines longer than 
  3816. 255, some editors will split the line into multiple lines. These lines will 
  3817. have to be corrected before the response file can be used to update a 
  3818. workstation. 
  3819.  
  3820.  
  3821. ΓòÉΓòÉΓòÉ <hidden> Mutually ΓòÉΓòÉΓòÉ
  3822.  
  3823. exclusive parameters that limit the amount of information returned in the 
  3824. response file. 
  3825.  
  3826.           /M model.fil 
  3827.                     Specifies the model response file, model.fil. The path to 
  3828.                     the model response file can be specified, but is optional. 
  3829.                     This model file has the same format and syntax as a normal 
  3830.                     response file, but values (the data right of the `=' sign) 
  3831.                     may be present or absent. The recording program will read 
  3832.                     the model file and fill in the current setting for each 
  3833.                     keyword, writing the result to output.fil. If a keyword 
  3834.                     cannot be recorded because it was not specified in the 
  3835.                     configuration, a comment will be placed in the output file. 
  3836.                     The order of the output in the model response file might be 
  3837.                     different from the order of input. If the /M flag is 
  3838.                     specified, the /K flag is ignored. 
  3839.  
  3840.           There are several basic rules for model response files: 
  3841.  
  3842.           o If the model file only specifies a record keyword, all instances of 
  3843.             that record and all field keywords for the record are included in 
  3844.             the response file. In this example, 
  3845.  
  3846.                                x25_route= (
  3847.                                            )
  3848.             the resulting response file includes all instances of X.25 route 
  3849.             records and all field keywords within the record. 
  3850.  
  3851.           o If the model file specifies a record keyword and a name keyword 
  3852.             that identifies a record, all fields within the named record are 
  3853.             included in the response file. In the following example, 
  3854.  
  3855.                                x25_route= (
  3856.                                            name = xyz
  3857.                                            )
  3858.             the resulting response file includes all field keywords and values 
  3859.             within the xyz X.25 route record. 
  3860.  
  3861.           o If the model file specifies a record keyword, a name keyword 
  3862.             without a value and one or more field keywords, the specified 
  3863.             fields are returned for all records. In the following example, 
  3864.  
  3865.                                x25_route= (
  3866.                                            name =
  3867.                                            link_station_role =
  3868.                                            )
  3869.             the resulting response file includes all the link_station_role 
  3870.             fields for all instances of the X.25 route record. 
  3871.  
  3872.           o If the model file specifies a record keyword, a name keyword with a 
  3873.             value, and one or more field keywords, the specified fields are 
  3874.             returned for named records. In this example, 
  3875.  
  3876.                                x25_route= (
  3877.                                            name = xyz
  3878.                                            link_name =
  3879.                                            link_station_role =
  3880.                                            )
  3881.             the resulting response file includes the link_name and 
  3882.             link_station_role fields for the xyz X.25 route record. 
  3883.  
  3884.           o Comments will not be copied from the model response file to the 
  3885.             output response file. 
  3886.  
  3887.           /K list 
  3888.                     Specifies that only the keywords in list are to be included 
  3889.                     in the response file. Each keyword entry must be separated 
  3890.                     by a space. The keywords in the list can be one of the 
  3891.                     following: 
  3892.  
  3893.           list 
  3894.                     Specifies zero or more profile keywords that you want 
  3895.                     included in the response file. For example, a specification 
  3896.                     of /K WORKSTATION LAN_DLC generates only two outputs, 
  3897.                     showing the configuration data for the workstation and for 
  3898.                     the LAN DLC. The keywords may not be keywords that are list 
  3899.                     members;  for example, you could specify the keyword 
  3900.                     SDLC_DLC, but not an SDLC_DLC's field keyword such as 
  3901.                     LINE_TYPE. 
  3902.  
  3903.  
  3904. ΓòÉΓòÉΓòÉ <hidden> INSTALL ΓòÉΓòÉΓòÉ
  3905.  
  3906. Records all installation keywords in the response file. Individual installation 
  3907. keywords are not supported. For example, you cannot use /K ConfigWsSerial2, but 
  3908. you can use the INSTALL keyword. 
  3909.  
  3910.  
  3911. ΓòÉΓòÉΓòÉ <hidden> CONFIG ΓòÉΓòÉΓòÉ
  3912.  
  3913. Records all the configuration keywords in the response file. 
  3914.  
  3915. The /K flag is ignored if the /M flag is specified. 
  3916.  
  3917. If neither the /M flag nor the /K flag is given, all keywords supported by 
  3918. response file installation are extracted from the configuration, except for the 
  3919. passwords, which are not recorded. 
  3920.  
  3921.  
  3922. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  3923.  
  3924. CMRECORD ignores the keylock.  A keylocked configuration file can be processed. 
  3925.  
  3926. CMRECORD can be used for problem determination. You can review the response 
  3927. file and the .NDF file (if applicable) to see a complete ASCII representation 
  3928. of your configuration. 
  3929.  
  3930. The output response file cannot be used to re-create or modify a configuration 
  3931. unless you first add some keywords to the response file. You must add 
  3932. CMUPDATETYPE = value to the response file before using it.  You can optionally 
  3933. name the configuration that is created by adding the CMUSERCFG = value keyword. 
  3934. Refer to IBM Communications Manager/2 Version 1.0 Network Administration and 
  3935. Subsystem Management Guide for additional information. 
  3936.  
  3937. CMRECORD can partially record configuration files that have not been verified 
  3938. or have failed verification.  Any records stored in the .CFG file will be 
  3939. recorded, but records from the .NDF file will not be recorded.  These records 
  3940. may be viewed directly (in the .NDF format) in the .NDF file. 
  3941.  
  3942. There are several special cases for recording with model response files: 
  3943.  
  3944.           o If the model file specifies only a record keyword, all instances of 
  3945.             that record and all field keywords for the record are included in 
  3946.             the response file. 
  3947.  
  3948.           o If the model file specifies a record keyword and a name keyword 
  3949.             that identifies a record, all fields within the named record are 
  3950.             included in the response file. 
  3951.  
  3952.           o If the model file specifies a record keyword, a name keyword 
  3953.             without a value, and one or more field keywords, the specified 
  3954.             fields are returned for all records. 
  3955.  
  3956.           o If the model file specifies a record keyword, a name keyword with a 
  3957.             value, and one or more field keywords, the specified fields are 
  3958.             returned for named records. 
  3959.  
  3960.           o If the keywords COPY or DELETE are encountered in the model file, 
  3961.             they are copied to the output file.  Using the DELETE keyword in a 
  3962.             response file while using the CMSETUP command will cause the entry 
  3963.             to be deleted from the configuration file. 
  3964.  
  3965.           o For configuration keywords that support the .* syntax, the keyword 
  3966.             can be specified in the model file with the .* and all occurrences 
  3967.             of that field will be output. 
  3968.  
  3969.           o Comments will not be copied from the model response file to the 
  3970.             output response file. 
  3971.  
  3972.           o The order of the keywords in the output response file may be 
  3973.             different than the order of the keywords in the model response 
  3974.             file. 
  3975.  
  3976.           The CMRECORD utility writes errors to STDOUT.  To write errors to a 
  3977.           disk file, type the following and press Enter: 
  3978.  
  3979.                          CMRECORD [command line parms] >error.fil
  3980.           where error.fil is the name of the file where the errors are to be 
  3981.           written. 
  3982.  
  3983.           Refer to IBM Communications Manager/2 Version 1.0 Network 
  3984.           Administration and Subsystem Management Guide for additional 
  3985.           information on remote installation, response files, and CMRECORD. 
  3986.  
  3987.           To build a response file using the CMRECORD utility, follow these 
  3988.           steps: 
  3989.  
  3990.            1. Start from an OS/2 command prompt. 
  3991.  
  3992.            2. Type CMRECORD cfg_name, where cfg_name is the name of the 
  3993.               configuration that you want to record. 
  3994.  
  3995.           The CMRECORD utility creates a response file.  Any messages or 
  3996.           warnings concerning the response file are placed in the file as 
  3997.           comments. 
  3998.  
  3999.           Edit the response file and add the CMUpdateType keyword to indicate 
  4000.           what you want the response file to do. Also add any other keywords 
  4001.           like CMModelCFG, CMUserCFG, CMStopCommunications, and add or change 
  4002.           any other keywords you want the response file to process. 
  4003.  
  4004.  
  4005. ΓòÉΓòÉΓòÉ <hidden> Example ΓòÉΓòÉΓòÉ
  4006.  
  4007. The following are examples of CMRECORD usage: 
  4008.  
  4009.           o To get help for CMRECORD, type the following and press Enter: 
  4010.  
  4011.                              CMRECORD ?
  4012.  
  4013.           o To record all keywords for the default configuration file to the 
  4014.             default output file, type the following and press Enter: 
  4015.  
  4016.                              CMRECORD /D
  4017.  
  4018.           o To record all keywords for the default configuration file to the 
  4019.             output response file temp.out, type the following and press Enter: 
  4020.  
  4021.                              CMRECORD /D /O temp.out
  4022.  
  4023.           o To record all keywords for the configuration myconfig. and use the 
  4024.             output response file myconfig.rsp, type the following and press 
  4025.             Enter: 
  4026.  
  4027.                              CMRECORD myconfig
  4028.  
  4029.           o To record all logical link records in the configuration myconfig, 
  4030.             type the following and press Enter: 
  4031.  
  4032.                              CMRECORD myconfig /K LOGICAL_LINK
  4033.  
  4034.           o To record the installation keywords and workstation record for the 
  4035.             configuration myconfig, type the following and press Enter: 
  4036.  
  4037.                              CMRECORD myconfig /K INSTALL WORKSTATION
  4038.  
  4039.           o To record all the keywords specified in the file model.rsp for the 
  4040.             default configuration, type the following and press Enter: 
  4041.  
  4042.                              CMRECORD /D /M model.rsp
  4043.  
  4044.  
  4045. ΓòÉΓòÉΓòÉ 3.8. CMTRACE ΓòÉΓòÉΓòÉ
  4046.  
  4047. CMTRACE 
  4048.  
  4049.  Purpose 
  4050.  
  4051.           Provides command line control over the Communications Manager trace 
  4052.           functions. 
  4053.  
  4054.  Syntax 
  4055.  
  4056.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMTRACEΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  4057.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      ΓööΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇSTARTΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  4058.                                               Γö£ΓöÇ/API xΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4059.                                               Γö£ΓöÇ/DLC xΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4060.                                               Γö£ΓöÇ/EVENT nΓöÇΓöÇΓöÇΓöñ
  4061.                                               Γö£ΓöÇ/RESETΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4062.                                               Γö£ΓöÇ/STORAGE nΓöÇΓöñ
  4063.                                               ΓööΓöÇ/TRUNC nΓöÇΓöÇΓöÇΓöÿ
  4064.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4065.                       ΓööΓöÇSTOPΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ  ΓööΓöÇCOPY filenameΓöÇΓöÿ
  4066.                          Γö£ΓöÇ/API xΓöÇΓöÇΓöÇΓöñ
  4067.                          Γö£ΓöÇ/DLC xΓöÇΓöÇΓöÇΓöñ
  4068.                          ΓööΓöÇ/EVENT nΓöÇΓöÿ
  4069.  
  4070.  
  4071. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  4072.  
  4073. The drive where the CMTRACE.EXE file resides.  Specify this drive only if it is 
  4074. not the default drive. 
  4075.  
  4076.  
  4077. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  4078.  
  4079. The path designator that specifies where the CMTRACE.EXE file resides. Use this 
  4080. path only if the file is not in the default path. 
  4081.  
  4082.  
  4083. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  4084.  
  4085. Displays an online summary of CMTRACE. 
  4086.  
  4087. Note:  The ? is the default value for CMTRACE.  If you type CMTRACE and do not 
  4088.        specify a parameter, the online CMTRACE summary is displayed.  You can 
  4089.        use | MORE or > filename to easily view this information. 
  4090.  
  4091.  
  4092. ΓòÉΓòÉΓòÉ <hidden> START ΓòÉΓòÉΓòÉ
  4093.  
  4094. Starts one or more trace categories using the following options:  /API, /DLC, 
  4095. /EVENT, /RESET, /STORAGE, and /TRUNC.  If no trace category is specified, the 
  4096. START parameter enables any categories previously specified. 
  4097.  
  4098.  
  4099. ΓòÉΓòÉΓòÉ <hidden> STOP ΓòÉΓòÉΓòÉ
  4100.  
  4101. Stops one or more trace categories using the following options:  /API, /DLC, 
  4102. and /EVENT. If no trace category is specified, the STOP parameter stops the 
  4103. tracing of all categories. 
  4104.  
  4105.  
  4106. ΓòÉΓòÉΓòÉ <hidden> COPY ΓòÉΓòÉΓòÉ
  4107.  
  4108. Copies a trace to a file.  You must specify a file name with this parameter. 
  4109.  
  4110.  
  4111. ΓòÉΓòÉΓòÉ <hidden> /API x ΓòÉΓòÉΓòÉ
  4112.  
  4113. Used to specify one or more of the following API traces: ACDI, APPC, EHLLAPI, 
  4114. LUARUI, LUASLI, ROPS, SERVICES, SRPI, SUBSYSM, and X25API. 
  4115.  
  4116.  
  4117. ΓòÉΓòÉΓòÉ <hidden> /API x ΓòÉΓòÉΓòÉ
  4118.  
  4119. Used to specify one or more of the following API traces: ACDI, APPC, EHLLAPI, 
  4120. LUARUI, LUASLI, ROPS, SERVICES, SRPI, SUBSYSM, and X25API. 
  4121.  
  4122.  
  4123. ΓòÉΓòÉΓòÉ <hidden> /DLC x ΓòÉΓòÉΓòÉ
  4124.  
  4125. Used to specify one or more of the following DLC traces: DFT, ETHERAND, 
  4126. IBMPCNET, IBMTRNET, ROPS, IDLC, SDLC, TWINAXIAL, X25DLC, and X25FRAME. 
  4127.  
  4128.  
  4129. ΓòÉΓòÉΓòÉ <hidden> /DLC x ΓòÉΓòÉΓòÉ
  4130.  
  4131. Used to specify one or more of the following DLC traces: DFT, ETHERAND, 
  4132. IBMPCNET, IBMTRNET, ROPS, SDLC, TWINAXIAL, X25DLC, and X25FRAME. 
  4133.  
  4134.  
  4135. ΓòÉΓòÉΓòÉ <hidden> /EVENT n ΓòÉΓòÉΓòÉ
  4136.  
  4137. Selects one or more system events to trace.  This option is followed by one or 
  4138. more numbers between 1 and 32. 
  4139.  
  4140. Note:  Refer to Problem Determination Guide for additional information on 
  4141.        system events. 
  4142.  
  4143.  
  4144. ΓòÉΓòÉΓòÉ <hidden> /EVENT n ΓòÉΓòÉΓòÉ
  4145.  
  4146. Selects one or more system events to trace.  This option is followed by one or 
  4147. more numbers between 1 and 31. 
  4148.  
  4149. Note:  Refer to Problem Determination Guide for additional information on 
  4150.        system events. 
  4151.  
  4152.  
  4153. ΓòÉΓòÉΓòÉ <hidden> /RESET ΓòÉΓòÉΓòÉ
  4154.  
  4155. Resets the trace buffer.  Previous trace records are lost. 
  4156.  
  4157.  
  4158. ΓòÉΓòÉΓòÉ <hidden> /STDOUT ΓòÉΓòÉΓòÉ
  4159.  
  4160. Writes the trace data to standard output. 
  4161.  
  4162.  
  4163. ΓòÉΓòÉΓòÉ <hidden> /STORAGE n ΓòÉΓòÉΓòÉ
  4164.  
  4165. Sets the number of 64KB trace buffer segments. 
  4166.  
  4167.  
  4168. ΓòÉΓòÉΓòÉ <hidden> /trunc n ΓòÉΓòÉΓòÉ
  4169.  
  4170. Sets the line length number at which trace records are truncated. 
  4171.  
  4172.  
  4173. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  4174.  
  4175. CMTRACE provides command line control over the Communications Manager trace 
  4176. functions.  With CMTRACE, you can start and stop tracing of particular trace 
  4177. categories and copy a trace to a file.  If you are familiar with the 
  4178. Communications Manager trace windows, CMTRACE provides an alternative means for 
  4179. running a trace.  In addition, the CMTRACE command can be used in a batch file. 
  4180.  
  4181. CMTRACE is installed by default as an additional function.  If you do not want 
  4182. CMTRACE to be installed, deselect Install Additional Functions during 
  4183. Communications Manager installation.  You can install or remove CMTRACE at any 
  4184. time by selecting Options from the Communications Manager Setup window menu bar 
  4185. and selecting your choice of operations (CMTRACE is associated with Problem 
  4186. Determination Aids). 
  4187.  
  4188. You can use CMTRACE before Communications Manager is running; therefore, the 
  4189. "autostart" function of CMTRACE is no longer needed. Any use of the autostart 
  4190. parameter invokes CMTRACE START. 
  4191.  
  4192. You can use CMTRACE to: 
  4193.  
  4194.           o Monitor the events of a problem without swapping to and from the 
  4195.             Communications Manager Trace Services windows. 
  4196.  
  4197.           o Selectively stop a few active traces. 
  4198.  
  4199.           o Selectively start additional trace categories without stopping 
  4200.             active traces. 
  4201.  
  4202.           o Run the same trace several times.  You can create several one- or 
  4203.             two-line command files (.CMD) that invoke CMTRACE with various 
  4204.             trace parameters. 
  4205.  
  4206.           Options can be entered in uppercase or lowercase letters.  All 
  4207.           options are separated by a single space. 
  4208.  
  4209.           For more information on CMTRACE and for information on interpreting 
  4210.           traces, refer to Problem Determination Guide. 
  4211.  
  4212.  
  4213. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  4214.  
  4215. The following are examples of CMTRACE usage: 
  4216.  
  4217.           o To view the syntax for CMTRACE, type the following and press Enter: 
  4218.  
  4219.                              CMTRACE ? | MORE
  4220.  
  4221.           o To start a trace on ACDI and APPC, type the following and press 
  4222.             Enter: 
  4223.  
  4224.                              CMTRACE START /API ACDI APPC
  4225.  
  4226.           o To stop all currently running traces, type the following and press 
  4227.             Enter: 
  4228.  
  4229.                              CMTRACE STOP
  4230.  
  4231.           o To copy the results of a trace to a file named TRACE1.TRC, type the 
  4232.             following and press Enter: 
  4233.  
  4234.                              CMTRACE COPY TRACE1.TRC
  4235.  
  4236.  
  4237. ΓòÉΓòÉΓòÉ 3.9. DISPLAY ΓòÉΓòÉΓòÉ
  4238.  
  4239. DISPLAY 
  4240.  
  4241.  Purpose 
  4242.  
  4243.           Displays status and configuration information for an active SNA 
  4244.           configuration. Output is sent to the standard output destination, 
  4245.           which is normally the display screen. 
  4246.  
  4247.  Syntax 
  4248.  
  4249.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇDISPLAYΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4250.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      ΓööΓöÇpartner LU nameΓöÇΓöÿ  ΓööΓöÇoptionsΓöÇΓöÿ
  4251.  
  4252.  
  4253. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  4254.  
  4255. The drive where the DISPLAY.EXE file resides.  Specify this drive only if it is 
  4256. not the default drive. 
  4257.  
  4258.  
  4259. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  4260.  
  4261. The path designator that specifies where the DISPLAY.EXE file resides. Use this 
  4262. path only if the file is not in the default path. 
  4263.  
  4264.  
  4265. ΓòÉΓòÉΓòÉ <hidden> Partner LU name ΓòÉΓòÉΓòÉ
  4266.  
  4267. Can be a partner LU alias or a fully qualified partner LU name. 
  4268.  
  4269. If you do not specify a partner LU name, the local workstation's sessions are 
  4270. displayed. 
  4271.  
  4272.  
  4273. ΓòÉΓòÉΓòÉ <hidden> options ΓòÉΓòÉΓòÉ
  4274.  
  4275. The following parts of the command are options: 
  4276.  
  4277. Options are not case sensitive. If you specify more than one option, the 
  4278. options must be separated by blanks. 
  4279.  
  4280. If you do not specify any options, all of the workstation's sessions are 
  4281. displayed. 
  4282.  
  4283.           ?                     Displays a help screen 
  4284.  
  4285.           -ad                   Displays adapter information 
  4286.  
  4287.           -am                   Displays attach manager information 
  4288.  
  4289.           -cn                   Displays connection network information 
  4290.  
  4291.           -co                   Displays APPN class of service information 
  4292.  
  4293.           -d                    Displays APPN directory information 
  4294.  
  4295.           -g                    Displays SNA gateway information 
  4296.  
  4297.           -ic                   Displays ISDN incoming call directory entries 
  4298.  
  4299.           -is                   Displays intermediate session routing 
  4300.                                 information 
  4301.  
  4302.           -ld                   Displays link definitions 
  4303.  
  4304.           -li                   Displays active links information 
  4305.  
  4306.           -lud                  Displays logical unit definitions 
  4307.  
  4308.           -lu0                  Displays logical unit 0-3 information 
  4309.  
  4310.           -lu6                  Displays logical unit 6.2 information 
  4311.  
  4312.           -md                   Displays mode definitions 
  4313.  
  4314.           -ms                   Displays management services information 
  4315.  
  4316.           -n                    Displays APPN node information 
  4317.  
  4318.           -pl                   Displays partner logical unit definitions 
  4319.  
  4320.           -pu                   Displays ISDN physical units 
  4321.  
  4322.           -se                   Displays session information 
  4323.  
  4324.           -sn                   Displays SNA global information 
  4325.  
  4326.           -sy                   Displays system defaults 
  4327.  
  4328.           -to                   Displays APPN topology information 
  4329.  
  4330.           -tp                   Displays active transaction programs 
  4331.                                 information 
  4332.  
  4333.           -x                    Displays X.25 physical links information 
  4334.  
  4335.           -tpd                  Displays transaction program definitions 
  4336.  
  4337.  
  4338. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  4339.  
  4340. The DISPLAY command invokes DISPLAY.EXE to display the SNA information about an 
  4341. active configuration. 
  4342.  
  4343. The DISPLAY command can work with the remote display server program 
  4344. (RDSPSRVR.EXE) to allow remote users to obtain significant information about a 
  4345. workstation including LU definitions, TP definitions, and partner LU 
  4346. definitions. 
  4347.  
  4348. If RDSPSRVR.EXE is installed and operational at your local workstation, users 
  4349. at remote workstations can acquire active SNA information about your 
  4350. workstation. 
  4351.  
  4352. If RDSPSRVR.EXE is installed and operational at a remote workstation, you can 
  4353. specify a partner LU name to display the active SNA configuration of that 
  4354. workstation. 
  4355.  
  4356. You can use these two programs to develop an automated network management 
  4357. capability to acquire information about the configuration and status of 
  4358. Communications Manager SNA workstations. 
  4359.  
  4360. The "Communications Manager/2 API Support Diskette" contains the source code 
  4361. for both programs.  DISPLAY.C and RDSPSRVR.C are contained in the zip 
  4362. file-SNA.ZIP which can be unzipped using PKUNZIP2. 
  4363.  
  4364. Note:  The "Communications Manager/2 API Support Diskette" is mentioned in this 
  4365. document. Please note that a CD-ROM that contains the complete Communications 
  4366. Manager product, including all information, is also available. 
  4367.  
  4368. Making RDSPSRVR.EXE operational:  Since this program does not have security 
  4369. capability, you must take one of the following steps to make RDSPSRVR.EXE 
  4370. operational before it can be called by a remote program: 
  4371.  
  4372.           o Copy RDSPSRVR.EXE to the directory specified by the 
  4373.             DIRECTORY_FOR_INBOUND_ATTACHES statement in your .NDF file. 
  4374.  
  4375.           o Add a DEFINE_TP statement for RDSPSRVR to your .NDF file. 
  4376.  
  4377.             The following is an example: 
  4378.  
  4379.  
  4380.                          DEFINE_TP TP_NAME(RDSPSRVR)
  4381.                               FILESPEC(C:\CMLIB\RDSPSRVR.EXE)
  4382.                               CONV_SECURITY_RQD(NO)
  4383.                               CONVERSATION_TYPE(MAPPED)
  4384.                               PROGRAM_TYPE(BACKGROUND)
  4385.                               RECEIVE_ALLOCATE_TIMEOUT(100)
  4386.                               SYNC_LEVEL(EITHER)
  4387.                               TP_OPERATION(NONQUEUED_AM_STARTED)
  4388.                               DESCRIPTION(Server TP supporting
  4389.                                     remote display);
  4390.  
  4391.             After adding the DEFINE_TP statement to your .NDF file, activate 
  4392.             RDSPSRVR by using the /E option of the CMVERIFY command. From the 
  4393.             OS/2 command line, enter CMVERIFY fn /E, where fn is the filename 
  4394.             of your .NDF file. 
  4395.  
  4396.  
  4397. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  4398.  
  4399. The following are examples of DISPLAY usage: 
  4400.  
  4401.           o To display the system defaults and the partner LU definitions for 
  4402.             the local workstation, type the following and press Enter: 
  4403.  
  4404.                              DISPLAY -sy -p
  4405.  
  4406.           o To display all the information available (the default) for a remote 
  4407.             workstation containing a partner LU with a local alias of Ray, type 
  4408.             the following and press Enter: 
  4409.  
  4410.                              DISPLAY ray
  4411.  
  4412.  
  4413. ΓòÉΓòÉΓòÉ 3.10. ESLANX ΓòÉΓòÉΓòÉ
  4414.  
  4415. ESLANX 
  4416.  
  4417.  Purpose 
  4418.  
  4419.           Allows you to modify or create LAN Transport information when using 
  4420.           the Extended Services level of LAN Transport. 
  4421.  
  4422.  Syntax 
  4423.  
  4424.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇESLANXΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4425.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      ΓööΓöÇfilenameΓöÇΓöÿ
  4426.  
  4427.  
  4428. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  4429.  
  4430. The drive where the ESLANX.EXE file resides.  Specify this drive only if it is 
  4431. not the default drive. 
  4432.  
  4433.  
  4434. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  4435.  
  4436. The path designator that specifies where the ESLANX.EXE file resides. Use this 
  4437. path only if the file is not in the default path. 
  4438.  
  4439.  
  4440. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  4441.  
  4442. The name of the file to be modified.  If you do not specify a file name, 
  4443. PROTOCOL.INI is used.  Do not include the file extension; it is assumed to be 
  4444. .INI. 
  4445.  
  4446. filename is required to be in the \IBMCOM subdirectory. 
  4447.  
  4448.  
  4449. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  4450.  
  4451. ESLANX should only be used when you have upgraded from Extended Services but 
  4452. have not upgraded your LAN Transport to LAPS.  Do not use ESLANX if you have 
  4453. upgraded to LAPS. 
  4454.  
  4455. If you use ESLANX to update PROTOCOL.INI, your CONFIG.SYS file is also updated 
  4456. to reflect any changes.  The CONFIG.SYS file is only read during system 
  4457. startup; therefore, any changes that are made to the CONFIG.SYS file will not 
  4458. take affect until you restart your system. 
  4459.  
  4460.  
  4461. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  4462.  
  4463. The following is an example of ESLANX usage: 
  4464.  
  4465.           o To modify or create a PROTOCOL.INI file in the \IBMCOM 
  4466.             subdirectory, type the following and press Enter: 
  4467.  
  4468.                              ESLANX
  4469.  
  4470.  
  4471. ΓòÉΓòÉΓòÉ 3.11. FMTTRACE ΓòÉΓòÉΓòÉ
  4472.  
  4473. FMTTRACE 
  4474.  
  4475.  Purpose 
  4476.  
  4477.           Formats an SNA trace file into a form that is easier to use. 
  4478.  
  4479.           Note:  The options for FMTTRACE are case sensitive; therefore, the 
  4480.                  normal conventions for variable information does not apply. 
  4481.                  For FMTTRACE, xxxxxxxx is used to represent variable 
  4482.                  information. 
  4483.  
  4484.           The FMTTRACE syntax is as follows: 
  4485.  
  4486.  Syntax 
  4487.  
  4488.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilenameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  4489.                       ΓööΓöÇ?ΓöÇΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇhelpΓöÇΓöÿ       Γö£ΓöÇ+dΓöÇΓöÇΓöÇΓöñ  Γö£ΓöÇ+sΓöÇΓöÇΓöÇΓöñ  Γö£ΓöÇ+aΓöÇΓöÇΓöÇΓöñ  Γö£ΓöÇ+fΓöÇΓöÇΓöÇΓöñ
  4490.                                      ΓööΓöÇ-dΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ-sΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ-aΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ-fΓöÇΓöÇΓöÇΓöÿ
  4491.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  4492.                       Γö£ΓöÇ+rΓöÇΓöÇΓöÇΓöñ  Γö£ΓöÇ+txxxxxxxxΓöÇΓöñ  Γö£ΓöÇ+cxxxxxxxxΓöÇΓöñ  Γö£ΓöÇ+lxxxxxxxxΓöÇΓöñ  Γö£ΓöÇ+hΓöÇΓöÇΓöÇΓöñ
  4493.                       ΓööΓöÇ-rΓöÇΓöÇΓöÇΓöÿ  ΓööΓöÇ-txxxxxxxxΓöÇΓöÿ  ΓööΓöÇ-cxxxxxxxxΓöÇΓöÿ  ΓööΓöÇ-lxxxxxxxxΓöÇΓöÿ  ΓööΓöÇ-hΓöÇΓöÇΓöÇΓöÿ
  4494.                     >ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4495.                       Γö£ΓöÇ+nΓöÇΓöÇΓöÇΓöñ
  4496.                       ΓööΓöÇ-nΓöÇΓöÇΓöÇΓöÿ
  4497.  
  4498.  
  4499. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  4500.  
  4501. Specifies the name of the trace file to be formatted. The file name extension 
  4502. .TRC is the default. 
  4503.  
  4504.  
  4505. ΓòÉΓòÉΓòÉ <hidden> ? ΓòÉΓòÉΓòÉ
  4506.  
  4507. Displays an online summary of the FMTTRACE command. 
  4508.  
  4509.  
  4510. ΓòÉΓòÉΓòÉ <hidden> help ΓòÉΓòÉΓòÉ
  4511.  
  4512. Displays an online summary of the FMTTRACE command. 
  4513.  
  4514.  
  4515. ΓòÉΓòÉΓòÉ <hidden> +d ΓòÉΓòÉΓòÉ
  4516.  
  4517. Produces a detail output file (.DET). 
  4518.  
  4519.  
  4520. ΓòÉΓòÉΓòÉ <hidden> -d ΓòÉΓòÉΓòÉ
  4521.  
  4522. Does not produce a detail output file.  This is the default. 
  4523.  
  4524.  
  4525. ΓòÉΓòÉΓòÉ <hidden> +s ΓòÉΓòÉΓòÉ
  4526.  
  4527. Produces a summary output file (.SUM).  This is the default. 
  4528.  
  4529.  
  4530. ΓòÉΓòÉΓòÉ <hidden> -s ΓòÉΓòÉΓòÉ
  4531.  
  4532. Does not produce a summary output file. 
  4533.  
  4534.  
  4535. ΓòÉΓòÉΓòÉ <hidden> +a ΓòÉΓòÉΓòÉ
  4536.  
  4537. Formats the API trace.  This is the default. This option may also specify one 
  4538. or more of the following protocols for the x parameter: ACDI, APPC, CPIC, 
  4539. EHLLAPI, LUARUI, LUASLI, SERVICES, and SRPI.  If x is not specified, all 
  4540. protocols are the default. 
  4541.  
  4542.  
  4543. ΓòÉΓòÉΓòÉ <hidden> -a ΓòÉΓòÉΓòÉ
  4544.  
  4545. Does not format the API trace. 
  4546.  
  4547.  
  4548. ΓòÉΓòÉΓòÉ <hidden> +f ΓòÉΓòÉΓòÉ
  4549.  
  4550. Formats the line-flow trace.  This is the default. This option may also specify 
  4551. one or more of the following interfaces for the x parameter: ETHERAND, 
  4552. IBMPCNET, IBMTRNET, IDLC, MPTNBTCP, SDLC, and X25DLC.  If x is not specified, 
  4553. all interfaces are the default. 
  4554.  
  4555.  
  4556. ΓòÉΓòÉΓòÉ <hidden> -f ΓòÉΓòÉΓòÉ
  4557.  
  4558. Does not format the line flow trace. 
  4559.  
  4560.  
  4561. ΓòÉΓòÉΓòÉ <hidden> +r ΓòÉΓòÉΓòÉ
  4562.  
  4563. Formats TEST_RTS.  This is the default. 
  4564.  
  4565.  
  4566. ΓòÉΓòÉΓòÉ <hidden> -r ΓòÉΓòÉΓòÉ
  4567.  
  4568. Does not format TEST_RTS. 
  4569.  
  4570.  
  4571. ΓòÉΓòÉΓòÉ <hidden> +txxxxxxxx ΓòÉΓòÉΓòÉ
  4572.  
  4573. Formats the APPC API trace records with a TP ID matching X'xxxxxxxx'. 
  4574.  
  4575.  
  4576. ΓòÉΓòÉΓòÉ <hidden> -txxxxxxxx ΓòÉΓòÉΓòÉ
  4577.  
  4578. Does not format the APPC API trace records with a TP ID matching X'xxxxxxxx'. 
  4579.  
  4580.  
  4581. ΓòÉΓòÉΓòÉ <hidden> +cxxxxxxxx ΓòÉΓòÉΓòÉ
  4582.  
  4583. Formats the APPC API trace records with a conversation ID matching X'xxxxxxxx'. 
  4584.  
  4585.  
  4586. ΓòÉΓòÉΓòÉ <hidden> -cxxxxxxxx ΓòÉΓòÉΓòÉ
  4587.  
  4588. Does not format the APPC API trace records with a conversation ID matching 
  4589. X'xxxxxxxx'. 
  4590.  
  4591.  
  4592. ΓòÉΓòÉΓòÉ <hidden> +lxxxxx ΓòÉΓòÉΓòÉ
  4593.  
  4594. Formats the DLC data trace records with an LFSID matching X'xxxxx' (LFSID is a 
  4595. session identifier). 
  4596.  
  4597.  
  4598. ΓòÉΓòÉΓòÉ <hidden> -lxxxxx ΓòÉΓòÉΓòÉ
  4599.  
  4600. Does not format the DLC data trace records with an LFSID matching X'xxxxx' 
  4601. (LFSID is a session identifier). 
  4602.  
  4603.  
  4604. ΓòÉΓòÉΓòÉ <hidden> +h ΓòÉΓòÉΓòÉ
  4605.  
  4606. Uses uppercase alphabetics in hexadecimal output, such as X'BC2F'. 
  4607.  
  4608.  
  4609. ΓòÉΓòÉΓòÉ <hidden> -h ΓòÉΓòÉΓòÉ
  4610.  
  4611. Uses lowercase alphabetics in hexadecimal output such as X'bc2f'. This is the 
  4612. default. 
  4613.  
  4614.  
  4615. ΓòÉΓòÉΓòÉ <hidden> +n ΓòÉΓòÉΓòÉ
  4616.  
  4617. Interleaves raw trace with formatted trace 
  4618.  
  4619.  
  4620. ΓòÉΓòÉΓòÉ <hidden> -n ΓòÉΓòÉΓòÉ
  4621.  
  4622. Does not interleave raw trace with formatted trace 
  4623.  
  4624.  
  4625. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  4626.  
  4627. FMTTRACE is installed by default as an additional function.  If you do not want 
  4628. FMTTRACE to be installed, deselect Install Additional Functions during 
  4629. Communications Manager installation.  You can install or remove FMTTRACE at any 
  4630. time by selecting Options from the Communications Manager Setup window menu bar 
  4631. and selecting your choice of operations (FMTTRACE is associated with Problem 
  4632. Determination Aids). 
  4633.  
  4634. FMTTRACE allows you to format a Communications Manager trace file into a form 
  4635. that is easier to interpret. It formats trace records for the APPC API, APPC 
  4636. send events, and DLC data. You can produce two types of formatted output: a 
  4637. summary file (in sequence diagram form with one line per trace event) and a 
  4638. detail file (with one line per formatted field). 
  4639.  
  4640. The default flag values are -d, +s, +a, +p, +f, +r, and -h. 
  4641.  
  4642. For +t, -t, +c, and -c, the hexadecimal string which follows must be eight 
  4643. characters and must immediately follow the option flag (there are no spaces 
  4644. between the flag and the hexadecimal string). 
  4645.  
  4646. For +l and -l, the hexadecimal string which follows must be five characters and 
  4647. must immediately follow the option flag (there are no spaces between the flag 
  4648. and the hexadecimal string). 
  4649.  
  4650. For more information on FMTTRACE including examples of formatted traces, refer 
  4651. to Problem Determination Guide. 
  4652.  
  4653.  
  4654. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  4655.  
  4656. The following is an example of FMTTRACE usage: 
  4657.  
  4658.           o To format the TRACE1 trace file, produce a detailed output file and 
  4659.             a summary file, type the following and press Enter: 
  4660.  
  4661.                              FMTTRACE +D TRACE1
  4662.             Because +S is the default, a summary file is produced without using 
  4663.             an option. 
  4664.  
  4665.  
  4666. ΓòÉΓòÉΓòÉ 3.12. PMDSPLAY ΓòÉΓòÉΓòÉ
  4667.  
  4668. PMDSPLAY 
  4669.  
  4670.  Purpose 
  4671.  
  4672.           Displays status and configuration information for an active SNA 
  4673.           configuration of Communications Manager. PMDSPLAY uses Presentation 
  4674.           Manager to display the information. This performs the same function 
  4675.           as a display using Presentation Manager Windows. 
  4676.  
  4677.  Syntax 
  4678.  
  4679.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇPMDSPLAYΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4680.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  4681.  
  4682.  
  4683. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  4684.  
  4685. The drive where the PMDSPLAY.EXE file resides.  Specify this drive only if it 
  4686. is not the default drive. 
  4687.  
  4688.  
  4689. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  4690.  
  4691. The path designator that specifies where the PMDSPLAY.EXE file resides. Use 
  4692. this path only if the file is not in the default path. 
  4693.  
  4694.  
  4695. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  4696.  
  4697. This command invokes PMDSPLAY.EXE (a Presentation Manager version of 
  4698. DISPLAY.EXE) to display the SNA information about an active configuration. See 
  4699. DISPLAY for additional information. 
  4700.  
  4701. PMDSPLAY.EXE is also invoked when "Display active SNA configuration" is 
  4702. selected from the Communications Manager Subsystem Management menu. 
  4703.  
  4704. Three operational modes can be selected from Options on the menu bar: 
  4705.  
  4706.            1. Display to the screen (the default). 
  4707.  
  4708.            2. Display to the screen and place the display results in a file. 
  4709.  
  4710.            3. Display the active SNA information of a remote workstation. 
  4711.  
  4712.               When you select this mode, the active SNA configuration of a 
  4713.               remote workstation can be displayed. You must provide a 
  4714.               configured Partner LU name for the remote workstation, and the 
  4715.               remote display server program RDSPSRVR.EXE must be installed and 
  4716.               operational at the remote workstation. 
  4717.  
  4718.           The PMDSPLAY command can work with the remote display server program 
  4719.           (RDSPSRVR.EXE) to allow remote users to obtain significant 
  4720.           information about a workstation including LU definitions, TP 
  4721.           definitions, and partner LU definitions. 
  4722.  
  4723.           o If RDSPSRVR.EXE is installed and operational at your local 
  4724.             workstation, users at remote workstations can acquire active SNA 
  4725.             information about your workstation. 
  4726.  
  4727.           o If RDSPSRVR.EXE is installed and operational at a remote 
  4728.             workstation, you can specify a partner LU name to display the 
  4729.             active SNA configuration of that workstation. 
  4730.  
  4731.           PMDSPLAY.EXE is installed in the \CMLIB directory. 
  4732.  
  4733.           The "Communications Manager/2 API Support Diskette" contains the 
  4734.           source code for both programs.  PMDSPLAY.C and RDSPSRVR.C are 
  4735.           contained in the zip file-SNA.ZIP which can be unzipped using 
  4736.           PKUNZIP2. 
  4737.  
  4738.           Note:  The "Communications Manager/2 API Support Diskette" is 
  4739.           mentioned in this document. Please note that a CD-ROM that contains 
  4740.           the complete Communications Manager product, including all 
  4741.           information, is also available. 
  4742.  
  4743.           Making RDSPSRVR.EXE operational:  Since this program does not have 
  4744.           security capability, you must take one of the following steps to make 
  4745.           RDSPSRVR.EXE operational before it can be called by a remote program: 
  4746.  
  4747.           o Copy RDSPSRVR.EXE to the directory specified by the 
  4748.             DIRECTORY_FOR_INBOUND_ATTACHES statement in your .NDF file. 
  4749.  
  4750.           o Add a DEFINE_TP statement for RDSPSRVR to your .NDF file. 
  4751.  
  4752.             The following is an example: 
  4753.  
  4754.  
  4755.                          DEFINE_TP TP_NAME(RDSPSRVR)
  4756.                               FILESPEC(C:\CMLIB\RDSPSRVR.EXE)
  4757.                               CONV_SECURITY_RQD(NO)
  4758.                               CONVERSATION_TYPE(MAPPED)
  4759.                               PROGRAM_TYPE(BACKGROUND)
  4760.                               RECEIVE_ALLOCATE_TIMEOUT(100)
  4761.                               SYNC_LEVEL(EITHER)
  4762.                               TP_OPERATION(NONQUEUED_AM_STARTED)
  4763.                               DESCRIPTION(Server TP supporting
  4764.                                     remote display);
  4765.  
  4766.             After adding the DEFINE_TP statement to your .NDF file, activate 
  4767.             RDSPSRVR by using the /E option of the CMVERIFY command. From the 
  4768.             OS/2 command line, enter CMVERIFY fn /E, where fn is the name of 
  4769.             your Communications Manager configuration. 
  4770.  
  4771.  
  4772. ΓòÉΓòÉΓòÉ 3.13. REDIRECT ΓòÉΓòÉΓòÉ
  4773.  
  4774. REDIRECT 
  4775.  
  4776.  Purpose 
  4777.  
  4778.           Redirects serial ports on an OS/2 workstation. 
  4779.  
  4780.  Syntax 
  4781.  
  4782.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇREDIRECTΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  4783.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  4784.                     >ΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4785.                       Γöé ΓööΓöÇCOMx TOΓöÇΓöÇΓö¼ΓöÇCOMyΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ Γöé
  4786.                       Γöé       ΓööΓöÇserver_nameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ  Γöé
  4787.                       Γöé              ΓööΓöÇON  LANAnΓöÇΓöÿ   Γöé
  4788.                       Γö£ΓöÇSAVEΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4789.                       ΓööΓöÇRESTOREΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4790.  
  4791.  
  4792. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  4793.  
  4794. The drive where the REDIRECT.EXE file resides.  Specify this drive only if it 
  4795. is not the default drive. 
  4796.  
  4797.  
  4798. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  4799.  
  4800. The path designator that specifies where the REDIRECT.EXE file resides. Use 
  4801. this path only if the file is not in the default path. 
  4802.  
  4803.  
  4804. ΓòÉΓòÉΓòÉ <hidden> COMx, COMy ΓòÉΓòÉΓòÉ
  4805.  
  4806. COM1, COM2, or COM3 communication ports. 
  4807.  
  4808.  
  4809. ΓòÉΓòÉΓòÉ <hidden> COMx, COMy ΓòÉΓòÉΓòÉ
  4810.  
  4811. COM1, COM2, or COM3 communication ports. 
  4812.  
  4813.  
  4814. ΓòÉΓòÉΓòÉ <hidden> server_name ΓòÉΓòÉΓòÉ
  4815.  
  4816. The server NETBIOS name assigned to the asynchronous resource at the 
  4817. asynchronous machine. 
  4818.  
  4819.  
  4820. ΓòÉΓòÉΓòÉ <hidden> LANAn ΓòÉΓòÉΓòÉ
  4821.  
  4822. Either LANA0 for LAN adapter 0 or LANA1 for LAN adapter 1. 
  4823.  
  4824.  
  4825. ΓòÉΓòÉΓòÉ <hidden> RESTORE ΓòÉΓòÉΓòÉ
  4826.  
  4827. Allows you to reinitialize ACDI to the permanent redirection configuration 
  4828. after you have temporarily changed to a different redirection configuration. 
  4829.  
  4830.  
  4831. ΓòÉΓòÉΓòÉ <hidden> SAVE ΓòÉΓòÉΓòÉ
  4832.  
  4833. Allows you to save the current redirection configuration as the permanent 
  4834. redirection configuration. 
  4835.  
  4836. Note:  Since the current redirection configuration is lost when you stop ACDI, 
  4837.        this parameter must be used before you stop ACDI. 
  4838.  
  4839.  
  4840. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  4841.  
  4842. Be aware that there are two different REDIRECT commands. 
  4843.  
  4844.           o The REDIRECT command for ACDI Redirection is provided with IBM 
  4845.             Communications Manager. for use on OS/2 workstations. 
  4846.  
  4847.           o This command is not the same as the REDIRECT command provided with 
  4848.             the LAN Asynchronous Connection Server Program for use on DOS 
  4849.             workstations. 
  4850.  
  4851.           Using ACDI Redirection requires: 
  4852.  
  4853.           o Communications Manager 
  4854.           o ACDI 
  4855.           o LAN Adapter and Protocol Support (NETBIOS). 
  4856.  
  4857.           You can configure ACDI Redirection to be temporary or permanent. ACDI 
  4858.           is initialized to the permanent redirection configuration when 
  4859.           Communications Manager is started. 
  4860.  
  4861.           While ACDI is running, you can temporarily change the redirection for 
  4862.           a port; however, you cannot redirect a serial port while it is in 
  4863.           use. You can change the redirection configuration from the command 
  4864.           line, or from an application written to the ACDI Redirection 
  4865.           application programming interface (API). 
  4866.  
  4867.           The ACDI feature of Communications Manager must be installed and 
  4868.           configured prior to activating the ACDI subsystem. 
  4869.  
  4870.           The OS/2 workstation does not need to have a physical serial port (an 
  4871.           asynchronous communications adapter) to use ACDI Redirection. When a 
  4872.           user redirects a serial port, ACDI creates a virtual serial port. 
  4873.  
  4874.           For example, if a user issues the statement REDIRECT COM1 TO 
  4875.           REMOTECOM, ACDI creates a virtual serial port named COM1 and 
  4876.           associates COM1 with the server NETBIOS name REMOTECOM. The virtual 
  4877.           COM1, which can be accessed only by ACDI, is separate and independent 
  4878.           from any physical COM1. An application written to ACDI can use the 
  4879.           virtual COM1 at the same time that another application or device, 
  4880.           such as a mouse, is using the physical COM1. 
  4881.  
  4882.           ACDI can create: 
  4883.  
  4884.           o Two virtual serial ports (COM1 and COM2) on an OS/2 LAN workstation 
  4885.             with an IBM AT-type bus 
  4886.  
  4887.           o Three virtual serial ports (COM1, COM2, and COM3) on 
  4888.  
  4889.           Once you configure ACDI Redirection and save the redirection 
  4890.           configuration, you do not need to configure ACDI Redirection again 
  4891.           unless you want to change the redirection configuration. 
  4892.  
  4893.           When you start an OS/2 workstation and start ACDI Redirection, ACDI 
  4894.           automatically uses the permanent ACDI Redirection configuration. 
  4895.  
  4896.           Refer to rspfile. for more information on ACDI installation and 
  4897.           configuration. 
  4898.  
  4899.           Refer to User's Guide for more information on ACDI Redirection. 
  4900.  
  4901.  
  4902. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  4903.  
  4904. The following are examples of REDIRECT usage: 
  4905.  
  4906.           o To cancel redirection, redirect a serial port to itself by typing 
  4907.             the following and pressing Enter: 
  4908.  
  4909.                              REDIRECT COMx TO COMx
  4910.  
  4911.           o To display the current configuration for each serial port, type 
  4912.             REDIRECT with no parameters and press Enter: 
  4913.  
  4914.                              REDIRECT
  4915.  
  4916.           o To redirect a local serial port to the server, type the following 
  4917.             and press Enter: 
  4918.  
  4919.                              REDIRECT COMx TO server_name
  4920.  
  4921.             In this statement, COMx is either COM1, COM2, or COM3, and 
  4922.             server_name is the NETBIOS name of the resource at the asynchronous 
  4923.             server machine. 
  4924.  
  4925.           o To redirect a serial port to another serial port on the same OS/2 
  4926.             workstation, type the following and press Enter: 
  4927.  
  4928.                              REDIRECT COMx to COMy
  4929.  
  4930.  
  4931. ΓòÉΓòÉΓòÉ 4. User Profile Management Commands ΓòÉΓòÉΓòÉ
  4932.  
  4933. User Profile Management is a program packaged with Communications Manager that 
  4934. provides: 
  4935.  
  4936.  o Authorization checking by means of a logon facility 
  4937.  o Administration of user IDs and passwords. 
  4938.  
  4939.  This chapter discusses the User Profile Management commands.  Each command 
  4940.  description includes the purpose of the command, a syntax diagram, a list of 
  4941.  parameters, a discussion of options, remarks, and examples. 
  4942.  
  4943.  In addition to using the Presentation Manager interface to perform User 
  4944.  Profile Management functions, you can issue commands to perform certain 
  4945.  functions from the OS/2 command line. Unless otherwise specified, directions 
  4946.  in this book assume you are invoking commands from the OS/2 command line. 
  4947.  
  4948.  Note:  A hyphen (-) can be used in place of a slash (/) when specifying an 
  4949.         option for each of the commands in this chapter. 
  4950.  
  4951.  For a detailed discussion of User Profile Management, refer to User's Guide. 
  4952.  
  4953.  To view the list of User Profile Management commands, press Ctrl+C to return 
  4954.  to the Contents. Next, select the plus sign (+) or press the + key. 
  4955.  
  4956.  
  4957. ΓòÉΓòÉΓòÉ 4.1. LOGOFF ΓòÉΓòÉΓòÉ
  4958.  
  4959. LOGOFF 
  4960.  
  4961.  Purpose 
  4962.  
  4963.           Logs off the local OS/2 program and all remote workstations. 
  4964.  
  4965.  Syntax 
  4966.  
  4967.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇLOGOFFΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  4968.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      Γö£ΓöÇ/LΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4969.                                      Γö£ΓöÇ/N=nodeΓöÇΓöñ
  4970.                                      Γö£ΓöÇ/DΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4971.                                      ΓööΓöÇ/SΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4972.  
  4973.  
  4974. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  4975.  
  4976. The drive where the LOGOFF.EXE file resides.  Specify this drive only if it is 
  4977. not the default drive. 
  4978.  
  4979.  
  4980. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  4981.  
  4982. The path designator that specifies where the LOGOFF.EXE file resides. Use this 
  4983. path only if the file is not in the default path. 
  4984.  
  4985.  
  4986. ΓòÉΓòÉΓòÉ <hidden> /L ΓòÉΓòÉΓòÉ
  4987.  
  4988. Lists current logged-on sessions, allowing you to select a particular session 
  4989. from which to log off. 
  4990.  
  4991.  
  4992. ΓòÉΓòÉΓòÉ <hidden> /N = node ΓòÉΓòÉΓòÉ
  4993.  
  4994. Logs off the specified node name. If node is not specified, all nodes in the 
  4995. session are logged off. 
  4996.  
  4997.  
  4998. ΓòÉΓòÉΓòÉ <hidden> /D ΓòÉΓòÉΓòÉ
  4999.  
  5000. Logs you off the LAN server domain. 
  5001.  
  5002.  
  5003. ΓòÉΓòÉΓòÉ <hidden> /S ΓòÉΓòÉΓòÉ
  5004.  
  5005. Logs you off the current session. 
  5006.  
  5007.  
  5008. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5009.  
  5010. No specific authorization is required to issue the LOGOFF command. 
  5011.  
  5012. If no options are specified, all user IDs that are logged on are logged off. 
  5013.  
  5014. If you are not logged on, issuing the LOGOFF command does not cause an error. 
  5015.  
  5016.  
  5017. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5018.  
  5019. The following examples show various options of the LOGOFF command: 
  5020.  
  5021. A list of currently logged-on sessions is displayed. 
  5022.  
  5023.      logoff /l
  5024.  
  5025. The entry for the node name node4 is logged off. 
  5026.  
  5027.      logoff /n=node4
  5028.  
  5029. All node entries are logged off. 
  5030.  
  5031.      logoff /n
  5032.  
  5033. All logons are logged off. 
  5034.  
  5035.      logoff
  5036.  
  5037.  
  5038. ΓòÉΓòÉΓòÉ 4.2. LOGON ΓòÉΓòÉΓòÉ
  5039.  
  5040. LOGON 
  5041.  
  5042.  Purpose 
  5043.  
  5044.           Identifies you to the local and remote workstations and allows 
  5045.           access, if required, to Communications Manager. 
  5046.  
  5047.  Syntax 
  5048.  
  5049.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇLOGONΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  5050.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5051.                     >ΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5052.                       Γöé ΓööΓöÇuseridΓöÇΓöÿ  ΓööΓöÇ/P=passwordΓöÇΓöÿ  Γö£ΓöÇ/N=nodeΓöÇΓöÇΓöÇΓöñ Γöé
  5053.                       Γöé                Γö£ΓöÇ/L=logonΓöÇΓöÇΓöñ Γöé
  5054.                       Γöé                ΓööΓöÇ/D=domainΓöÇΓöÿ Γöé
  5055.                       ΓööΓöÇ/O=optionΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5056.  
  5057.  
  5058. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5059.  
  5060. The drive where the LOGON.EXE file resides.  Specify this drive only if it is 
  5061. not the default drive. 
  5062.  
  5063.  
  5064. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5065.  
  5066. The path designator that specifies where the LOGON.EXE file resides. Use this 
  5067. path only if the file is not in the default path. 
  5068.  
  5069.  
  5070. ΓòÉΓòÉΓòÉ <hidden> userid ΓòÉΓòÉΓòÉ
  5071.  
  5072. The user ID of the person logging on.  If the user ID is not specified, the 
  5073. Logon window is displayed for typing the user ID. 
  5074.  
  5075.  
  5076. ΓòÉΓòÉΓòÉ <hidden> /P=password ΓòÉΓòÉΓòÉ
  5077.  
  5078. Allows you to specify a password. If a password is specified, an attempt is 
  5079. made to log on using that password.  If the password option is not specified, 
  5080. an attempt is made to log on without a password.  If a password is necessary, 
  5081. the Logon window is displayed for typing the password. 
  5082.  
  5083. The /P option is ignored if a user ID is not specified. 
  5084.  
  5085. Warning: If you use the /P option, the password is displayed on the screen.  If 
  5086. you are using the Retrieve Commands option (by placing SET KEYS=ON in the 
  5087. CONFIG.SYS file or by issuing KEYS ON at the OS/2 command prompt), another 
  5088. person can retrieve the LOGON command and see your password, even if you have 
  5089. logged off.  To prevent someone from retrieving your password, you must close 
  5090. the OS/2 session after logging off. 
  5091.  
  5092.  
  5093. ΓòÉΓòÉΓòÉ <hidden> /N=node ΓòÉΓòÉΓòÉ
  5094.  
  5095. Specifies the node to be used the next time the system requires the node to be 
  5096. accessed.  With the /N option, the user ID and password are not validated until 
  5097. the program attempts to connect to the node. If node is omitted, the Logon 
  5098. window for Remote Node Access is displayed for entering the node name. 
  5099.  
  5100. If only the /N option is specified, the Logon window for Remote Node access is 
  5101. displayed for entering the user ID, password, and node name. 
  5102.  
  5103.  
  5104. ΓòÉΓòÉΓòÉ <hidden> /L=logon ΓòÉΓòÉΓòÉ
  5105.  
  5106. The /L option specifies a local logon. 
  5107.  
  5108.  
  5109. ΓòÉΓòÉΓòÉ <hidden> /D=domain ΓòÉΓòÉΓòÉ
  5110.  
  5111. The /D option specifies the domain name on which to log on.  If a domain name 
  5112. is entered, an attempt is made to log on to that domain. If the /D option is 
  5113. specified without a domain name, an attempt is made to log on to the default 
  5114. domain.  If that logon is unsuccessful, the Logon window is displayed so that a 
  5115. domain name can be entered.  If a user is already logged on to a domain, the /D 
  5116. option displays the domain logon window. 
  5117.  
  5118. Note:  The /D option is ignored if LAN Requester (a separately sold product) 
  5119.        could not be started or if domain switching is not allowed. If this 
  5120.        option is ignored, a local logon is performed. 
  5121.  
  5122.           If the domain specified cannot be found or is not available, the user 
  5123.           is logged on as a stand-alone user.  That is, the user ID and 
  5124.           password are saved and used when the user attempts to access a remote 
  5125.           server. 
  5126.  
  5127.  
  5128. ΓòÉΓòÉΓòÉ <hidden> /O=option ΓòÉΓòÉΓòÉ
  5129.  
  5130. The /O option specifies the type of local logon. There are two valid options: 
  5131.  
  5132.           o MULTI specifies multiple local logons so that you can later log on 
  5133.             with multiple local user IDs, allowing multiple application 
  5134.             programs to run concurrently under different user IDs. User Profile 
  5135.             Management displays a logon window for each new application program 
  5136.             initiated.  Application programs that access multiple protected 
  5137.             resources may not require additional logons. 
  5138.  
  5139.           o SINGLE specifies single local logon.  Only one local logged on user 
  5140.             ID is allowed for each workstation.  All application programs run 
  5141.             under that user ID until a logoff or another local logon is issued. 
  5142.             If you log on with a different user ID, the current user ID is 
  5143.             automatically logged off.  This command is ignored if there are 
  5144.             currently multiple local logons. 
  5145.  
  5146.           You cannot specify the userid, /P, or /N options when the /O option 
  5147.           is specified. 
  5148.  
  5149.  
  5150. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5151.  
  5152. If the LOGON command does not include userid, the Logon window is displayed.  A 
  5153. user ID and, if required, the password for that ID must be specified before 
  5154. logon processing continues. 
  5155.  
  5156. Options can be indicated by a forward slash (/) and can be specified in any 
  5157. order.  Each option can be used once. 
  5158.  
  5159. Logons are active until you log off or initialize your workstation again.  For 
  5160. example, even if you had to log on to use the 5250 Work Station Feature, 
  5161. exiting does not automatically log you off.  If you plan to leave your 
  5162. workstation unattended, you should log off to prevent unauthorized use of your 
  5163. user ID. 
  5164.  
  5165.  
  5166. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5167.  
  5168. The following examples show the various options of the LOGON command. 
  5169.  
  5170.           o The user jsmith logs on to the system.  If a password is required 
  5171.             for jsmith, the Logon window is displayed and prompts the user for 
  5172.             a password. 
  5173.  
  5174.                              logon jsmith
  5175.  
  5176.           o The user cjones logs on to the node nodeb: 
  5177.  
  5178.                              logon cjones /n=nodeb
  5179.  
  5180.           o The user rmiller issues the logon command without specifying a 
  5181.             node.  The Logon window for Remote Node Access is displayed and 
  5182.             prompts the user for a node name. 
  5183.  
  5184.                              logon rmiller /n
  5185.  
  5186.           o Multiple local logon is specified.  This allows multiple local user 
  5187.             IDs to be able to log on. 
  5188.  
  5189.                              logon /o=multi
  5190.  
  5191.           o Local logon is specified.  The Logon window for Local Access is 
  5192.             displayed. 
  5193.  
  5194.                              logon /l
  5195.  
  5196.           o Logon to domain aus003 is specified.  The Logon window for Domain 
  5197.             Access to domain AUS003 is displayed. 
  5198.  
  5199.                              logon /d=aus003
  5200.  
  5201.  
  5202. ΓòÉΓòÉΓòÉ 4.3. UPMACCTS ΓòÉΓòÉΓòÉ
  5203.  
  5204. UPMACCTS 
  5205.  
  5206.  Purpose 
  5207.  
  5208.           Displays the User Profile Management User Profile primary menu. 
  5209.  
  5210.  Syntax 
  5211.  
  5212.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇUPMACCTSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5213.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5214.  
  5215.  
  5216. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5217.  
  5218. The drive where the UPMACCTS.EXE file resides.  Specify this drive only if it 
  5219. is not the default drive. 
  5220.  
  5221.  
  5222. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5223.  
  5224. The path designator that specifies where the UPMACCTS.EXE file resides. Use 
  5225. this path only if the file is not in the default path. 
  5226.  
  5227.  
  5228. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5229.  
  5230. No specific authorization is required to issue this command. 
  5231.  
  5232. If the user is not logged on, the Logon window is displayed.  If logon is 
  5233. successful, the User Profile primary menu is displayed. 
  5234.  
  5235. If the user has administrator authority, the User Management primary menu and 
  5236. the Group Management primary menu can be accessed from the User Profile primary 
  5237. menu. 
  5238.  
  5239.  
  5240. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5241.  
  5242. The following example displays the User Profile primary menu: 
  5243.  
  5244.      upmaccts
  5245.  
  5246.  
  5247. ΓòÉΓòÉΓòÉ 4.4. UPMCSET ΓòÉΓòÉΓòÉ
  5248.  
  5249. UPMCSET 
  5250.  
  5251.  Purpose 
  5252.  
  5253.           Specifies the character set used to define user IDs, group IDs, and 
  5254.           passwords. 
  5255.  
  5256.  Syntax 
  5257.  
  5258.                     >>ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇUPMCSETΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5259.                       ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ      Γö£ΓöÇ/MΓöÇΓöÇΓöÇΓöñ
  5260.                                      ΓööΓöÇ/EΓöÇΓöÇΓöÇΓöÿ
  5261.  
  5262.  
  5263. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5264.  
  5265. The drive where the UPMCSET.EXE file resides.  Specify this drive only if it is 
  5266. not the default drive. 
  5267.  
  5268.  
  5269. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5270.  
  5271. The path designator that specifies where the UPMCSET.EXE file resides. Use this 
  5272. path only if the file is not in the default path. 
  5273.  
  5274.  
  5275. ΓòÉΓòÉΓòÉ <hidden> /M ΓòÉΓòÉΓòÉ
  5276.  
  5277. Indicates that user IDs, group IDs, and passwords must be defined in the 
  5278. minimal character set. 
  5279.  
  5280.  
  5281. ΓòÉΓòÉΓòÉ <hidden> /E ΓòÉΓòÉΓòÉ
  5282.  
  5283. Indicates that user IDs, group IDs, and passwords can be defined in the 
  5284. expanded character set. 
  5285.  
  5286.  
  5287. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5288.  
  5289. The default for UPMCSET is /M. 
  5290.  
  5291. The minimal character set includes the following: 
  5292.  
  5293.           o A through Z 
  5294.           o 0 through 9 
  5295.           o Number sign (#) 
  5296.           o At sign (@) 
  5297.           o Dollar sign ($) 
  5298.  
  5299.           The following rules apply when you use the minimal character set: 
  5300.  
  5301.           o User IDs and group IDs cannot begin with a number or end with the 
  5302.             dollar sign ($) character. 
  5303.  
  5304.           o User IDs and group IDs can be from 1 to 8 characters long. 
  5305.             Passwords can be from 4 to 8 characters long. 
  5306.  
  5307.           o User IDs and group IDs cannot begin with IBM or SYS. 
  5308.  
  5309.           o User IDs and group IDs cannot have the following values: 
  5310.  
  5311.              - USERS 
  5312.              - GUESTS 
  5313.              - ADMINS 
  5314.              - PUBLIC 
  5315.              - LOCAL 
  5316.  
  5317.           If you choose to use the expanded character set, you can use the 
  5318.           minimal character set plus other printable characters except for the 
  5319.           following: 
  5320.  
  5321.                       . ' / \ [ ] ; : | < > + = , ? *
  5322.           Also, you cannot use characters whose values are less than 
  5323.           hexadecimal 20. 
  5324.  
  5325.           If you use the expanded character set, user IDs and group IDs can be 
  5326.           from 1 to 10 characters long and passwords can be from 4 to 10 
  5327.           characters long. 
  5328.  
  5329.           Note: 
  5330.  
  5331.            1. Communications Manager identifiers are restricted to the minimal 
  5332.               character set.  However, if you have chosen to use the expanded 
  5333.               character set, Communications Manager identifiers can be from 1 
  5334.               to 10 characters long. 
  5335.  
  5336.            2. User Profile Management does not guarantee correct processing of 
  5337.               identifiers using the expanded character set if the code page or 
  5338.               country code of the system differs from that specified when the 
  5339.               identifier was created.  It is your responsibility to make sure 
  5340.               that the expanded character set is used only when the code page 
  5341.               and country code of the system will not be changed. 
  5342.  
  5343.            3. You should not create network names (user IDs, group IDs, 
  5344.               aliases, and so on) that begin with a number or end with the 
  5345.               dollar sign ($) character even when using the expanded character 
  5346.               set.  Unpredictable results may occur. 
  5347.  
  5348.  
  5349. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5350.  
  5351. The following example specifies the expanded character set: 
  5352.  
  5353.      upmcset /E
  5354.  
  5355.  
  5356. ΓòÉΓòÉΓòÉ 5. Obsolete Commands ΓòÉΓòÉΓòÉ
  5357.  
  5358. This appendix identifies obsolete commands and suggests the corresponding IBM 
  5359. Communications Manager/2 Version 1.0 replacement. 
  5360.  
  5361. To view the list of obsolete commands, press Ctrl+C to return to the Contents. 
  5362. Next, select the plus sign (+) or press the + key. 
  5363.  
  5364.  
  5365. ΓòÉΓòÉΓòÉ 5.1. APPNC ΓòÉΓòÉΓòÉ
  5366.  
  5367. You can access Communications Manager Configuration Services by using CMSETUP. 
  5368.  
  5369.  
  5370. ΓòÉΓòÉΓòÉ 5.2. APPNLINK ΓòÉΓòÉΓòÉ
  5371.  
  5372. No IBM Communications Manager/2 Version 1.0 command is equivalent to this 
  5373. command. Use the following steps to perform the function previously performed 
  5374. by APPNLINK. 
  5375.  
  5376.   1. From the Communications Manager/2 window, select Subsystem Management. 
  5377.  
  5378.      The Subsytem Management window appears. 
  5379.  
  5380.      Note:  You can activate the Subsystem Management window from the command 
  5381.             line by typing ACSSBMGT and pressing Enter. 
  5382.  
  5383.   2. Make sure that the SNA subsytem is started.  If the SNA subsytem is not 
  5384.      started, select SNA subsystem and select Start from the Services option on 
  5385.      the menu bar. 
  5386.  
  5387.   3. Select SNA subsystem and select Details... from the Services option on the 
  5388.      menu bar. 
  5389.  
  5390.      The SNA Subsytem window appears. 
  5391.  
  5392.   4. From the SNA Subsytem window, select Logical Links. 
  5393.  
  5394.      The Logical Links window appears which displays the link names, link 
  5395.      status, and other details. 
  5396.  
  5397.  For more information on subsystem management, refer to IBM Communications 
  5398.  Manager/2 Version 1.0 Network Administration and Subsystem Management Guide. 
  5399.  
  5400.  
  5401. ΓòÉΓòÉΓòÉ 5.3. APPNLOG ΓòÉΓòÉΓòÉ
  5402.  
  5403. No IBM Communications Manager/2 Version 1.0 command is equivalent to this 
  5404. command.  You can use FFST/2 to view the message log. 
  5405.  
  5406. Use one of the following methods to view the FFST/2 message log: 
  5407.  
  5408.  o Select FFST/2 from the desktop and select Message Log Formatter. 
  5409.  
  5410.  o Type MSGLOGF from the command line and press Enter. 
  5411.  
  5412.  Refer to Problem Determination Guide for more information on FFST/2. 
  5413.  
  5414.  
  5415. ΓòÉΓòÉΓòÉ 5.4. APPNMIG ΓòÉΓòÉΓòÉ
  5416.  
  5417. Use CMUPGRAD to upgrade Communications Manager configuration files from 
  5418. Extended Edition 1.30.1 and Extended Services formats to IBM Communications 
  5419. Manager/2 Version 1.0 format. 
  5420.  
  5421.  
  5422. ΓòÉΓòÉΓòÉ 5.5. APPNV ΓòÉΓòÉΓòÉ
  5423.  
  5424. You can verify Communications Manager configurations by using CMVERIFY. 
  5425.  
  5426.  
  5427. ΓòÉΓòÉΓòÉ 5.6. COPYCFG ΓòÉΓòÉΓòÉ
  5428.  
  5429. You can use the OS/2 COPY command to copy the configuration files. These files 
  5430. have extensions .CFG, .NDF, .SEC, and .CF2.  For LAN and ISDN configurations, 
  5431. other files must also be copied; refer to Configuration Guide for details. 
  5432.  
  5433.  
  5434. ΓòÉΓòÉΓòÉ 5.7. CUSTBLD ΓòÉΓòÉΓòÉ
  5435.  
  5436. No IBM Communications Manager/2 Version 1.0 command is equivalent to this 
  5437. command.  You can use the following procedure to perform a new but similar IBM 
  5438. Communications Manager/2 Version 1.0 function: 
  5439.  
  5440.   1. Create a response file and optionally create a model configuration file. 
  5441.  
  5442.   2. Place both the response file and optional model configuration file on a 
  5443.      diskette. 
  5444.  
  5445.   3. Use CMSETUP /R response_file. 
  5446.  
  5447.  See CMSETUP for more information. 
  5448.  
  5449.  
  5450. ΓòÉΓòÉΓòÉ 5.8. EECFG ΓòÉΓòÉΓòÉ
  5451.  
  5452. You can access Communications Manager Configuration Services by using CMSETUP. 
  5453.  
  5454.  
  5455. ΓòÉΓòÉΓòÉ 5.9. ESCFG ΓòÉΓòÉΓòÉ
  5456.  
  5457. You can access Communications Manager Configuration Services by using CMSETUP. 
  5458.  
  5459.  
  5460. ΓòÉΓòÉΓòÉ 5.10. ESINST ΓòÉΓòÉΓòÉ
  5461.  
  5462. You can access Communications Manager Installation Services and Configuration 
  5463. Services by using CMSETUP. 
  5464.  
  5465.  
  5466. ΓòÉΓòÉΓòÉ 5.11. REINST ΓòÉΓòÉΓòÉ
  5467.  
  5468. You can access Communications Manager Installation Services and Configuration 
  5469. Services by using CMSETUP. 
  5470.  
  5471.  
  5472. ΓòÉΓòÉΓòÉ 5.12. VIEWBLOG ΓòÉΓòÉΓòÉ
  5473.  
  5474. No IBM Communications Manager/2 Version 1.0 command is equivalent to this 
  5475. command. You can use an ASCII editor to view the \CMLIB\CM.LOG file or use the 
  5476. following procedure to view the audit trail: 
  5477.  
  5478.   1. Select Communications Manager/2 from the desktop. 
  5479.  
  5480.      The Communications Manager/2 window appears. 
  5481.  
  5482.   2. Select Communications Manager Setup from the Communications Manager/2 
  5483.      window. 
  5484.  
  5485.      The Communications Manager Setup window appears. 
  5486.  
  5487.   3. Select Options from the menu bar of the Communications Manager Setup 
  5488.      window and select View audit trail.... 
  5489.  
  5490.      The View Audit Trail window appears. 
  5491.  
  5492.  
  5493. ΓòÉΓòÉΓòÉ 5.13. VIEWLOG ΓòÉΓòÉΓòÉ
  5494.  
  5495. There is no IBM Communications Manager/2 Version 1.0 command line equivalent 
  5496. for this command. You can use an ASCII editor to view the \CMLIB\CM.LOG file or 
  5497. use the following procedure to view the audit trail: 
  5498.  
  5499.   1. Select Communications Manager/2 from the desktop. 
  5500.  
  5501.      The Communications Manager/2 window appears. 
  5502.  
  5503.   2. Select Communications Manager Setup from the Communications Manager/2 
  5504.      window. 
  5505.  
  5506.      The Communications Manager Setup window appears. 
  5507.  
  5508.   3. Select Options from the menu bar of the Communications Manager Setup 
  5509.      window and select View audit trail.... 
  5510.  
  5511.      The View Audit Trail window appears. 
  5512.  
  5513.  
  5514. ΓòÉΓòÉΓòÉ 6. CONFIG.SYS Usage ΓòÉΓòÉΓòÉ
  5515.  
  5516. This appendix describes the Communications Manager device drivers. Each 
  5517. description includes the purpose of the device driver, a syntax diagram, a list 
  5518. of parameters, a discussion of the options, remarks, and examples. 
  5519.  
  5520. A device driver is a file that contains code which enables the operating system 
  5521. to recognize a device and correctly process information received from or sent 
  5522. to that device. The operating system loads default device drivers; however, you 
  5523. can replace these or add other devices by adding DEVICE statements in your 
  5524. CONFIG.SYS file. 
  5525.  
  5526. The CONFIG.SYS file is read only during system startup; therefore, any changes 
  5527. you make to the CONFIG.SYS file will not take affect until you restart your 
  5528. system. 
  5529.  
  5530. DEVICE statements are processed in the order in which they occur in the 
  5531. CONFIG.SYS file.  Some device drivers have prerequisite device drivers.  Read 
  5532. the "Remarks" section for each device driver for important information 
  5533. regarding placement of the DEVICE statement. 
  5534.  
  5535. For more information on installation, refer to Workstation Installation and 
  5536. Configuration Guide and IBM Communications Manager/2 Version 1.0 Network 
  5537. Administration and Subsystem Management Guide. 
  5538.  
  5539. For more information on configuration, refer to Configuration Guide. 
  5540.  
  5541. For more information on device drivers, refer to OS/2 Command Reference. 
  5542.  
  5543. To view the list of device drivers, press Ctrl+C to return to the Contents. 
  5544. Next, select the plus sign (+) or press the + key. 
  5545.  
  5546.  
  5547. ΓòÉΓòÉΓòÉ 6.1. ACSLANDD.SYS ΓòÉΓòÉΓòÉ
  5548.  
  5549. ACSLANDD.SYS 
  5550.  
  5551.  Purpose 
  5552.  
  5553.           Allows access to the 802.2 link level control (LLC) API for 
  5554.           Communications Manager SNA support. 
  5555.  
  5556.  Syntax 
  5557.  
  5558.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇACSLANDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5559.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5560.  
  5561.  
  5562. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5563.  
  5564. The drive where the ACSLANDD.SYS file resides. Specify this drive only if it is 
  5565. not the default drive. 
  5566.  
  5567.  
  5568. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5569.  
  5570. The path designator that specifies where the ACSLANDD.SYS file resides. Use 
  5571. this path only if the file is not in the default path. 
  5572.  
  5573.  
  5574. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5575.  
  5576. This device driver statement is necessary to use any 802.2 supported LAN type. 
  5577.  
  5578. This device driver statement can be placed anywhere in the CONFIG.SYS file. 
  5579.  
  5580.  
  5581. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5582.  
  5583. Use the following statement in the CONFIG.SYS file to load this device driver. 
  5584.  
  5585.      DEVICE=C:\CMLIB\ACSLANDD.SYS
  5586.  
  5587.  
  5588. ΓòÉΓòÉΓòÉ 6.2. ASYNCDDA.SYS ΓòÉΓòÉΓòÉ
  5589.  
  5590. ASYNCDDA.SYS 
  5591.  
  5592.  Purpose 
  5593.  
  5594.           Loads the Asynchronous Communications Device Interface (ACDI) on an 
  5595.           IBM Personal Computer AT. 
  5596.  
  5597.  Syntax 
  5598.  
  5599.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇASYNCDDA.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5600.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5601.  
  5602.  
  5603. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5604.  
  5605. The drive where the ASYNCDDA.SYS file resides. Specify this drive only if it is 
  5606. not the default drive. 
  5607.  
  5608.  
  5609. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5610.  
  5611. The path designator that specifies where the ASYNCDDA.SYS file resides. Use 
  5612. this path only if the file is not in the default path. 
  5613.  
  5614.  
  5615. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5616.  
  5617. ASYNCDDA.SYS allows OS/2 application programs to use serial COM ports through 
  5618. ACDI. 
  5619.  
  5620. If a device driver that supports any one of the serial ports (COM1, COM2, or 
  5621. COM3) is installed by a DEVICE statement that precedes a DEVICE=ASYNCDDA.SYS 
  5622. statement, the port is unavailable to ASYNCDDA.SYS. 
  5623.  
  5624. If the DEVICE=ASYNCDDA.SYS statement comes prior to a DEVICE statement 
  5625. supporting a mouse, the DEVICE=ASYNCDDA.SYS statement is overridden without any 
  5626. warning or message. 
  5627.  
  5628. For an IBM Personal Computer AT equipped with an INS-8250 or INS-8250B serial 
  5629. device, the DEVICE=ASYNCDDA.SYS statement must precede the DEVICE=COMx.SYS 
  5630. statement in the CONFIG.SYS file or the COM port is unavailable for use by the 
  5631. device driver. 
  5632.  
  5633. For an IBM Personal Computer AT, you cannot use the ASYNCDDA.SYS and SDLCDD.SYS 
  5634. device drivers at the same time. 
  5635.  
  5636. ASYNCDDA.SYS supports COM1 and COM2 only. 
  5637.  
  5638. This device driver uses storage that can also be used for DOS mode. Do not use 
  5639. this device driver unless you require its function since it reduces the amount 
  5640. of storage available to run OS/2 application programs. 
  5641.  
  5642.  
  5643. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5644.  
  5645. Use the following statement in the CONFIG.SYS file to load ACDI support on an 
  5646. IBM Personal Computer AT: 
  5647.  
  5648.      DEVICE=C:\CMLIB\ASYNCDDA.SYS
  5649.  
  5650.  
  5651. ΓòÉΓòÉΓòÉ 6.3. ASYNCDDB.SYS ΓòÉΓòÉΓòÉ
  5652.  
  5653. ASYNCDDB.SYS 
  5654.  
  5655.  Purpose 
  5656.  
  5657.           To load the Asynchronous Communications Device Interface (ACDI) on an 
  5658.           IBM Personal System/2. 
  5659.  
  5660.  Syntax 
  5661.  
  5662.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇASYNCDDB.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5663.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5664.  
  5665.  
  5666. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5667.  
  5668. The drive where the ASYNCDDB.SYS file resides. Specify this drive only if it is 
  5669. not the default drive. 
  5670.  
  5671.  
  5672. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5673.  
  5674. The path designator that specifies where the ASYNCDDB.SYS file resides. Use 
  5675. this path only if the file is not in the default path. 
  5676.  
  5677.  
  5678. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5679.  
  5680. Allows OS/2 application programs to use serial COM ports through the 
  5681. Asynchronous Communications Device Interface (ACDI). 
  5682.  
  5683. ASYNCDDB.SYS supports COM1, COM2, and COM3. 
  5684.  
  5685.  
  5686. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5687.  
  5688. Use the following statement in the CONFIG.SYS file to load ACDI support on an 
  5689. IBM Personal System/2. 
  5690.  
  5691. ASYNCDDB.SYS allows OS/2 application programs to use serial COM ports through 
  5692. ACDI. 
  5693.  
  5694. If a device driver that supports any one of the serial ports (COM1, COM2, or 
  5695. COM3) is installed by a DEVICE statement that precedes a DEVICE=ASYNCDDB.SYS 
  5696. statement, the port is unavailable to ASYNCDDB.SYS. 
  5697.  
  5698. If the DEVICE=ASYNCDDB.SYS statement comes prior to a DEVICE statement 
  5699. supporting a mouse, the DEVICE=ASYNCDDB.SYS statement is overridden without any 
  5700. warning or message. 
  5701.  
  5702. This device driver works for any IBM Personal System/2 but it does not take 
  5703. advantage of Direct Memory Access (DMA) even if you have DMA hardware available 
  5704. and active. 
  5705.  
  5706.      DEVICE=C:\CMLIB\ASYNCDDB.SYS
  5707.  
  5708.  
  5709. ΓòÉΓòÉΓòÉ 6.4. ASYNCDDC.SYS ΓòÉΓòÉΓòÉ
  5710.  
  5711. ASYNCDDC.SYS 
  5712.  
  5713.  Purpose 
  5714.  
  5715.           ASYNCDDC.SYS allows OS/2 application programs to use serial COM ports 
  5716.           through ACDI. 
  5717.  
  5718.  Syntax 
  5719.  
  5720.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇASYNCDDC.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5721.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5722.  
  5723.  
  5724. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5725.  
  5726. The drive where the ASYNCDDC.SYS file resides. Specify this drive only if it is 
  5727. not the default drive. 
  5728.  
  5729.  
  5730. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5731.  
  5732. The path designator that specifies where the ASYNCDDC.SYS file resides. Use 
  5733. this path only if the file is not in the default path. 
  5734.  
  5735.  
  5736. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5737.  
  5738. If a device driver that supports any one of the serial ports (COM1, COM2, or 
  5739. COM3) is installed by a DEVICE statement that precedes a DEVICE=ASYNCDDC.SYS 
  5740. statement, the port is unavailable to ASYNCDDC.SYS. 
  5741.  
  5742. If the DEVICE=ASYNCDDC.SYS statement comes prior to a DEVICE statement 
  5743. supporting a mouse, the DEVICE=ASYNCDDC.SYS statement is overridden without any 
  5744. warning or message. 
  5745.  
  5746. If you have an IBM Personal System/2 and have Direct Memory Access (DMA) 
  5747. hardware available and active, make sure that the ASYNCDDC.SYS device driver 
  5748. statement is located in your CONFIG.SYS file.  DMA hardware must be enabled by 
  5749. using the IBM Personal System/2 Reference Diskette.  If the DMA hardware is not 
  5750. available and active, you will not be able to use ACDI. 
  5751.  
  5752. Note:  Switching to the ASYNCDDB.SYS device driver will allow you to use ACDI 
  5753.        without utilizing DMA. 
  5754.  
  5755.  
  5756. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5757.  
  5758.      DEVICE=C:\CMLIB\ASYNCDDC.SYS
  5759.  
  5760.  
  5761. ΓòÉΓòÉΓòÉ 6.5. ASYNCDDE.SYS ΓòÉΓòÉΓòÉ
  5762.  
  5763. ASYNCDDE.SYS 
  5764.  
  5765.  Purpose 
  5766.  
  5767.           ASYNCDDE.SYS allows you to use ACDI Redirection. 
  5768.  
  5769.  Syntax 
  5770.  
  5771.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇASYNCDDE.SYSΓöÇΓöÇserver_nameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5772.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5773.  
  5774.  
  5775. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5776.  
  5777. The drive where the ASYCDDE.SYS file resides. Specify this drive only if it is 
  5778. not the default drive. 
  5779.  
  5780.  
  5781. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5782.  
  5783. The path designator that specifies where the ASYCDDE.SYS file resides. Use this 
  5784. path only if the file is not in the default path. 
  5785.  
  5786.  
  5787. ΓòÉΓòÉΓòÉ <hidden> server_name ΓòÉΓòÉΓòÉ
  5788.  
  5789. A required parameter that specifies a valid Local Area Network Asynchronous 
  5790. Communications Server (LANACS) server name.  This 1- to 8-character name must 
  5791. be the same name as the LANACS server on your network. 
  5792.  
  5793.  
  5794. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5795.  
  5796. If you want to use ACDI Redirection, make sure that the ASYNCDDE.SYS device 
  5797. driver statement is located in your CONFIG.SYS file. 
  5798.  
  5799. ASYNCDDE.SYS will not load unless a valid LANACS server name is specified. 
  5800.  
  5801.  
  5802. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5803.  
  5804.      DEVICE=C:\CMLIB\ASYNCDDE.SYS server
  5805.  
  5806.  
  5807. ΓòÉΓòÉΓòÉ 6.6. CMKFMDD.SYS ΓòÉΓòÉΓòÉ
  5808.  
  5809. CMKFMDD.SYS 
  5810.  
  5811.  Purpose 
  5812.  
  5813.           Manages the locked storage that is used to contain control blocks 
  5814.           used for communication between the SNA subsystem and DLCs on OS/2 1.0 
  5815.           and above. 
  5816.  
  5817.  Syntax 
  5818.  
  5819.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMKFMDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5820.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5821.  
  5822.  
  5823. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5824.  
  5825. The drive where the CMKFMDD.SYS file resides. Specify this drive only if it is 
  5826. not the default drive. 
  5827.  
  5828.  
  5829. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5830.  
  5831. The path designator that specifies where the CMKFMDD.SYS file resides. Use this 
  5832. path only if the file is not in the default path. 
  5833.  
  5834.  
  5835. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5836.  
  5837. This device driver locks and unlocks segments used to contain frames and 
  5838. Command Control Blocks (CCBs).  It also provides a ring 0 interface for other 
  5839. device drivers to request and free frames and CCBs. 
  5840.  
  5841.  
  5842. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5843.  
  5844. Use the following statement in the CONFIG.SYS file to load this device driver. 
  5845.  
  5846.      DEVICE=C:\CMLIB\CMKFMDD.SYS
  5847.  
  5848.  
  5849. ΓòÉΓòÉΓòÉ 6.7. CMKFMDE.SYS ΓòÉΓòÉΓòÉ
  5850.  
  5851. CMKFMDE.SYS 
  5852.  
  5853.  Purpose 
  5854.  
  5855.           Manages the locked storage that is used to contain control blocks 
  5856.           used for communication between the SNA subsystem and DLCs on OS/2 2.0 
  5857.           and above. 
  5858.  
  5859.  Syntax 
  5860.  
  5861.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇCMKFMDE.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5862.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5863.  
  5864.  
  5865. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5866.  
  5867. The drive where the CMKFMDE.SYS file resides. Specify this drive only if it is 
  5868. not the default drive. 
  5869.  
  5870.  
  5871. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5872.  
  5873. The path designator that specifies where the CMKFMDE.SYS file resides. Use this 
  5874. path only if the file is not in the default path. 
  5875.  
  5876.  
  5877. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5878.  
  5879. This device driver locks and unlocks segments used to contain frames and 
  5880. Command Control Blocks (CCBs).  It also provides a ring 0 interface for other 
  5881. device drivers to request and free frames and CCBs. 
  5882.  
  5883.  
  5884. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5885.  
  5886. Use the following statement in the CONFIG.SYS file to load this device driver. 
  5887.  
  5888.      DEVICE=C:\CMLIB\CMKFMDE.SYS
  5889.  
  5890.  
  5891. ΓòÉΓòÉΓòÉ 6.8. DFTDD.SYS ΓòÉΓòÉΓòÉ
  5892.  
  5893. DFTDD.SYS 
  5894.  
  5895.  Purpose 
  5896.  
  5897.           Allows Communications Manager 3270 emulation (DFT) to access 3270 
  5898.           Emulation adapter cards or PCMCIA adapter card for use in 
  5899.           communicating with 3274/3174 control units in DFT mode, as well as 
  5900.           the System/9370. 
  5901.  
  5902.  Syntax 
  5903.  
  5904.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇDFTDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5905.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5906.  
  5907.  
  5908. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5909.  
  5910. The drive where the CMKFMDE.SYS file resides. Specify this drive only if it is 
  5911. not the default drive. 
  5912.  
  5913.  
  5914. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5915.  
  5916. The path designator that specifies where the CMKFMDE.SYS file resides. Use this 
  5917. path only if the file is not in the default path. 
  5918.  
  5919.  
  5920. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5921.  
  5922. For the IBM Personal Computer AT, use the 3278/79 Emulation Adapter and the 
  5923. Advanced 3278/79 Emulation Adapter. 
  5924.  
  5925. For the supported IBM Personal System/2 models, use the IBM 3270 Connection 
  5926. Adapter or 3270 PCMCIA card. 
  5927.  
  5928. This device driver is used with coaxial connections. 
  5929.  
  5930.  
  5931. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5932.  
  5933. Use the following statement in the CONFIG.SYS file to load this device driver. 
  5934.  
  5935.      DEVICE=C:\CMLIB\DFTDD.SYS
  5936.  
  5937.  
  5938. ΓòÉΓòÉΓòÉ 6.9. GENMSGDD.OS2 ΓòÉΓòÉΓòÉ
  5939.  
  5940. GENMSGDD.OS2 
  5941.  
  5942.  Purpose 
  5943.  
  5944.           Allows the ISDN device drivers to interface with FFST/2. 
  5945.  
  5946.  Syntax 
  5947.  
  5948.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇGENMSGDD.OS2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5949.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5950.  
  5951.  
  5952. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5953.  
  5954. The drive where the GENMSGDD.OS2 file resides. Specify this drive only if it is 
  5955. not the default drive. 
  5956.  
  5957.  
  5958. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5959.  
  5960. The path designator that specifies where the GENMSGDD.OS2 file resides. Use 
  5961. this path only if the file is not in the default path. 
  5962.  
  5963.  
  5964. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  5965.  
  5966. Placement of this device driver must be before the PROTMAN.OS2 statement. 
  5967. (DEVICE=x:\IBMCOM\PROTMAN.OS2) 
  5968.  
  5969.  
  5970. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  5971.  
  5972.      DEVICE=C:\CMLIB\GENMSGDD.OS2
  5973.  
  5974.  
  5975. ΓòÉΓòÉΓòÉ 6.10. GENMSGGEX.EXE ΓòÉΓòÉΓòÉ
  5976.  
  5977. GENMSGGEX.EXE 
  5978.  
  5979.  Purpose 
  5980.  
  5981.           Provides a thread for the message device driver to interface with 
  5982.           FFST/2. 
  5983.  
  5984.  Syntax 
  5985.  
  5986.                     >>ΓöÇΓöÇRUN=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇGENMSGEX.EXEΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  5987.                          ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  5988.  
  5989.  
  5990. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  5991.  
  5992. The drive where the GENMSGGEX.EXE file resides. Specify this drive only if it 
  5993. is not the default drive. 
  5994.  
  5995.  
  5996. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  5997.  
  5998. The path designator that specifies where the GENMSGGEX.EXE file resides. Use 
  5999. this path only if the file is not in the default path. 
  6000.  
  6001.  
  6002. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6003.  
  6004. Both GENMSGDD.OS2 and GENMSGEX.EXE must be present for device driver message 
  6005. support. 
  6006.  
  6007.  
  6008. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6009.  
  6010.      RUN=C:\CMLIB\GENMSGEX.EXE
  6011.  
  6012.  
  6013. ΓòÉΓòÉΓòÉ 6.11. ICARICIO.SYS ΓòÉΓòÉΓòÉ
  6014.  
  6015. ICARICIO.SYS 
  6016.  
  6017.  Purpose 
  6018.  
  6019.           Allows Communications Manager X.25 support to access the IBM X.25 
  6020.           Interface Co-Processor/2 adapter for use in communicating with X.25 
  6021.           networks. 
  6022.  
  6023.  Syntax 
  6024.  
  6025.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇICARICIO.SYSΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6026.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ         ΓööΓöÇIΓöÇΓöÇΓöÇ(card number)ΓöÇΓöÿ
  6027.  
  6028.  
  6029. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6030.  
  6031. The drive where the ICARICIO.SYS file resides. Specify this drive only if it is 
  6032. not the default drive. 
  6033.  
  6034.  
  6035. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6036.  
  6037. The path designator that specifies where the ICARICIO.SYS file resides. Use 
  6038. this path only if the file is not in the default path. 
  6039.  
  6040.  
  6041. ΓòÉΓòÉΓòÉ <hidden> I (card number) ΓòÉΓòÉΓòÉ
  6042.  
  6043. ICARICIO.SYS provides the capability to ignore certain Realtime Interface 
  6044. Co-Processor (ARTIC) cards.  Using this parameter causes cards with the 
  6045. specified card numbers to be ignored. 
  6046.  
  6047. Note:  The ARTIC card at Base I/O address 2A0 has a physical card number of 0. 
  6048.  
  6049.           If you want to ignore more than one ARTIC card, separate the physical 
  6050.           card numbers by either commas or spaces.  The only valid entries for 
  6051.           the ignore parameter are 0 through 9 and A through F. 
  6052.  
  6053.           Note:  An ARTIC card that appears in the ICAPARM.PRM (parameter) file 
  6054.                  is not ignored.  If the card you want to ignore appears in the 
  6055.                  ICAPARM.PRM file, that card's entry must be removed. 
  6056.  
  6057.  
  6058. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6059.  
  6060. Provides an application programming interface (API) Co-Processor Multiport/2 
  6061. adapter. 
  6062.  
  6063. This device driver is for use with IBM Personal System/2 models 50Z, 55SX, 60, 
  6064. 70, P70, and 80. 
  6065.  
  6066.  
  6067. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6068.  
  6069.      DEVICE=C:\CMLIB\ICARICIO.SYS
  6070.  
  6071. To ignore physical cards 0 and 2, but not 1, type the following line in your 
  6072. CONFIG.SYS file: 
  6073.  
  6074.      DEVICE=C:\CMLIB\ICARICIO.SYS I(0,2)
  6075.  
  6076.  
  6077. ΓòÉΓòÉΓòÉ 6.12. IDLCDD.SYS ΓòÉΓòÉΓòÉ
  6078.  
  6079. IDLCDD.SYS 
  6080.  
  6081.  Purpose 
  6082.  
  6083.           Allows access to the IDLC protocol driver for Communications Manager 
  6084.           SNA support. 
  6085.  
  6086.  Syntax 
  6087.  
  6088.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇIDLCDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6089.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6090.  
  6091.  
  6092. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6093.  
  6094. The drive where the IDLCDD.SYS file resides. Specify this drive only if it is 
  6095. not the default drive. 
  6096.  
  6097.  
  6098. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6099.  
  6100. The path designator that specifies where the IDLCDD.SYS file resides. Use this 
  6101. path only if the file is not in the default path. 
  6102.  
  6103.  
  6104. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6105.  
  6106. Use this device driver statement when using IDLC over IDSN. 
  6107.  
  6108. This statement must follow IDLCPD.SYS in your CONFIG.SYS file. 
  6109.  
  6110.  
  6111. ΓòÉΓòÉΓòÉ <hidden> Exampes ΓòÉΓòÉΓòÉ
  6112.  
  6113.      DEVICE=C:\CMLIB\IDLCDD.SYS
  6114.  
  6115.  
  6116. ΓòÉΓòÉΓòÉ 6.13. IDLCPD.SYS ΓòÉΓòÉΓòÉ
  6117.  
  6118. IDLCPD.SYS 
  6119.  
  6120.  Purpose 
  6121.  
  6122.           Provides CCITT Q.922 protocol support. 
  6123.  
  6124.  Syntax 
  6125.  
  6126.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇIDLCPD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6127.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6128.  
  6129.  
  6130. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6131.  
  6132. The drive where the IDLCPD.SYS file resides. Specify this drive only if it is 
  6133. not the default drive. 
  6134.  
  6135.  
  6136. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6137.  
  6138. The path designator that specifies where the IDLCPD.SYS file resides. Use this 
  6139. path only if the file is not in the default path. 
  6140.  
  6141.  
  6142. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6143.  
  6144. IDLCPD.SYS must be placed after the PROTMAN.OS2 statement in your CONFIG.SYS 
  6145. file. 
  6146.  
  6147. Use this device driver statement when using IDLC over IDSN. 
  6148.  
  6149.  
  6150. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6151.  
  6152.      DEVICE=C:\CMLIB\IDLCPD.SYS
  6153.  
  6154.  
  6155. ΓòÉΓòÉΓòÉ 6.14. IDLCVMAC.SYS ΓòÉΓòÉΓòÉ
  6156.  
  6157. IDLCVMAC.SYS 
  6158.  
  6159.  Purpose 
  6160.  
  6161.           Links IDLC logical adapters to the data channels for ISDN when the 
  6162.           call is connected. 
  6163.  
  6164.  Syntax 
  6165.  
  6166.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇIDLCVMAC.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6167.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6168.  
  6169.  
  6170. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6171.  
  6172. The drive where the IDLCVMAC.SYS file resides. Specify this drive only if it is 
  6173. not the default drive. 
  6174.  
  6175.  
  6176. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6177.  
  6178. The path designator that specifies where the IDLCVMAC.SYS file resides. Use 
  6179. this path only if the file is not in the default path. 
  6180.  
  6181.  
  6182. ΓòÉΓòÉΓòÉ <hidden> Remars ΓòÉΓòÉΓòÉ
  6183.  
  6184. Use this device driver statement when you are using IDLC over ISDN. 
  6185.  
  6186. This device driver statement must be after the IDLCDD.OS2 statement in the 
  6187. CONFIG.SYS file. 
  6188.  
  6189.  
  6190. ΓòÉΓòÉΓòÉ <hidden> Exampes ΓòÉΓòÉΓòÉ
  6191.  
  6192.      DEVICE=C:\CMLIB\IDLCVMAC.SYS
  6193.  
  6194.  
  6195. ΓòÉΓòÉΓòÉ 6.15. LANVMAC.SYS ΓòÉΓòÉΓòÉ
  6196.  
  6197. LANVMAC.SYS 
  6198.  
  6199.  Purpose 
  6200.  
  6201.           Links LAN logical adapters to the data channels for ISDN when the 
  6202.           call is connected. 
  6203.  
  6204.  Syntax 
  6205.  
  6206.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇLANVMAC.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6207.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6208.  
  6209.  
  6210. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6211.  
  6212. The drive where the LANVMAC.SYS file resides. Specify this drive only if it is 
  6213. not the default drive. 
  6214.  
  6215.  
  6216. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6217.  
  6218. The path designator that specifies where the LANVMAC.SYS file resides. Use this 
  6219. path only if the file is not in the default path. 
  6220.  
  6221.  
  6222. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6223.  
  6224. Use this device driver statement when you are using LANs over ISDN. 
  6225.  
  6226. This device driver statement must be after the PROTMAN.OS2 statement in the 
  6227. CONFIG.SYS file. 
  6228.  
  6229. To install LANVMAC.SYS in the network information file (.NIF), type LAPS at the 
  6230. OS/2 prompt, select install, and insert Communications Manager diskette number 
  6231. 6. 
  6232.  
  6233. LAPS configuration places this statement in your CONFIG.SYS file after you 
  6234. configure Communications Manager. 
  6235.  
  6236.  
  6237. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6238.  
  6239.      DEVICE=C:\CMLIB\LANVMAC.SYS
  6240.  
  6241.  
  6242. ΓòÉΓòÉΓòÉ 6.16. R0CSDD.SYS ΓòÉΓòÉΓòÉ
  6243.  
  6244. R0CSDD.SYS 
  6245.  
  6246.  Purpose 
  6247.  
  6248.           Analyzes your workstation's processing capabilities and supplies that 
  6249.           information to other device drivers for interaction between software 
  6250.           and hardware. 
  6251.  
  6252.  Syntax 
  6253.  
  6254.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇR0CSDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6255.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6256.  
  6257.  
  6258. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6259.  
  6260. The drive where the R0CSDD.SYS file resides. Specify this drive only if it is 
  6261. not the default drive. 
  6262.  
  6263.  
  6264. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6265.  
  6266. The path designator that specifies where the R0CSDD.SYS file resides. Use this 
  6267. path only if the file is not in the default path. 
  6268.  
  6269.  
  6270. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6271.  
  6272. This device driver must be installed for all configurations and it must be 
  6273. before the SDLCDD.SYS device driver statement in your CONFIG.SYS file. 
  6274.  
  6275. Note:  The second digit in R0csdd is a zero. 
  6276.  
  6277.  
  6278. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6279.  
  6280.      DEVICE=C:\CMLIB\R0CSDD.SYS
  6281.  
  6282.  
  6283. ΓòÉΓòÉΓòÉ 6.17. RUNX25.EXE ΓòÉΓòÉΓòÉ
  6284.  
  6285. RUNX25.EXE 
  6286.  
  6287.  Purpose 
  6288.  
  6289.           Provides an OS/2 thread of execution for X25DD.SYS. 
  6290.  
  6291.  Syntax 
  6292.  
  6293.                     >>ΓöÇΓöÇRUN=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇRUNX25.EXEΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6294.                          ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ        ΓööΓöÇ/NΓöÇΓöÇΓöÇΓöÿ
  6295.  
  6296.  
  6297. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6298.  
  6299. The drive where the RUNX25.EXE file resides. Specify this drive only if it is 
  6300. not the default drive. 
  6301.  
  6302.  
  6303. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6304.  
  6305. The path designator that specifies where the RUNX25.EXE file resides. Use this 
  6306. path only if the file is not in the default path. 
  6307.  
  6308.  
  6309. ΓòÉΓòÉΓòÉ <hidden> /N ΓòÉΓòÉΓòÉ
  6310.  
  6311. Instructs RUNX25.EXE to not issue a NETBIND to PROTMAN.OS2.  This is an 
  6312. optional parameter.  It is not needed even if another process (example: 
  6313. NETBIND.EXE) issues a NETBIND to PROTMAN.OS2.  It is provided in case future 
  6314. releases of PROTMAN.OS2 do not handle multiple NETBIND instructions. 
  6315.  
  6316.  
  6317. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6318.  
  6319. RUNX25.EXE must appear after the X25DD.SYS statement in your CONFIG.SYS file. 
  6320.  
  6321.  
  6322. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6323.  
  6324.      RUN=C:\CMLIB\RUNX25.EXE
  6325.  
  6326.      RUN=C:\CMLIB\RUNX25.EXE /N
  6327.  
  6328.  
  6329. ΓòÉΓòÉΓòÉ 6.18. SDLCDD.SYS ΓòÉΓòÉΓòÉ
  6330.  
  6331. SDLCDD.SYS 
  6332.  
  6333.  Purpose 
  6334.  
  6335.           Installs the Synchronous Data Link Control (SDLC) device driver. 
  6336.  
  6337.  Syntax 
  6338.  
  6339.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇSDLCDD.SYSΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6340.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ        Γö£ΓöÇNΓöÇΓöÇΓöÇΓöÇΓöñ  Γö£ΓöÇ0ΓöÇΓöÇΓöÇΓöÇΓöñ
  6341.                                            ΓööΓöÇSΓöÇΓöÇΓöÇΓöÇΓöÿ  Γö£ΓöÇ1ΓöÇΓöÇΓöÇΓöÇΓöñ
  6342.                                                 ΓööΓöÇBΓöÇΓöÇΓöÇΓöÇΓöÿ
  6343.  
  6344.  
  6345. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6346.  
  6347. The drive where the SDLCDD.SYS file resides. Specify this drive only if it is 
  6348. not the default drive. 
  6349.  
  6350.  
  6351. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6352.  
  6353. The path designator that specifies where the SDLCDD.SYS file resides. Use this 
  6354. path only if the file is not in the default path. 
  6355.  
  6356.  
  6357. ΓòÉΓòÉΓòÉ <hidden> N ΓòÉΓòÉΓòÉ
  6358.  
  6359. Specifies that interrupts should not be shared. 
  6360.  
  6361.  
  6362. ΓòÉΓòÉΓòÉ <hidden> S ΓòÉΓòÉΓòÉ
  6363.  
  6364. Specifies that interrupts should be shared. 
  6365.  
  6366.  
  6367. ΓòÉΓòÉΓòÉ <hidden> 0 ΓòÉΓòÉΓòÉ
  6368.  
  6369. Specifies that adapter 0 should be enabled. 
  6370.  
  6371.  
  6372. ΓòÉΓòÉΓòÉ <hidden> 1 ΓòÉΓòÉΓòÉ
  6373.  
  6374. Specifies that adapter 1 should be enabled. 
  6375.  
  6376.  
  6377. ΓòÉΓòÉΓòÉ <hidden> B ΓòÉΓòÉΓòÉ
  6378.  
  6379. Specifies that both adapter 0 and adapter 1 should be enabled. 
  6380.  
  6381.  
  6382. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6383.  
  6384. Allows OS/2 application programs or system programs (such as Communications 
  6385. Manager 3270 emulation) to use SDLC devices for communications. 
  6386.  
  6387. This device driver requires that the R0CSDD.SYS device driver also be loaded. 
  6388. The SDLCDD.SYS statement must come after the R0CSDD.SYS statement in your 
  6389. CONFIG.SYS file. 
  6390.  
  6391. For the IBM Personal Computer AT/ISA bus machines, you cannot use the 
  6392. SDLCDD.SYS device driver at the same time as any serial device that uses 
  6393. interrupt levels 3 or 4, because interrupts cannot be shared.  The SDLC adapter 
  6394. card and MPA cards are restricted to use interrupt levels 3 and 4. If you need 
  6395. to use either of the preceding (for example, 3270 emulation (SDLC)), you must 
  6396. maintain separate copies of the CONFIG.SYS file; one for each device driver. 
  6397. The system must be restarted (press the Ctrl+Alt+Del keys) after the 
  6398. appropriate CONFIG.SYS file is placed in the root directory. 
  6399.  
  6400. If only one adapter is installed, it can be set to any of the valid values 
  6401. described in the following instructions.  It does not have to be set to SDLC_1, 
  6402. Arb_1. If two adapters are installed, they must be set as follows: 
  6403.  
  6404.           o To enable adapter 0, the reference diskette setting for the adapter 
  6405.             must be SDLC_1, Arb_1. 
  6406.  
  6407.           o To enable adapter 1, the reference diskette setting for the adapter 
  6408.             must be SDLC_2 with an arbitration level of 4 or greater (for 
  6409.             example, SDLC_2, Arb_7.). 
  6410.  
  6411.           If no adapters with valid settings are found, the device driver will 
  6412.           not be installed and "device not installed" will be displayed when 
  6413.           you start your system.  If at least one adapter with valid settings 
  6414.           is found, the device driver will be installed and only the 
  6415.           appropriate adapter will be enabled. 
  6416.  
  6417.  
  6418. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6419.  
  6420. Use the following statement to install the SDLC device driver on an IBM 
  6421. Personal Computer AT. 
  6422.  
  6423.      DEVICE=C:\CMLIB\SDLCDD.SYS
  6424.  
  6425. Use the following statement to install SDLC device driver for a primary 
  6426. adapter, on the supported IBM Personal System/2 models, with interrupt levels 
  6427. for SDLC specified so they can be shared. 
  6428.  
  6429.      DEVICE=C:\CMLIB\SDLCDD.SYS S 0
  6430.  
  6431.  
  6432. ΓòÉΓòÉΓòÉ 6.19. SDLCSNET.OS2 ΓòÉΓòÉΓòÉ
  6433.  
  6434. SDLCSNET.OS2 
  6435.  
  6436.  Purpose 
  6437.  
  6438.           This device driver is used for the ISDN SDLC stack (NDIS network 
  6439.           standard). 
  6440.  
  6441.  Syntax 
  6442.  
  6443.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇSDLCSNET.OS2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6444.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6445.  
  6446.  
  6447. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6448.  
  6449. The drive where the SDLCSNET.OS2 file resides. Specify this drive only if it is 
  6450. not the default drive. 
  6451.  
  6452.  
  6453. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6454.  
  6455. The path designator that specifies where the SDLCSNET.OS2 file resides. Use 
  6456. this path only if the file is not in the default path. 
  6457.  
  6458.  
  6459. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6460.  
  6461. SDLCSNET.OS2 splits the protocol driver from the MAC level adapter code. 
  6462.  
  6463. This device driver is the SDLC NDIS-compliant protocol driver. 
  6464.  
  6465. This device driver statement must be placed after the PROTMAN.OS2 statement in 
  6466. the CONFIG.SYS file. 
  6467.  
  6468.  
  6469. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6470.  
  6471.      DEVICE=C:\CMLIB\SDLCSNET.OS2
  6472.  
  6473.  
  6474. ΓòÉΓòÉΓòÉ 6.20. SDLCVMAC.SYS ΓòÉΓòÉΓòÉ
  6475.  
  6476. SDLCVMAC.SYS 
  6477.  
  6478.  Purpose 
  6479.  
  6480.           Links SDLC logical adapters to the data channels for ISDN when the 
  6481.           call is connected. 
  6482.  
  6483.  Syntax 
  6484.  
  6485.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇSDLCVMAC.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6486.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6487.  
  6488.  
  6489. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6490.  
  6491. The drive where the SDLCVMAC.SYS file resides. Specify this drive only if it is 
  6492. not the default drive. 
  6493.  
  6494.  
  6495. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6496.  
  6497. The path designator that specifies where the SDLCVMAC.SYS file resides. Use 
  6498. this path only if the file is not in the default path. 
  6499.  
  6500.  
  6501. ΓòÉΓòÉΓòÉ <hidden> Remar s ΓòÉΓòÉΓòÉ
  6502.  
  6503. Use this device driver statement when you are using SDLC over ISDN. 
  6504.  
  6505. This device driver statement must be after the PROTMAN.OS2 statement in the 
  6506. CONFIG.SYS file. 
  6507.  
  6508.  
  6509. ΓòÉΓòÉΓòÉ <hidden> Examp es ΓòÉΓòÉΓòÉ
  6510.  
  6511.      DEVICE=C:\CMLIB\SDLCVMAC.SYS
  6512.  
  6513.  
  6514. ΓòÉΓòÉΓòÉ 6.21. T1P1SDD.SYS ΓòÉΓòÉΓòÉ
  6515.  
  6516. T1P1SDD.SYS 
  6517.  
  6518.  Purpose 
  6519.  
  6520.           Allows you to use the Twinaxial adapter on a workstation using an AT 
  6521.           bus. 
  6522.  
  6523.  Syntax 
  6524.  
  6525.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇT1P1SDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  6526.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6527.                     >ΓöÇΓöÇCFG=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilenameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6528.                          ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ
  6529.  
  6530.  
  6531. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6532.  
  6533. The drive where the T1P1SDD.SYS file resides. Specify this drive only if it is 
  6534. not the default drive. 
  6535.  
  6536.  
  6537. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6538.  
  6539. The path designator that specifies where the T1P1SDD.SYS file resides. Use this 
  6540. path only if the file is not in the default path. 
  6541.  
  6542.  
  6543. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  6544.  
  6545. Specifies the file name of your configuration.  You can also optionally specify 
  6546. the drive and path of your configuration (drive2, path2). 
  6547.  
  6548.  
  6549. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6550.  
  6551. Use the following statement to load the IBM Enhanced Emulator Adapter support 
  6552. on an IBM Personal Computer AT or an IBM Personal System/2 Model 30 286. 
  6553.  
  6554.   DEVICE=C:\CMLIB\T1P1SDD.SYS CFG=:\CMLIB\ACSCFG.CFG
  6555.  
  6556.  
  6557. ΓòÉΓòÉΓòÉ 6.22. T1P1NDD.SYS ΓòÉΓòÉΓòÉ
  6558.  
  6559. T1P1NDD.SYS 
  6560.  
  6561.  Purpose 
  6562.  
  6563.           Allows you to use the Twinaxial adapter on a workstation using a 
  6564.           Microchannel bus. 
  6565.  
  6566.  Syntax 
  6567.  
  6568.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇT1P1NDD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  6569.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6570.                     >ΓöÇΓöÇCFG=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇfilenameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6571.                          ΓööΓöÇdrive2ΓöÇΓöÿ  ΓööΓöÇpath2ΓöÇΓöÿ
  6572.  
  6573.  
  6574. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6575.  
  6576. The drive where the T1P1NDD.SYS file resides. Specify this drive only if it is 
  6577. not the default drive. 
  6578.  
  6579.  
  6580. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6581.  
  6582. The path designator that specifies where the T1P1NDD.SYS file resides. Use this 
  6583. path only if the file is not in the default path. 
  6584.  
  6585.  
  6586. ΓòÉΓòÉΓòÉ <hidden> filename ΓòÉΓòÉΓòÉ
  6587.  
  6588. Specifies the file name of your configuration.  You can also optionally specify 
  6589. the drive and path of your configuration (drive2, path2). 
  6590.  
  6591.  
  6592. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6593.  
  6594. Use the following statement to load the IBM System 36/38 Workstation Emulation 
  6595. Adapter/A support on IBM PS/2 models 50, 55, 60, 70, and 80. 
  6596.  
  6597.   DEVICE=C:\CMLIB\T1P1NDD.SYS CFG=C:\CMLIB\ACSCFG.CFG
  6598.  
  6599.  
  6600. ΓòÉΓòÉΓòÉ 6.23. VHAPI.OS2 ΓòÉΓòÉΓòÉ
  6601.  
  6602. VHAPI.OS2 
  6603.  
  6604.  Purpose 
  6605.  
  6606.           VHAPI.OS2 is the EHLLAPI virtual device driver (VDD). It allows 
  6607.           existing DOS EHLLAPI applications to run in the OS/2 virtual DOS 
  6608.           machine (VDM) environment. 
  6609.  
  6610.  Syntax 
  6611.  
  6612.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇVHAPI.OS2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6613.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6614.  
  6615.  
  6616. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6617.  
  6618. The drive where the VHAPI.OS2 file resides. Specify this drive only if it is 
  6619. not the default drive. 
  6620.  
  6621.  
  6622. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6623.  
  6624. The path designator that specifies where the VHAPI.OS2 file resides. Use this 
  6625. path only if the file is not in the default path. 
  6626.  
  6627.  
  6628. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6629.  
  6630. This device driver statement is not placed in the CONFIG.SYS file by default. 
  6631. To add this device driver statement, use VHAPINST.EXE. 
  6632.  
  6633. Refer to EHLLAPI Programming Reference for additional information. 
  6634.  
  6635.  
  6636. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6637.  
  6638.      DEVICE=C:\CMLIB\VHAPI.OS2
  6639.  
  6640.  Purpose 
  6641.  
  6642.           Provides frame layer (layer 2) and packet layer (layer 3) support for 
  6643.           the ISDN X.25 stack using the NDIS network standard. 
  6644.  
  6645.  Syntax 
  6646.  
  6647.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇX25DD.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6648.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6649.  
  6650.  
  6651. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6652.  
  6653. The drive where the X25DD.SYS file resides. Specify this drive only if it is 
  6654. not the default drive. 
  6655.  
  6656.  
  6657. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6658.  
  6659. The path designator that specifies where the X25DD.SYS file resides. Use this 
  6660. path only if the file is not in the default path. 
  6661.  
  6662.  
  6663. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6664.  
  6665. The X25DD.SYS device driver is required when using X.25 over ISDN. 
  6666.  
  6667. This device driver statement must appear after the PROTMAN.OS2 statement in 
  6668. your CONFIG.SYS file. 
  6669.  
  6670.  
  6671. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6672.  
  6673.      DEVICE=C:\CMLIB\X25DD.SYS
  6674.  
  6675.  
  6676. ΓòÉΓòÉΓòÉ 6.24. X25VMAC.SYS ΓòÉΓòÉΓòÉ
  6677.  
  6678. X25VMAC.SYS 
  6679.  
  6680.  Purpose 
  6681.  
  6682.           Links X25 logical adapters to the data channels for ISDN when the 
  6683.           call is connected. 
  6684.  
  6685.  Syntax 
  6686.  
  6687.                     >>ΓöÇΓöÇDEVICE=ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇX25VMAC.SYSΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  6688.                            ΓööΓöÇdriveΓöÇΓöÿ  ΓööΓöÇpathΓöÇΓöÿ
  6689.  
  6690.  
  6691. ΓòÉΓòÉΓòÉ <hidden> drive ΓòÉΓòÉΓòÉ
  6692.  
  6693. The drive where the X25VMAC.SYS file resides. Specify this drive only if it is 
  6694. not the default drive. 
  6695.  
  6696.  
  6697. ΓòÉΓòÉΓòÉ <hidden> path ΓòÉΓòÉΓòÉ
  6698.  
  6699. The path designator that specifies where the X25VMAC.SYS file resides. Use this 
  6700. path only if the file is not in the default path. 
  6701.  
  6702.  
  6703. ΓòÉΓòÉΓòÉ <hidden> Remarks ΓòÉΓòÉΓòÉ
  6704.  
  6705. Use this device driver statement when you are using X25 over ISDN. 
  6706.  
  6707. This device driver statement must be after the PROTMAN.OS2 statement in the 
  6708. CONFIG.SYS file. 
  6709.  
  6710.  
  6711. ΓòÉΓòÉΓòÉ <hidden> Examples ΓòÉΓòÉΓòÉ
  6712.  
  6713.      DEVICE=C:\CMLIB\X25VMAC.SYS
  6714.  
  6715.  
  6716. ΓòÉΓòÉΓòÉ 6.25. CONFIG.SYS Statements ΓòÉΓòÉΓòÉ
  6717.  
  6718. Use Required CONFIG.SYS parameters as a guide to the CONFIG.SYS statements 
  6719. required for various protocol types. 
  6720.  
  6721. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6722. Γöé      Required CONFIG.SYS parameters                    Γöé
  6723. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6724. Γöé PROTOCOL TYPE  Γöé PC TYPE        Γöé STATEMENTS IN CONFIG.SYS      Γöé
  6725. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6726. Γöé ACDI       Γöé All non-microchannel  Γöé DEVICE=d:\CMLIB\ASYNCDDA.SYS    Γöé
  6727. Γöé         Γöé types         Γöé                   Γöé
  6728. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6729. Γöé ACDI       Γöé Microchannel types   Γöé DEVICE=d:\CMLIB\ASYNCDDB.SYS    Γöé
  6730. Γöé         Γöé including Model 90 or Γöé                   Γöé
  6731. Γöé         Γöé 95 with ASYNCH DMA   Γöé                   Γöé
  6732. Γöé         Γöé disabled        Γöé                   Γöé
  6733. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6734. Γöé ACDI       Γöé Mod 90 or 95 with   Γöé DEVICE=d:\CMLIB\ASYNCDDC.SYS    Γöé
  6735. Γöé         Γöé ASYNC DMA enabled   Γöé                   Γöé
  6736. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6737. Γöé ACDI redi-    Γöé All types       Γöé DEVICE=d:\CMLIB\ASYNCDDE.SYS    Γöé
  6738. Γöé rection     Γöé            Γöé  server_name            Γöé
  6739. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6740. Γöé Coaxial (DFT)  Γöé All types       Γöé DEVICE=d:\CMLIB\DFTDD.SYS      Γöé
  6741. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6742. Γöé SDLC       Γöé All non-microchannel  Γöé DEVICE=d:\CMLIB\R0CSDD.SYS     Γöé
  6743. Γöé         Γöé types         Γöé DEVICE=d:\CMLIB\SDLCDD.SYS     Γöé
  6744. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6745. Γöé SDLC       Γöé All microchannel    Γöé DEVICE=d:\CMLIB\R0CSDD.SYS     Γöé
  6746. Γöé         Γöé types         Γöé DEVICE=d:\CMLIB\SDLCDD.SYS x y   Γöé
  6747. Γöé         Γöé            Γöé                   Γöé
  6748. Γöé         Γöé            Γöé x can be S or N.  y can be 0, 1,  Γöé
  6749. Γöé         Γöé            Γöé or B.  The defaults are N and 0.  Γöé
  6750. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6751. Γöé X.25       Γöé All microchannel    Γöé DEVICE=d:\CMLIB\ICARICIO.SYS x   Γöé
  6752. Γöé         Γöé types         Γöé                   Γöé
  6753. Γöé         Γöé            Γöé x is I(card numbers).  This is an  Γöé
  6754. Γöé         Γöé            Γöé optional parameter to ignore    Γöé
  6755. Γöé         Γöé            Γöé adapters.              Γöé
  6756. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6757. Γöé Twinaxial    Γöé All non-microchannel  Γöé DEVICE=d:\CMLIB\T1P1SDD.SYS     Γöé
  6758. Γöé         Γöé types; All micro-   Γöé  CFG=d:\CMLIB\filenam.CFG     Γöé
  6759. Γöé         Γöé channel types for   Γöé                   Γöé
  6760. Γöé         Γöé adapter #64G3494    Γöé                   Γöé
  6761. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6762. Γöé Twinaxial    Γöé All microchannel    Γöé DEVICE=d:\CMLIB\T1P1NDD.SYS     Γöé
  6763. Γöé         Γöé types for adapter   Γöé  CFG=d:\CMLIB\filenam.CFG     Γöé
  6764. Γöé         Γöé #69X6279        Γöé                   Γöé
  6765. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6766. Γöé LAN       Γöé All types       Γöé DEVICE=d:\IBMCOM\LANMSGDD.OS2    Γöé
  6767. Γöé         Γöé            Γöé DEVICE=d:\IBMCOM\PROTMAN.OS2    Γöé
  6768. Γöé         Γöé            Γöé  /I:d:\IMBCOM           Γöé
  6769. Γöé         Γöé            Γöé DEVICE=d:\IBMCOM\PROTOCOL\LANDD.SYSΓöé
  6770. Γöé         Γöé            Γöé DEVICE=d:\IBMCOM\MAC\MACDRIVER.SYS Γöé
  6771. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ACSLANDD.SYS    Γöé
  6772. Γöé         Γöé            Γöé RUN=d:\IBMCOM\LANMSGEX.EXE     Γöé
  6773. Γöé         Γöé            Γöé RUN=d:\IBMCOM\PROTOCOL\NETBIND.EXE Γöé
  6774. Γöé         Γöé            Γöé                   Γöé
  6775. Γöé         Γöé            Γöé (MACDRIVER.SYS is the appropriate  Γöé
  6776. Γöé         Γöé            Γöé network driver configured in LAPS) Γöé
  6777. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6778. Γöé SDLC using ISDN Γöé All types       Γöé DEVICE=d:\CMLIB\GENMSGDD.OS2    Γöé
  6779. Γöé         Γöé            Γöé DEVICE=d:\IBMCOM\PROTMAN.OS2    Γöé
  6780. Γöé         Γöé            Γöé  /I:d:\IMBCOM           Γöé
  6781. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\SDLCSNET.OS2    Γöé
  6782. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\SDLCVMAC.SYS    Γöé
  6783. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ISBARIC.SYS     Γöé
  6784. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ISBADD.SYS     Γöé
  6785. Γöé         Γöé            Γöé RUN=d:\CMLIB\GENMSGEX.EXE      Γöé
  6786. Γöé         Γöé            Γöé RUN=d:\IBMCOM\PROTOCOL\NETBIND.EXE Γöé
  6787. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6788. Γöé IDLC using ISDN Γöé All types       Γöé DEVICE=d:\CMLIB\GENMSGDD.OS2    Γöé
  6789. Γöé         Γöé            Γöé DEVICE=d:\IBMCOM\PROTMAN.OS2    Γöé
  6790. Γöé         Γöé            Γöé  /I:d:\IMBCOM           Γöé
  6791. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\IDLCPD.SYS     Γöé
  6792. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\IDLCDD.SYS     Γöé
  6793. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\IDLCVMAC.SYS    Γöé
  6794. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ISBARIC.SYS     Γöé
  6795. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ISBADD.SYS     Γöé
  6796. Γöé         Γöé            Γöé RUN=d:\CMLIB\GENMSGEX.EXE      Γöé
  6797. Γöé         Γöé            Γöé RUN=d:\IBMCOM\PROTOCOL\NETBIND.EXE Γöé
  6798. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6799. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6800. Γöé      Required CONFIG.SYS parameters                    Γöé
  6801. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6802. Γöé PROTOCOL TYPE  Γöé PC TYPE        Γöé STATEMENTS IN CONFIG.SYS      Γöé
  6803. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6804. Γöé X.25 using ISDN Γöé All types       Γöé DEVICE=d:\CMLIB\GENMSGDD.OS2    Γöé
  6805. Γöé         Γöé            Γöé DEVICE=d:\IBMCOM\PROTMAN.OS2    Γöé
  6806. Γöé         Γöé            Γöé  /I:d:\IMBCOM           Γöé
  6807. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\X25DD.SYS      Γöé
  6808. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\X25VMAC.SYS     Γöé
  6809. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ISBARIC.SYS     Γöé
  6810. Γöé         Γöé            Γöé DEVICE=d:\CMLIB\ISBADD.SYS     Γöé
  6811. Γöé         Γöé            Γöé RUN=d:\CMLIB\GENMSGEX.EXE      Γöé
  6812. Γöé         Γöé            Γöé RUN=d:\IBMCOM\PROTOCOL\NETBIND.EXE Γöé
  6813. Γöé         Γöé            Γöé RUN=d:\CMLIB\RUNX25.EXE /N     Γöé
  6814. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6815.  
  6816. Note: 
  6817.  
  6818.            1. d is the target drive. 
  6819.  
  6820.            2. When multiple statements are listed, they must be loaded in the 
  6821.               order listed. 
  6822.  
  6823.  
  6824. ΓòÉΓòÉΓòÉ 6.26. CONFIG.SYS Statements for APPN ΓòÉΓòÉΓòÉ
  6825.  
  6826. Add one of the following DEVICE= statements to CONFIG.SYS when installing 
  6827. APPC/APPN support for SDLC, X.25, Twinaxial, LAN, SDLC using ISDN, IDLC using 
  6828. ISDN, and X.25 using ISDN. For optimum performance, it should be the last 
  6829. device driver statement in CONFIG.SYS: 
  6830.  
  6831.           o DEVICE=d:\CMLIB\CMKFMDD.SYS 
  6832.  
  6833.           o DEVICE=d:\CMLIB\CMKFMDE.SYS 
  6834.