home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / utils / pmfterm / pmfterm.hlp (.txt) < prev    next >
OS/2 Help File  |  1993-02-10  |  28KB  |  846 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About PMFTERM Emulation ΓòÉΓòÉΓòÉ
  3.  
  4. PMFTERM is a general purpose terminal emulator for OS/2.  PMFTERM provides 
  5. FTTERM color emulation, as well as DEC VT100, ANSI and line-mode TTY support. 
  6. Support for multiple font sizes, automatic logon keying (Autokeys) as well as 
  7. color selection for FTTERM emulation is provided, as well as screen print, cut 
  8. and paste. 
  9.  
  10. Two file transfer protocols are supported, IND$FILE and XMODEM. File transfers 
  11. can be invoked by pulldown menus or by the command line interface programs 
  12. PSEND and PRECEIVE. 
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ 2. Setting Profiles for PMFTERM ΓòÉΓòÉΓòÉ
  16.  
  17. You can customize any number of emulation profiles for PMFTERM.  These profiles 
  18. are saved in the OS2.INI system file and can be selected by a pulldown menu 
  19. item or by specifying the name of the profile to be used on the PMFTERM command 
  20. line. 
  21.  
  22. The customizable values are: 
  23.  
  24.  Emulation type 
  25.  
  26.  Number of data bits 
  27.  
  28.  Number of stop bits 
  29.  
  30.  Communications port 
  31.  
  32.  File transfer protocol 
  33.  
  34.  Line speed 
  35.  
  36.  Parity 
  37.  
  38.  FTTERM protocol converter type 
  39.  
  40.  FTTERM host type 
  41.  
  42.  Autokey Sequences 
  43.  
  44.  For more information on selecting a terminal profile, see Selecting Profiles. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 3. About the Autokeys Dialog ΓòÉΓòÉΓòÉ
  48.  
  49. The Logon Key Definitions dialog is used to define a set of keystrokes which 
  50. are to be sent to the host system during initial connect processing.  For each 
  51. "Send" key definition a corresponding "Response" definition must be provided. 
  52. PMFTERM processes the Send and Response entries sequentially until a blank 
  53. entry is found, at which time autokey processing terminates. 
  54.  
  55. During autokey processing a dialog box is display which provides a visual 
  56. indication of the progress of the logon process. 
  57.  
  58. More information may be found in: 
  59.  
  60.  Manual Connect Only 
  61.  
  62.  Entering Autokey Information 
  63.  
  64.  
  65. ΓòÉΓòÉΓòÉ 4. Deleting Profiles ΓòÉΓòÉΓòÉ
  66.  
  67. You may delete individual profiles via the Profile Delete pulldown. You may 
  68. enter the profile to be deleted via the keyboard (case is ignored and is set to 
  69. upper case) or the mouse.  You may select Cancel at any time to abort the 
  70. process. 
  71.  
  72.  
  73. ΓòÉΓòÉΓòÉ 5. Color Selection for FTTERM Emulation ΓòÉΓòÉΓòÉ
  74.  
  75. You may find that it is difficult to see all of the FTTERM colors when working 
  76. with an 8507 monochrome display, a PS/2 Model P70 plasma display or sometimes 
  77. with a PS/2 Model L40SX, depending on the level of the installed display 
  78. drivers.  If this is the case, you can change any or all of the four basic 3270 
  79. data stream colors via the Customize pulldown menu.  If the Colors menu item is 
  80. not selectable, go to the Profiles pulldown and select a terminal profile which 
  81. specifies FTTERMC emulation. 
  82.  
  83. The FTTERM Color Selection dialog box contains a set of radio buttons which 
  84. indicate which of the 4 basic 3270 colors is to be changed, a set of color 
  85. buttons corresponding roughly to the 8 basic AVIO colors and a number of 
  86. pushbuttons at the bottom to control updating and saving of the changes. 
  87.  
  88. To modify a color, push the radio button corresponding to the color to be 
  89. changed (in order they correspond to Green, Red, Blue and White), push the 
  90. button in the "To" group for the new color and then push the "Set" button. 
  91. When all the desired changes have been made, push the "Ok" button to exit the 
  92. dialog.  To write the changes to the OS2.INI file, push "Save". 
  93.  
  94. The "Reset" button will reset the colors to the PMFTERM default colors, but 
  95. will not update OS2.INI unless you select "Save". 
  96.  
  97.  
  98. ΓòÉΓòÉΓòÉ 6. File Transfer ΓòÉΓòÉΓòÉ
  99.  
  100. PMFTERM implements IND$FILE and XMODEM (both checksum and CRC) file transfers. 
  101.  
  102. Because of the differences between the 7171 protocol converter and the 3708, it 
  103. is very important that the Terminal Settings be set to reflect the proper 
  104. machine type.  Also, the TSO/CMS settings must be correct for IND$FILE to work 
  105. correctly. 
  106.  
  107. IND$FILE via Pulldown menus 
  108.  
  109. You can invoke IND$FILE from the File pulldown menu or from the PSEND/PRECEIVE 
  110. commands.  Selecting the File Send or Receive options presents the following 
  111. dialog box. 
  112.  
  113. IND$FILE via PSEND/PRECEIVE 
  114.  
  115. You may also use the PSEND/PRECEIVE commands provided with PMFTERM to invoke 
  116. file transfer from the command line. PSEND/PRECEIVE have identical syntax to 
  117. the the OS/2 CM SEND/RECEIVE commands for IND$FILE. PSEND/PRECEIVE default to 
  118. host session "I" instead of "A". 
  119.  
  120. The PCASSI package from OS2TOOLS provides an excellent interface to the 
  121. standard SEND/RECEIVE commands.  You may use PCASSI in one of two ways with 
  122. PMFTERM.  Either rename the PSEND/PRECEIVE commands to SEND/RECEIVE if you do 
  123. not have any other IBM SEND/RECEIVE command installed on your system, or use 
  124. the PCASSI50.CUS customization file with PCASSI 3.0 or above.  PCASSI50 
  125. customizes PCASSI to use PSEND/PRECEIVE through host session "I".  Refer to the 
  126. PCASSI package documentation for more information. 
  127.  
  128. Recovering from IND$FILE errors 
  129.  
  130. During file transfer (IND$FILE and XMODEM) the following status dialog is 
  131. maintained: 
  132.  
  133. A number of "hangs" can occur during IND$FILE file transfer. In general, the 
  134. problems will occur on file downloads and are caused by parity problems or lost 
  135. characters during the receive operation. PMFTERM will "beep" whenever a parity 
  136. or framing error is detected by the OS/2 COM device driver, and if the host 
  137. screen is not correctly received in 40 seconds will issue the "Host has not 
  138. responded in 40 seconds".  Corrective action for this condition is: 
  139.  
  140.   1. Switch to the host session. 
  141.  
  142.   2. If the host screen is blank, minimize and then maximize the host window. 
  143.      You should see what looks like garbage on the screen. 
  144.  
  145.   3. Hit CTRL-R to reset the keyboard, followed by CLEAR. 
  146.  
  147.  The file transfer should now resume.  You may minimize the PMFTERM window to 
  148.  an icon if you wish.  If the above recovery action does not seem to work, you 
  149.  must abort the file transfer by following these instructions: 
  150.  
  151.   1. First cancel the PMFTERM file transfer interface, either via the "Cancel" 
  152.      button on the Send/Receive dialog or by Ctrl-Break if using 
  153.      PSEND/PRECEIVE. 
  154.  
  155.      Note:  It can take 30-40 seconds to cancel the file transfer, since 
  156.      PMFTERM must wait for host download screens to be completely received in 
  157.      some situations. 
  158.  
  159.   2. If the host "Ready" prompt does not appear in 30-40 seconds, activate the 
  160.      PMFTERM window and Minimize/Maximize it.  You should see some strange 
  161.      looking characters on the screen, or a screen that starts with the 
  162.      character "A", "B", "C" or "<" .  Hit the F2  key. 
  163.  
  164.   3. If the sequence "C???q" appears next, where ??? can be any character, hit 
  165.      the Enter key and the Ready prompt will appear. 
  166.  
  167.  Strange characters during IND$FILE 
  168.  
  169.  PMFTERM disables screen updates during IND$FILE file transfers. However, if 
  170.  you move, resize, minimize/maximize or in any other way cause the PMFTERM 
  171.  window to be altered during transfers you will be regaled with large amounts 
  172.  of what appears to be garbage flowing over your terminal emulation screen. 
  173.  This is normal.  If it bothers you, just minimize the PMFTERM session until 
  174.  the file transfer completes. 
  175.  
  176.  XMODEM File Transfers 
  177.  
  178.  When the Terminal Settings indicate that file transfer is via XMODEM the 
  179.  procedure for file transfer is almost identical to IND$FILE. Selecting the 
  180.  File Send or Receive options presents the following dialog box. 
  181.  
  182.  1K Send will be used if this checkbox is turned on.  You must be certain that 
  183.  the receiving system supports XMODEM CRC with 1K blocks! 
  184.  
  185.  The PSEND/PRECEIVE command interface may still be used.  However, 
  186.  PSEND/PRECEIVE for XMODEM requires that the following syntax be followed: 
  187.  
  188.  PSEND  pcfilename [s:] (X [1K])
  189.  PRECEIVE pcfilename [s:] (X)
  190.  
  191.  The right parenthesis is optional, but the left parenthesis is required. 
  192.  
  193.  The "s" is optional and is the host session ID ("I" is the default). 
  194.  
  195.  The "X" signifies XMODEM and may be in upper or lower case. 
  196.  
  197.  The only command line operand allowed with XMODEM is "1K", which forces 
  198.  PMFTERM into 1024 byte Send mode (instead of 128 byte mode).  If 1K mode is 
  199.  selected, CRC mode is also enforced.  You must be certain that the receiver 
  200.  supports 1024 byte blocks.  Otherwise, the Send operation will be aborted by 
  201.  the receiving system. 
  202.  
  203.  PMFTERM attempts to use XMODEM CRC protocol, but will operate in XMODEM 
  204.  checksum protocol if CRC is not allowed by the other end.  Ten (10) attempts 
  205.  are made at three (3) second intervals to establish CRC mode. After that, 
  206.  Checksum mode is established. 
  207.  
  208.  PMFTERM will accept either 128 byte blocks (CRC or Checksum mode) or 
  209.  alternatively, 1024 (1K) byte blocks for file download.  1K blocks are also 
  210.  referred to by some BBS's as "Y-modem 1K", but in actuality this is really 
  211.  Xmodem 1K with CRC mode. Either CRC or Checksum will be used as defined by the 
  212.  receiver. Also, the line characteristics are set to 8 data bits, 1 stop bit 
  213.  and no parity (8-N-1) for the duration of XMODEM file transfers, and are reset 
  214.  to their original settings upon completion of the transfer. Therefore, you may 
  215.  operate your terminal emulations with 7 data bits and parity enabled and still 
  216.  perform XMODEM transfers. 
  217.  
  218.  The same status dialog is displayed as with IND$FILE during XMODEM transfers. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 7. Help for Keys ΓòÉΓòÉΓòÉ
  222.  
  223. The keyboard mapping for VT100 and FTTERMC emulation closely follows the FTTERM 
  224. 2.1 keyboard mapping, with a few exceptions made at the request of FORUM 
  225. contributors.  For ANSI and TTY modes the keyboard behaves in the same manner 
  226. as a Teletype KSR 33 (including all CTRL keys). 
  227.  
  228. The "3270" emulations (VT100/FTTERMC) use the following: 
  229.  
  230.  Clear           HOME (All keyboards) 
  231.  
  232.                  PAUSE (Enhanced Keyboard) 
  233.  
  234.  Enter           Right CTRL (Enhanced Keyboard) 
  235.  
  236.                  Pad ENTER (Enhanced Keyboard) 
  237.  
  238.                  ENTER (AT Keyboard) 
  239.  
  240.  Return          ENTER (Enhanced Keyboard) 
  241.  
  242.                  CTRL+ENTER (AT Keyboard) 
  243.  
  244.  Erase EOL       END (All Keyboards) 
  245.  
  246.  PF1-PF12        F1-F12 (Enhanced Keyboard) 
  247.  
  248.                  F1-F10, Shift+F1, Shift+F2 (AT Keyboard) 
  249.  
  250.  PA1             CTRL+F1 or ALT+INS (All Keyboards) 
  251.  
  252.  PA2             CTRL+F2 or ALT+HOME (All Keyboards) 
  253.  
  254.  Reset           CTRL+"R" (3708/7171 Implementation) 
  255.  
  256.  In addition to the 3270 key functions defined above, the following CTRL 
  257.  combinations are implemented in VT100: 
  258.  
  259.  5842 CommandCTRL+N (5842 command mode) 
  260.  
  261.  XON/XOFF  CTRL+S/CTRL+Q (Use with care!) 
  262.  
  263.  SI        CTRL+O 
  264.  
  265.  Break     CTRL+C (Not a line break...send the char.) 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 8. PMFTERM Main Window Help ΓòÉΓòÉΓòÉ
  269.  
  270. This is the help for the pmfterm main window. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 8.1. File Menu Pulldown ΓòÉΓòÉΓòÉ
  274.  
  275. This pulldown control file Send and Receive operations.  The protocol to be 
  276. used for the file transfer is defined in the current terminal settings profile. 
  277.  
  278. For more information, refer to: 
  279.  
  280.  Setting Profiles for PMFTERM 
  281.  
  282.  File Transfer 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 8.2. Print Screen ΓòÉΓòÉΓòÉ
  286.  
  287. The current screen contents are copied to the Print Manager application default 
  288. queue using a simple ASCII data stream.  Nulls are converted to blanks, 
  289. trailing data is stripped and an ASCII CR/LF sequence is appended to the data. 
  290. No check is made to ensure that the screen is not being updated during the 
  291. screen print. 
  292.  
  293. Note:  This does not imply that LPT1 is the target device! You may have 
  294. assigned some other printer to the default queue in the Print Manager! 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 8.3. Capture ΓòÉΓòÉΓòÉ
  298.  
  299. When you check the Capture menu item incoming data from the communications line 
  300. is captured in raw format and saved in a 64K byte buffer.    If the buffer fills 
  301. it is wrapped to the beginning and data is lost.  Selecting the Capture menu 
  302. item again causes the contents of the buffer to be written to the clipboard, 
  303. where it can be pasted into an editor and saved to a file. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 8.4. Host Print in FTTERMC Mode ΓòÉΓòÉΓòÉ
  307.  
  308. When PMFTERM is configured for FTTERMC emulation on the 3174/3708 it is 
  309. possible to redirect host LU1/LU3 print data streams to the OS/2 print 
  310. spooler.    The 3174/3708 must be appropriately configured, as well as the host 
  311. VTAM/NCP and application definitions. 
  312.  
  313. When PMFTERM receives the DLE-DC2 ASCII host sequence it opens the printer data 
  314. stream defined as the default printer.  This is the same printer as is used for 
  315. PMFTERM Print Screen. All host print data is dumped unmodified to the output 
  316. printer, which is assumed to be ProPrinter compatible.  Since PMFTERM cannot 
  317. detect the end of the print data stream it is necessary for the user to monitor 
  318. the status of the print job.  This can be done via the host application, ie. 
  319. SDSF if TSO, RSCS QUERY commands if VM, etc.  To aid in monitoring the status 
  320. of the print job, PMFTERM sounds a short beep (similar to the beep issued when 
  321. a line error occurs) at the end of each page sent to the OS/2 Spooler. 
  322.  
  323. The print job is closed and sent to the print spooler when the user selects 
  324. Close Host Print from the File menu pulldown, or when PMFTERM is terminated. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 8.5. Settings Pulldown ΓòÉΓòÉΓòÉ
  328.  
  329. This menu controls the Terminal Settings.  Options are provided to 
  330.  
  331.  Set Up Profiles for PMFTERM 
  332.  
  333.  Delete PMFTERM Profiles 
  334.  
  335.  Initialize OS2.INI to remove ALL PMFTERM Profiles. 
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 8.6. Exit PMFTERM ΓòÉΓòÉΓòÉ
  339.  
  340. This option unconditionally exits PMFTERM.  The telephone connection is 
  341. dropped.  You will be given an option to continue PMFTERM execution, or to 
  342. terminate PMFTERM with or without saving the current window position. 
  343.  
  344.  
  345. ΓòÉΓòÉΓòÉ 8.7. Initiate Connection ΓòÉΓòÉΓòÉ
  346.  
  347. You may select one of the following actions: 
  348.  
  349.  Connect   Hang up the telephone and restart the connection.  Execute the 
  350.            autokey sequences if any are defined.  This option must also be used 
  351.            when the Manual Connect option is selected to activate the 
  352.            connection. 
  353.  
  354.  Abort Connect The autokey sequences are aborted.    The connection to the 
  355.            telephone network remains active. 
  356.  
  357.  Hangup.   The telephone is hung up (goes on-hook) at once. 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 8.8. Clipboard Operations ΓòÉΓòÉΓòÉ
  361.  
  362. Standard PM Mark, Copy and Paste functions are provided on the Edit pulldown 
  363. menu item.  Text can be marked with the mouse or via the keyboard.  To mark 
  364. text via the keyboard select Edit Mark.  A selection rectangle will appear 
  365. starting at the current cursor position.  Size the rectangle with the keyboard 
  366. arrow keys and hit Enter to complete the selection process.  If you have 
  367. problems (due to bugs) while marking text, maximize PMFTERM's window and use 
  368. the keyboard instead of the mouse to mark the text.  I have some bugs in this 
  369. area still. Edit Copy or Ctrl+Ins can be used to copy the selected text to the 
  370. clipboard. 
  371.  
  372. You might also occasionally observe that a selection rectangle or small 
  373. cursor-like line appears when switching to PMFTERM from another PM application 
  374. using mouse button 1. If this happens, just hit the left mouse button again 
  375. while in the PMFTERM client window and the selection will be reset. 
  376.  
  377. Paste is activated when the clipboard is found to contain data in the clipboard 
  378. CF_TEXT format.  When you select Edit Paste from the pulldown (or use the 
  379. Shift+Ins key combination) the contents of the clipboard are typed into the 
  380. host session, starting at the cursor location.  Depending on the emulation in 
  381. effect the data is translated to match the behavior of the keyboard, for 
  382. example in FTTERMC emulation a 0D "return" character should be treated as a 
  383. "new line" character, but in TTY line mode the 0D should be treated as an 
  384. "enter".  All "new line" 0A characters are ignored by Paste. 
  385.  
  386.  
  387. ΓòÉΓòÉΓòÉ 8.9. Color Selection ΓòÉΓòÉΓòÉ
  388.  
  389. When using FTTERMC emulation it is possible to change the basic 3270 data 
  390. stream colors to make the screen more visible on monochrome and plasma 
  391. displays. 
  392.  
  393. Refer to  Color Selection for FTTERM Emulation General Description and How to 
  394. Select FTTERM Colors for information on how to do this. 
  395.  
  396. Note:  This selection is only applicable to FTTERM emulation. It is not 
  397. possible to change the colors for ANSI emulation. 
  398.  
  399.  
  400. ΓòÉΓòÉΓòÉ 8.10. Font Selection ΓòÉΓòÉΓòÉ
  401.  
  402. PMFTERM will attempt to present the first 16 AVIO (Advanced Video Input Output) 
  403. fonts supported on your particular display via this pulldown. Whenever you 
  404. change the specified font the new setting will be saved in OS2.INI.  In some 
  405. cases (and under OS/2 1.2) PMFTERM will not be able to communicate with the 
  406. display driver.  In this case you will only be given the option of "Large" and 
  407. "Small" EGA fonts, rather than a full selection of all the supported fonts.  In 
  408. that case you will need a new display driver. 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ 9. Working with Profiles ΓòÉΓòÉΓòÉ
  412.  
  413. Profiles are saved in OS2.INI.  When a profile is retrieved it replaces the 
  414. in-memory terminal profile.  Unless the manual connect. option is selected the 
  415. current connection is aborted and a new connection is established using the new 
  416. terminal settings and autokeys. If manual connect is selected, only the 
  417. in-memory terminal profile is updated but the connection continues using the 
  418. previous settings. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 9.1. Profile Name ΓòÉΓòÉΓòÉ
  422.  
  423. This box contains the names of all of the current profiles.    The active profile 
  424. is highlited.  You may select the profile to be used by clicking on the profile 
  425. name with the mouse and then clicking on Retrieve, by using the arrow keys to 
  426. move up and down in the list and then hitting Enter, or by typing the name of 
  427. the desired profile and hitting Enter. 
  428.  
  429. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  430.  
  431.  
  432. ΓòÉΓòÉΓòÉ 9.2. Retrieving a Profile ΓòÉΓòÉΓòÉ
  433.  
  434. This button causes the profile specified in the profile name to be retrieved 
  435. from OS2.INI.  If the specified profile does not exist, the terminal settings 
  436. are set to the PMFTERM default (FTTRMIIN). 
  437.  
  438. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 9.3. Terminal Emulations ΓòÉΓòÉΓòÉ
  442.  
  443.  Emulation Description 
  444.  
  445.  FTTERMC   This is the IBM PC/Host File Transfer Program 3270 emulation 
  446.            protocol.  It is primarily designed for use with the IBM 
  447.            3708/3174AEA and 7171 protocol converters.  The IND$FILE (Release 
  448.            1.1.1) file transfer protocol is supported.  Colors can be remapped 
  449.            to accomodate monochrome and plasma displays.  When working with a 
  450.            3708/3174 it is imperative that the Typeahead and Enhanced 
  451.            Null/Blank options be enabled (the operator information area will 
  452.            show "TYP  N/B".    Toggle this setting with the <ESC>t sequence. 
  453.  
  454.  ANSI      PMFTERM provides ANSI-compatible data stream processing.  All 
  455.            CTRL-key combinations are supported.  ANSI color and cursor 
  456.            positioning data streams are supported.  This emulation is useful 
  457.            for accessing many BBS's.  XMODEM, XMODEM CRC and XMODEM 1K are 
  458.            supported for file transfer. 
  459.  
  460.  VT100     DEC VT100(R) emulation can be used for access to IBM 7171 protocol 
  461.            converters which do not have the FTTERM TDT's installed, as well as 
  462.            for access to any ASCII host supporting VT100 protocol.  Both 
  463.            IND$FILE and XMODEM are supported. 
  464.  
  465.  TTY       Line-mode ASCII emulation is supported for access to ASCII hosts. 
  466.            All CTRL-key combinations are supported, as is XMODEM file transfer. 
  467.  
  468.  For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 9.4. Line Speeds ΓòÉΓòÉΓòÉ
  472.  
  473. You may select line speeds of 300, 1200, 2400, 4800, 9600 and 19,200 BPS.  The 
  474. PC/AT does not support speeds of 19,200 and damage to the serial adapter may 
  475. result if it is operated at this speed. Although PMFTERM may work with MNP 
  476. modems using compression, it is recommended that for the full-screen (FTTERMC, 
  477. ANSI and VT100) emulations compression be disabled. 
  478.  
  479. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  480.  
  481.  
  482. ΓòÉΓòÉΓòÉ 9.5. Parity Selection ΓòÉΓòÉΓòÉ
  483.  
  484. Select Even, Odd or None for parity.  Regardless of the selection PMFTERM will 
  485. revert to None for the duration of XMODEM file transfers, and then restore the 
  486. user-selected parity at the completion of the file transfer. 
  487.  
  488. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 9.6. Setting the Data Bits ΓòÉΓòÉΓòÉ
  492.  
  493. Generally, 7 data bits will be selected for FTTERM and VT100.  7 or 8 may be 
  494. selected for ASCII hosts.  PMFTERM will switch to 8 data bits during XMODEM 
  495. file transfers and restore the user-selected data bit setting when the transfer 
  496. is complete. 
  497.  
  498. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  499.  
  500.  
  501. ΓòÉΓòÉΓòÉ 9.7. Setting the Stop Bits ΓòÉΓòÉΓòÉ
  502.  
  503. Select 1 stop bit for 1200 BPS and above.  2 stop bits may be used for 300 BPS 
  504. and (sometimes) for 1200 BPS). 
  505.  
  506. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ 9.8. Communications Device Number ΓòÉΓòÉΓòÉ
  510.  
  511. COM1-4 may be selected on PS/2 hardware and on some clones when supported by 
  512. OS/2.  PC/AT hardware only supports COM1 and COM2. 
  513.  
  514. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  515.  
  516.  
  517. ΓòÉΓòÉΓòÉ 9.9. File Transfer Protocol ΓòÉΓòÉΓòÉ
  518.  
  519. PMFTERM supports IND$FILE Release 1.1.1 protocol, XMODEM, XMODEM CRC and XMODEM 
  520. 1K file transfer protocols.  Regardless of the user-specified number of data 
  521. bits, stop bits and parity PMFTERM will temporarily switch to 8/1/N during 
  522. XMODEM transfers. 
  523.  
  524. For IND$FILE to work correctly the following options must be set correctly: 
  525.  
  526.  Host System Type 
  527.  
  528.  Protocol Converter Type 
  529.  
  530.  For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 9.10. Host System Type ΓòÉΓòÉΓòÉ
  534.  
  535. The host system (VM/CMS or MVS TSO) must be set here.  This information is used 
  536. during IND$FILE file transfer, and is ignored if XMODEM is set. 
  537.  
  538. To switch from one setting to another during a logon session, ie. through IBM 
  539. Information Network or through multi-session host software you must do the 
  540. following: 
  541.  
  542.   1. Log off the previous host session 
  543.  
  544.   2. Select the Settings pulldown 
  545.  
  546.   3. Change the Host Type to match the new session 
  547.  
  548.   4. Select Keys... 
  549.  
  550.   5. Check the Manual Connect option 
  551.  
  552.   6. Hit OK on the Logon Key Definitions and Terminal Settings screens 
  553.  
  554.  If you are not using the PSEND/PRECEIVE command line interface you may 
  555.  alternatively just change the host type on the IND$FILE file selection dialog 
  556.  window.  This change is only used for the duration of the current file 
  557.  transfer, however. 
  558.  
  559.  For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  560.  
  561.  
  562. ΓòÉΓòÉΓòÉ 9.11. Protocol Converter Type ΓòÉΓòÉΓòÉ
  563.  
  564. For FTTERM emulation, this setting must match the protocol converter being used 
  565. at the host. 
  566.  
  567. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 9.12. Setting a Default Profile ΓòÉΓòÉΓòÉ
  571.  
  572. By checking Default and Save the current terminal settings become the PMFTERM 
  573. defaults.    When you invoke PMFTERM without specifying a profile name the name 
  574. DEFAULT is used for the settings.  If you do not save the current settings this 
  575. checkbox has no effect. 
  576.  
  577. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  578.  
  579.  
  580. ΓòÉΓòÉΓòÉ 9.13. Save the Profile ΓòÉΓòÉΓòÉ
  581.  
  582. The current terminal settings are written to OS2.INI.  If the Default box is 
  583. checked the settings are saved twice, first under the name specified in the 
  584. Profile Name combination box and then under the name DEFAULT 
  585.  
  586. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  587.  
  588.  
  589. ΓòÉΓòÉΓòÉ 9.14. Activate the Profile ΓòÉΓòÉΓòÉ
  590.  
  591. Click on OK to activate the current settings.  Remember to hit the Retrieve 
  592. button if you have just typed a new profile name.  The phone line will be 
  593. dropped and reenabled and the Autokey sequences will be run unless the Manual 
  594. Connect option is selected. 
  595.  
  596. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  597.  
  598.  
  599. ΓòÉΓòÉΓòÉ 9.15. Abort Profile Selection ΓòÉΓòÉΓòÉ
  600.  
  601. The Terminal Settings window is closed and the in-memory terminal settings will 
  602. be reset to their previous state. 
  603.  
  604. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  605.  
  606.  
  607. ΓòÉΓòÉΓòÉ 10. Autokey Definitions ΓòÉΓòÉΓòÉ
  608.  
  609. This dialog is used to define a set of host key sequences which are used during 
  610. Connect processing.  The Logon Key Definition dialog is displayed. 
  611.  
  612.  
  613. ΓòÉΓòÉΓòÉ 10.1. Defining Host Sequences ΓòÉΓòÉΓòÉ
  614.  
  615. Send Definitions 
  616.  
  617. You may enter any valid character in the Send definitions.  Autokey processing 
  618. will complete when an empty Send field is encountered.  Normally you would 
  619. enter modem control sequences, logon information, etc. in the Send fields.  The 
  620. "\" backslash character is used to denote certain escape-type sequences: 
  621.  
  622.  \t or \>  Send a tab sequence to the host 
  623.  
  624.  \d        Send a Ctrl-N (IBM 5841) to the host 
  625.  
  626.  \r        Send a carriage return to the host 
  627.  
  628.  \n        Send a new line to the host 
  629.  
  630.  \c        Send a CTRL-C sequence to the host 
  631.  
  632.  \e        Send an ESC character to the host 
  633.  
  634.  \w        Wait one second 
  635.  
  636.  \<        Send a BACKTAB key (FTTERMC only) 
  637.  
  638.  \o        Send a CTRL-E (used for R<O>LM switches 
  639.  
  640.  \\        Send the backslash character 
  641.  
  642.  PMFTERM proceeds sequentially through the autokey sequences until a null entry 
  643.  is found.  For each entry the data in the "Send" field is typed into the 
  644.  emulation session, and PMFTERM waits for the data in the "Response" field to 
  645.  appear in the client window.  If the response information is already on the 
  646.  host screen the scan will be satisfied immediately.  When the data is found, 
  647.  PMFTERM proceeds to the next "Send" item and the process is repeated. 
  648.  
  649.  Response Definitions 
  650.  
  651.  Any ASCII data may be entered into the Response definitions.  Note that the 
  652.  host screen is searched repeatedly for the Response data from row/column 0/0 
  653.  to 24/79.  If the data is found then processing continues with the next Send 
  654.  field.  Residual data on the screen can, therefore, cause a premature exit of 
  655.  the Response search if it satisfies the Response criteria.  Autokey processing 
  656.  completes when an empty Response item is encountered. 
  657.  
  658.  
  659. ΓòÉΓòÉΓòÉ 10.2. Accept Autokey Values ΓòÉΓòÉΓòÉ
  660.  
  661. Selecting OK causes the autokey definitions and the Manual Connect setting to 
  662. be stored in the In-memory profile.  Control is returned to the Terminal 
  663. Settings dialog. 
  664.  
  665.  
  666. ΓòÉΓòÉΓòÉ 10.3. Cancel Autokey Definition ΓòÉΓòÉΓòÉ
  667.  
  668. The in-memory profile image is restored to match its value upon invocation of 
  669. the Logon Key Definitions dialog and control is returned to the Terminal 
  670. Settings dialog. 
  671.  
  672.  
  673. ΓòÉΓòÉΓòÉ 11. Forcing Manual Connection ΓòÉΓòÉΓòÉ
  674.  
  675. This selection will suppress the PMFTERM connect processing which normally 
  676. occurs when OK is selected from the Terminal Settings dialog.  The default 
  677. action is to hang up the telephone, reenable Data Terminal Ready and proceed 
  678. with the autokey processing.  Manual Connection is useful when editing terminal 
  679. settings while a connection is in progress, or for correcting errors in the 
  680. Host type, file transfer protocol, etc. 
  681.  
  682. Warning: PMFTERM frequently refers to the in-memory contents of the Terminal 
  683. Settings during execution.  If you change the Terminal Settings with Manual 
  684. Connect Only set you could cause unpredictable results until you reestablish 
  685. the host connection using the Connect pulldown menu. 
  686.  
  687.  
  688. ΓòÉΓòÉΓòÉ 12. Deleting Individual Profiles ΓòÉΓòÉΓòÉ
  689.  
  690. You may delete an individual profile from OS2.INI by selecting it as described 
  691. in  Specifying the Profile to Delete and then clicking on DELETE. 
  692.  
  693.  
  694. ΓòÉΓòÉΓòÉ 12.1. Specifying the Profile to Delete ΓòÉΓòÉΓòÉ
  695.  
  696. You may select the profile to be deleted via the cursor keys, the mouse or by 
  697. overtyping the name of the profile in the combo box. 
  698.  
  699.  
  700. ΓòÉΓòÉΓòÉ 13. FTTERM Color Selection ΓòÉΓòÉΓòÉ
  701.  
  702. This dialog lets you change the FTTERM colors.  Refer to Color Selection for 
  703. FTTERM Emulation a general description. 
  704.  
  705.  
  706. ΓòÉΓòÉΓòÉ 13.1. Saving the FTTERM Colors ΓòÉΓòÉΓòÉ
  707.  
  708. Clicking on this button will write the current color selection to OS2.INI. 
  709. PMFTERM always attempts to retrieve a color selection set from OS2.INI at 
  710. startup, and if none is found will revert to the initial PMFTERM FTTERM color 
  711. defaults. 
  712.  
  713.  
  714. ΓòÉΓòÉΓòÉ 13.2. Activate the New FTTERM Colors ΓòÉΓòÉΓòÉ
  715.  
  716. The current color selection is activated.  No changes are written to OS2.INI. 
  717. The changes will affect all new output to the screen, so you might wish to 
  718. clear the screen to cause a repaint from the host system to see if the colors 
  719. are what you desire. 
  720.  
  721.  
  722. ΓòÉΓòÉΓòÉ 13.3. Restore PMFTERM Default Colors ΓòÉΓòÉΓòÉ
  723.  
  724. The colors settings are restored to their initial defaults. 
  725.  
  726.  Description                 Color 
  727.  
  728.  Normal Unprotected          Green 
  729.  
  730.  Intensified Unprotected     Red 
  731.  
  732.  Normal Protected            Blue 
  733.  
  734.  Intensified Unprotected     White 
  735.  
  736.  To permanently effect a Reset you must save the FTTERM settings. 
  737.  
  738.  
  739. ΓòÉΓòÉΓòÉ 13.4. Abort Color Change ΓòÉΓòÉΓòÉ
  740.  
  741. The FTTERM color selection is cancelled.  Some of the host colors may have 
  742. already been changed, requiring a Reset or a restart of PMFTERM to restore your 
  743. original color choices. 
  744.  
  745.  
  746. ΓòÉΓòÉΓòÉ 13.5. Using the color buttons for FTTERM ΓòÉΓòÉΓòÉ
  747.  
  748. To change a color: 
  749.  
  750.   1. Select the color to be changed from the choices under Set Color 
  751.  
  752.   2. Select the new color to be assigned to that host attribute (for example, 
  753.      Intensified Unprotected from the choices under To 
  754.  
  755.   3. Select Save 
  756.  
  757.  If you make a mistake, or want to restore the colors to their initial "factory 
  758.  defaults" just select Reset. 
  759.  
  760.  
  761. ΓòÉΓòÉΓòÉ 14. File Selection for File Transfer ΓòÉΓòÉΓòÉ
  762.  
  763. This dialog provides interactive definition of the file transfer parameters for 
  764. IND$FILE and XMODEM.  Use the list boxes or the entry fields to enter the host 
  765. (for IND$FILE) and OS/2 file names, as well as other file transfer options. 
  766.  
  767.  
  768. ΓòÉΓòÉΓòÉ 14.1. OS/2 Filename ΓòÉΓòÉΓòÉ
  769.  
  770. You may overtype the full OS/2 path and file name, or select the file to be 
  771. send/received via the dialog box.  No syntax checking is done if you type the 
  772. file name.  PMFTERM just verifies its existence for Send operations and opens 
  773. it for output for Receive. 
  774.  
  775.  
  776. ΓòÉΓòÉΓòÉ 14.2. Host Filename ΓòÉΓòÉΓòÉ
  777.  
  778. Enter the filename for the host file.  No syntax checking is done to verify 
  779. that the filename is either a valid TSO or CMS file name. 
  780.  
  781. For example, in TSO you must specify the userid prefix and surround the file 
  782. name in apostrophes if PREFIX is on and you want to use a high-level dataset 
  783. name qualifier other than your own userid. 
  784.  
  785.  
  786. ΓòÉΓòÉΓòÉ 14.3. IND$FILE Options ΓòÉΓòÉΓòÉ
  787.  
  788. Check or fill in the following file transfer options: 
  789.  
  790.  RECFM     Host record format, either V, F or U.  This field is not validated 
  791.            and may contain any value to be passed to the IND$FILE command. 
  792.  
  793.            IND$FILE will give a syntax error if this field is present during an 
  794.            attempt at Receiving a file. 
  795.  
  796.  LRECL     This contains the logical record length.  It is limited only by the 
  797.            host operating system and is not checked for validity. 
  798.  
  799.            IND$FILE will give a syntax error if this field is present during an 
  800.            attempt at Receiving a file. 
  801.  
  802.  ASCII     ASCII translation of the data will be done.  IND$FILE's internal 
  803.            translation table will be used.  Codepage and NLS are ignored. 
  804.  
  805.  CRLF      IND$FILE will append a CR and LF sequence to each line of data. 
  806.            ASCII translation is assumed.  This option must be specified 
  807.            correctly in order for the APPEND option to work properly. 
  808.  
  809.  APPEND    The data is appended to the end of the host or OS/2 file.  If the 
  810.            ASCII option is specified during a Receive PMFTERM will check the 
  811.            end of the OS/2 file for an ASCII EOF (hex 1A) and will overlay it 
  812.            if one is found. 
  813.  
  814.  
  815. ΓòÉΓòÉΓòÉ 14.4. Other IND$FILE Options ΓòÉΓòÉΓòÉ
  816.  
  817. Any text entered in this field will be appended to the IND$FILE command. 
  818. PMFTERM will provide parentheses before the other options if needed (ie. host 
  819. type is VM).  No checking is done.  Use this field to specify DASD space 
  820. information, etc. 
  821.  
  822.  
  823. ΓòÉΓòÉΓòÉ 14.5. Host Operating System ΓòÉΓòÉΓòÉ
  824.  
  825. This setting must match the host operating environment.  It is used in 
  826. formatting the IND$FILE command syntax, and by PSEND and PRECEIVE in 
  827. interpreting the command line to ensure the correct file transfer command. 
  828. This selection is initialized to the value from the current terminal profile, 
  829. and may be changed for the duration of a single (menu-driven) file transfer. 
  830.  
  831.  
  832. ΓòÉΓòÉΓòÉ 14.6. OS/2 File Specification ΓòÉΓòÉΓòÉ
  833.  
  834. Use the file selection dialog items to completely specify the name of the OS/2 
  835. file to send or receive.  You may also key the full file specification in the 
  836. PC File area. 
  837.  
  838.  
  839. ΓòÉΓòÉΓòÉ 14.7. Force 1024 XMODEM Block Size ΓòÉΓòÉΓòÉ
  840.  
  841. PMFTERM will accept 1024 byte blocks on all Receive operations.  Since the use 
  842. of 1024 byte blocks is defined by the sender use this selection to tell PMFTERM 
  843. that the receiving host supports 1024 byte blocks. 
  844.  
  845. Note:  Selecting this option on a Send to a host which only supports 128 byte 
  846. XMODEM will result in a file transfer failure.