home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d170 / aftterm.lha / Aftterm / aftterm.doc < prev    next >
Text File  |  1988-11-22  |  10KB  |  257 lines
  1.  
  2.            AMIGA-FTTERM - a 3278 emulation program for IBM mainframes
  3.    using 3708 protocol convertor.
  4.  
  5.            HISTORY.
  6.            =======
  7.  
  8.            This program was written because of the I wanted a specific
  9.    3278  emulation program. If you are an IBM terminal user,
  10.    you will appreciate (I hope), the similarity with this program
  11.    to the 3278 terminal and 3278 functionality.
  12.  
  13.            This program was written on an Amiga 1000, with a one meg
  14.    Insider board. It is written in assembler, and at the time of writing
  15.    is 22,220 bytes. As it opens one 8 colour window (32k) and 1 4k serial
  16.    buffer for a total of 58 k (approx), any Amiga should be able to run it.
  17.  
  18.           What separates this program from other emulators is:
  19.  
  20.      . An operator information line that includes the system clock
  21.      . 6 Colours (two more for requestors)
  22.      . Printing capability
  23.                 . print screen
  24.                 . 3287 local prints
  25.      . Efficient control character transmission
  26.      . Code specific for the 3278 world
  27.      . keypad defined as PF KEYS
  28.  
  29.          Some of these features are a result of using the 3708 IBM PC FTTERM 
  30.    protocal and other features are a result of the program.
  31.    
  32.            Getting started.
  33.            ================
  34.  
  35.            This program runs from the CLI. It has not been coded (yet)
  36.     to run from workbench.
  37.  
  38.            You should have the dataset "DEFAULT.SET" in your current
  39.     directory. The program picks up all the options from this file
  40.     including BAUD rate and your choice of colours. If you don't 
  41.     have DEFAULT.SET, you get my choice.
  42.  
  43.            Do not try to change the order of the data in this file.
  44.     If you do, your BAUD rate will be very strange and the colours
  45.     even stranger. The only thing that you should change in this 
  46.     file is either the BAUD or the colours.
  47.  
  48.            BAUD can be set at
  49.                  . 300
  50.                  . 600
  51.                  . 1200
  52.                  . 2400
  53.                  . 4800
  54.                  . 9600     (lucky you)
  55.  
  56.           Colours can be set at
  57.                  . XXX
  58.                    |||========>  blue  values 0-9,a-f
  59.                    ||
  60.                    ||=========>  green values 0-9,a-f
  61.                    |
  62.                    |==========>  red   values 0-9,a-f
  63.                     
  64.                    000           is  black
  65.                    fff           is  white  
  66.                    00f           is  blue
  67.                    0f0           is  green
  68.                    f00           is  red
  69.  
  70.  
  71.            Some values in DEFAULT.SET file are irrelevant - half duplex
  72.     for example doesn't make much sense, as well as COM 1, COM 2.
  73.     (Hold overs from the IBM PC world.) Parity is also fixed for now.
  74.  
  75.  
  76.            Start the program from the CLI by:
  77.  
  78.      1>    CD AFTTERM
  79.      1>    AFTTERM
  80.  
  81.            ATDTXXXXXXX usually gets you connected. 
  82.     When you receive <CONNECT XXXX > , hit enter. A list of
  83.     emulators is displayed. Select IBM PC FTTERM Colour.
  84.     The number on your network may vary, but as an example
  85.     the IBM PC FTTERM colour is "1a" on our host system.
  86.     
  87.            KEYBOARD
  88.            ========
  89.    
  90.            The keyboard functions can be displayed using either the
  91.     help key or the menu - help . They are :
  92.  
  93.            RESET   - CTRL  r  ;- use this if parity or <OP> system code
  94.            RESHOW  - CTRL  u  ; -use if you need to redisplay the screen
  95.            INSERT  - CTRL  i  ; -insert key
  96.            CLEAR   - CTRL  c  ; -clear screen
  97.            ERASE   - CTRL  e  ; -erase end of file
  98.            PRINT   - CTRL  p  ; -print the screen
  99.            QUIT    - CTRL  q  ; -quit
  100.            ATTENTION CTRL  s  ; -system attention
  101.            PA1       CTRL  f1 ; -Page1 key
  102.            PA2       CTRL  f2 ; -Page2 key
  103.            PF1-PF10  F1 - F10 ; -
  104.            PF11-PF20 SHIFT F1 - F10 ;
  105.            PF1-PF12  NUMERIC PAD      AMIGA 1000 
  106.                                     ------------------------
  107.                                     | 7=PF1 | 8=PF2 | 9=PF3 |
  108.                                     |-------|-------|-------|
  109.                                     | 4=PF4 | 5=PF5 | 6=PF6 |
  110.                                     |-------|-------|-------|
  111.                                     | 1=PF7 | 2=PF8 | 3=PF9 |
  112.                                     |-------|-------|-------|
  113.                                     | 0=PF10        | .=PF11|
  114.                                     |-------|---------------|
  115.                                     | -=PF12|   ENTER       |
  116.                                     |_______|_______________|
  117.  
  118.           For the Amiga 500 or 2000, the keypad is slightly different,
  119.     but the keys will perform the same function.
  120.     (if you want a numeric key pad , sorry, old 3278
  121.     diehards want this too.) 
  122.  
  123.           All other keys are normal - delete, tab, backspace etc.
  124.    
  125.           If you have any problems using the keyboard, you can
  126.     always refer to (sigh) the 3708 reference manual.
  127.  
  128.  
  129.           Menu Selection
  130.           ==============
  131.  
  132.           The menu titled "PROG" contains the
  133.               . WINDOW to BACK function
  134.               . help
  135.               . credits
  136.               . quit
  137.  
  138.           The menu titled "BAUD" needs no further explaination.
  139.  
  140.           The menu titled "CONTROL" contains the special key functions
  141.               .  Reset - use if parity or <OP> conditions arise
  142.                         (<OP>-trying to type in a protected field).
  143.               .  Reshow - for a complete screen redisplay
  144.               .  Print Screen - Dumps the screen to printer
  145.               .  System Attention - takes you out to netsol
  146.               .  PA1 and PA2  -
  147.  
  148.            The menu titled FILE TRansfer will do nothing in
  149.      with this release. Read on.
  150.  
  151.            The menu titled COLOURS will also do nothing
  152.   
  153.            The menu titled Script will also do nothing.
  154.            
  155.           Printing
  156.           ========
  157.  
  158.      WARNING. IF YOU DO NOT HAVE A PRINTER DO NOT ATTEMPT TO PRINT.
  159.      THE PROGRAM WILL HANG, WAITING FOR YOU TO START YOUR PRINTER,
  160.      AND YOU MUST REBOOT.
  161.  
  162.           Print screen. Press CTRL-p. 
  163.  
  164.           Print dataset - you can print a host dataset by
  165.     using host printing functions. For example, using the TSO
  166.     DSPRINT function you can print the host dataset on your printer. 
  167.     IMS local prints can be directed to the printer as well. To do this,
  168.     the network must have the dial port defined as a MLU- a Multiple
  169.     Logical Unit. MLU's can be known as NAUs (Network addressable units).
  170.  
  171.            One dial port is a standard SLU-2, the additional
  172.     definition on the same port is a SLU-P. Define the SLU-P as a node
  173.     10 greater than the SLU-2 (for example). If the SLU-2 is defined
  174.     as DNODE002, then the printer node is defined as DNODE012.
  175.  
  176.           Print is directed to DNODE012(for example). This program will pick
  177.     up the datastream and print it.
  178.  
  179.           IMS local prints are simple. A change call to the alternate
  180.     IOPCB using the lterm DNODE012, then inserts to that PCB will
  181.     give you 3287 (printer) support.
  182.  
  183.           FILE TRANSFERS
  184.           ==============
  185.   
  186.           File transfers are possible. You will need to implement
  187.     a program similar to the IBM program IND$FILE. The program
  188.     is written in PLI and assembler, so you will need a PLI compiler,
  189.     an assembler and a linkage editor. (pretty common stuff).
  190.  
  191.           The file transfer has not been implemented in this release, as
  192.     you will need to download the source to the host. The easiest way
  193.     for most people to get the source to the host is through the IBM PC.
  194.     To receive the file transfer programs and the latest enhancements,
  195.     (menu colour, script, and file transfer), please donate sufficient
  196.     funds to cover costs of mailing, disks, and handling. Specify if you
  197.     want the programs on IBM format, or Amiga format. If IBM format,
  198.     specify 5-1/4  or 3 1/2. -  3 1/2 will be high density 1.2 meg.
  199.  
  200.            At present, the host file transfer system has been coded
  201.     for the MVS environment. If you need a file transfer for IMS,
  202.     you can take the PLI program and add the IMS code (IOPCBs, DBPCBs,etc)
  203.     and change the "DEFAULT.SET" host transfer file name to the IMS
  204.     transaction name. Code and use a totally blank MFS DIF/DOF. You
  205.     will also have to take out reference in the PLI program to the
  206.     DCBTPUT, DCBTGET, and DCBALLO . That's TSO stuff. Replace these
  207.     calls with inserts to the IOPCB and DBPCB . Be careful to keep the first
  208.     12 bytes the same. These represent the status code, block number,
  209.     checksum, and length  (in  character format). Then do all other IMS
  210.     gens.
  211.          
  212.            This transfer capability should be of special interest
  213.     to those IMS shops that are running GFIS and want to transfer
  214.     Amiga IFF files to an IMS Database.
  215.   
  216.  
  217.  
  218.            RELEASES
  219.            ========
  220.        
  221.            If you have some problems with this emulator or
  222.     have some constructive suggestions, write.
  223.     There are certain functions that I have not started work on
  224.     yet, ( menu colour, script) but then they are not critical.
  225.     
  226.            There will only be one more release. It will correct
  227.     any bugs that have been identified and incorporate the colour
  228.     and script enhancements. It is only available with file transfer
  229.     and will be sent out to those who request it when any and all the bugs
  230.     have been fixed. 
  231.             
  232.  
  233.           FINAL COMMENTS
  234.           =============
  235.  
  236.  
  237.            As IBM would say, no guarantee is suggested or implied - whatever
  238.     that means.
  239.            
  240.            KNOWN BUGS
  241.            ==========
  242.  
  243.            If you get a hit on your line that is picked up as
  244.      a start print stream character, and you do not have a printer,
  245.      you will hang.
  246.  
  247.            Concurrency with print streams and emulation has not
  248.      been integrated yet. Emulation will wait until the print stream
  249.      has finished. CTRL-U will reshow the last screen.
  250.  
  251.            If your business telephone line or personal line with "call
  252.      waiting" accepts incoming calls while you are connected,
  253.      you will probably get dropped.
  254.  
  255.    
  256.            Good luck.
  257.