home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / tools / lu62 / debug / read.me < prev    next >
Encoding:
Text File  |  1996-07-10  |  5.6 KB  |  138 lines
  1. =====================================================================
  2. APL.EXE, APLMAIN.EXE description
  3. =====================================================================
  4.  
  5. This subdirectory contains a sample application program "apl.exe", an
  6. overlay module "aplmain.exe", two make project files for MSC 6.0 to make
  7. these modules, and full source code.
  8.  
  9. This application program is not "real" program product, it's just an
  10. example, main goal of it is demonstration of abilities of the LU 6.2
  11. module. In fact I use it to debug the LU6.2 module only.
  12.  
  13. There are two modules: "apl.exe" and "aplmail.exe". The "apl.exe" is a
  14. small monitor which loads and unloads the aplmain.exe. The "aplmain.exe"
  15. is the application system (according to the IBM's APPC-PC terminologies).
  16. The "apl.exe" loads the "aplmain.exe" to start a work and unloads it when
  17. a request to run a transaction program's coming; after completion of the
  18. transaction program the "apl" loads the "aplmain" again.
  19.  
  20. In addition there are two ".bat" files to help set the right environment
  21. for the application program and LU6.2 module.  You can run the
  22. "aplcom.bat" if you want to get a session over COM# port, or you can run
  23. the "aplipx.bat" if you want to get a session using Novell NetWare.
  24.  
  25. How to use the application program.
  26. ----------------------------------
  27.  
  28. To get session over asynchronous line type
  29. aplcom
  30. to use the COM2, or
  31. aplcom 1
  32. (to use the COM1)
  33. in the command line and press the "Enter" key.
  34.  
  35. This is a sample scenery of a session.
  36.  
  37. 1. Press F10 after you've saw the first screen.
  38. 2. Press "y" to confirm your accepting of the current configuration or "n"
  39. to discard the current configuration, in the last case you'll have to set
  40. the configuration later.  (See "LU 6.2 Configuration" section for
  41. details.)
  42. 3. You are in main menu now, go on the right, select the "Run" item and
  43. press the "Enter" key.
  44. 4. Select "Attach" from the "Run" menu and press the "Enter".
  45. (There is "Detach" item, please use it at very end of work, because it will
  46. remove the LU6.2 module from the memory.)
  47.  
  48. Yours farther actions will depend on what you want to do. You may choose
  49. something among the following possibilities:
  50.  
  51. - File transferring;
  52. - Remote program execution;
  53. - Conversation with remote partner.
  54.  
  55. To do any of these actions the remote application program must be placed in
  56. the "Remote control" state (to do that press the "F10" key and select from
  57. "Options" menu the "Remote control" item then).
  58.  
  59. a). File transferring
  60.  
  61. This is a simplest action which is provided by LU 6.2.
  62.  
  63. Make sure that remote program is in the "Remote control" state, in the 
  64. local LU from the "Run" menu select the "Copy..." item and press the 
  65. "Enter" key.
  66.  
  67. Select LU names form "From" and "To" LU name lists. After that you'll must
  68. see the two overlapped panels which contain the file names in the current
  69. directories. The front panel corresponds with the "From" LU, the 
  70. background panel corresponds with the "To" LU. You can swap the panels 
  71. pressing the "Tab" key.
  72.  
  73. Select a file using the "Right", "Left", "Up" and "Down" keys; press the
  74. "F5" key to start the file transferring.
  75.  
  76. b). Remote program execution
  77.  
  78. All as in the case of "File transferring", but you no need select the file,
  79. just press "F8" key, type the command with arguments just as in the MS-DOS
  80. prompt and press the "Enter" key then. You have an other way to do it, - 
  81. select an executable file and press the "Enter" key to run it.
  82.  
  83. c). Chat with remote partner
  84.  
  85. Make sure that remote program is in "Remote control" state, from the "Run"
  86. menu select the "TTY..." item and press the "Enter" key. Your program may
  87. be ether in the "receive" or in the "send" states. If your program is in 
  88. the "receive" state just wait for a massage. If your program is in 
  89. the "send" state type your message and press the "Enter" key. To switch 
  90. from the "send" state to the "receive" state hit the "Enter" key twice.
  91.  
  92. LU 6.2 Configuration
  93. ---------------------
  94.  
  95. There are three important parameters which you must assign to each LU in
  96. network. They are:
  97. - LU name;
  98. - LU type;
  99. - name of a conversation mode.
  100. Let's take a glance on the next figure.
  101.  
  102.      +-----+                      +-----+
  103.      |LU1  |                      |LU2  |
  104.      |type6+----------------------+type6|
  105.      |MODE6|                      |MODE6|
  106.      +-----+                      +-----+
  107.  
  108. We have here two connected LUs. To configure the left one, I must define
  109. it's name - "LU1" and it's type - 6, then I must define parameters it's
  110. partner LU (remote LU), and parameters of  a conversation. So I define the
  111. name of the remote LU - "LU2", type of the remote LU - 6, and name the
  112. mode of the conversation - "MODE6".
  113.  
  114. There may be several partner LUs (no more than 4 for this sample
  115. application.) There is one trick, when you complete the parameters
  116. definition of the partner LU, more exactly, when you type the partner LU
  117. type (6 for example) do NOT hit the "Enter" key if you don't wish to
  118. define the other partner LU, press the "Esc" key instead!
  119.  
  120. Let's now configure the right LU.
  121. It's name is LU2, type - 6. The partner LU name is LU1, type is 6, name
  122. the mode of conversation is "MODE6".
  123.  
  124. How to make the application program.
  125. -----------------------------------
  126.  
  127. Here are two make files:
  128. - "apl.mak" to build the "apl.exe" and,
  129. - "aplmain.mak" to build the "aplmain.exe".
  130.  
  131. I always use the MS pwb, so I recommend you to run the pwb, select the
  132. appropriate project and so on...
  133.  
  134. ======================================
  135. Nicholas Poljakov
  136. Email: poljakov@vertex.inria.msu.ru
  137. ======================================
  138.