home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / tt2man.zip / ttftran.doc < prev    next >
Text File  |  1993-12-10  |  31KB  |  819 lines
  1.  
  2.                              TABLE OF CONTENTS                              
  3.  
  4.  
  5.           9. File Transfer
  6.             9.1 Screen Capture
  7.             9.2 Ascii
  8.             9.3 Compuserv B+
  9.             9.4 XModem/YModem/ZModem
  10.               9.4.1 Overview
  11.               9.4.2 Procedures
  12.             9.5 IBM IND$FILE
  13.               9.5.1 Introduction
  14.               9.5.2 Procedures From Terminal Emulation
  15.                 9.5.2.1 Sending A PC File To The Host
  16.                 9.5.2.2 Receiving A PC File From The Host
  17.               9.5.3 Procedures From An OS/2 Session
  18.                 9.5.3.1 File Transfer Commands
  19.               9.5.4 VM/CMS Specific Requirements
  20.                 9.5.4.1 VM/CMS Command Format
  21.                 9.5.4.2 VM/CMS Positional Parameters
  22.                 9.5.4.3 VM/CMS Optional Parameters
  23.               9.5.5 TSO Specific Requirements
  24.                 9.5.5.1 TSO Command Format
  25.                 9.5.5.2 TSO Positional Parameters
  26.                 9.5.5.3 TSO Optional Parameters
  27.               9.5.6 CICS Specific Requirements
  28.                 9.5.6.1 CICS Command Format
  29.                 9.5.6.2 CICS Positional Parameters
  30.                 9.5.6.3 CICS Optional Parameters
  31.               9.5.7 IND$FILE Problem Resolution
  32.                 9.5.7.1 General
  33.                 9.5.7.2 Release Incompatibilities
  34.                 9.5.7.3 Common Error Messages
  35.                 9.5.7.4 Tips To Correcting File Transfer Errors
  36.             9.6 Kermit
  37.  
  38.  
  39.  
  40.                               9. File Transfer                              
  41.  
  42.  
  43.                              9.1 Screen Capture                             
  44.  
  45.  
  46. The most  basic of file transfer techniques is the Capturing of host  screen
  47. data  as it arrives on the PC.  TalkThru supports capturing this  data  both
  48. to text  files  or  to the Printer.  Screen Capture is  requested  from  the
  49. Terminal Emulation Window by selecting Capture from the File pull down  menu
  50. or by  using the Left MOUSE Button and clicking on the word Capture  on  the
  51. Status Line.
  52.  
  53. Once  a Capture File has been established, Screen Capture can be toggled  ON
  54. and OFF  by using the Left MOUSE Button and clicking on the word Capture  on
  55. the Status Line.  If Screen Capture is ON, the word Capture will be in  Bold
  56. Black.  If Screen Capture is OFF, the word Capture will be in light gray.
  57.  
  58.  
  59.  
  60.  
  61.                                  9.2 Ascii                                  
  62.  
  63.  
  64. TalkThru  supports  Ascii  File Transfer both to a host  and  from  a  host.
  65. Since Ascii File Transfer IS NOT error correcting, it is used when no  other
  66. file  transfer mechanisms are available or when the only way to  place  data
  67. into  a host application (i.e. an Editor or Word Processor) is to enter  the
  68. data  directly  on the screen.  Ascii Upload is the  process  of  requesting
  69. that an existing PC File be sent to the host as if it were keystrokes  being
  70. entered  at the terminal.  Ascii Download is very much like  Screen  Capture
  71. in that  it  merely takes any data that appears on  the  Terminal  Emulation
  72. Window and places it in a file.
  73.  
  74. To perform an Ascii Upload:
  75.  
  76. 1. Place  the  data you wish to have entered on the host screen  into  a  PC
  77.    file.
  78.  
  79. 2. Position  the  host application to receive the data  on  the  application
  80.    screen where it can be typed in.
  81.  
  82. 3. Request  Send  file and then Ascii from the File pull down  menu  on  the
  83.    Terminal Emulation Window.
  84.  
  85. 4. Select  the  PC  file  containing  the  data  you  want  entered  on  the
  86.    application screen.
  87.  
  88. The data from the PC file will be entered on the host application screen  as
  89. if it were quickly typed on the keyboard.
  90. Ascii Download works in the opposite manner.  To perform an Ascii Download:
  91.  
  92. 1. Position the host application on a screen where you can request that  the
  93.    data to be downloaded be listed on the Terminal Emulation Window.
  94.  
  95. 2. Request  Receive file... and then Ascii from the File pull down  menu  on
  96.    the Terminal Emulation Window.
  97.  
  98. 3. Indicate the PC file to receive the data being displayed on the  Terminal
  99.    Emulation Window.
  100.  
  101. 4. Return  to the Terminal Emulation Window and request that the data to  be
  102.    downloaded  be  displayed on the screen.  The data will  continue  to  be
  103.    displayed  on the Terminal Emulation Window as it is being placed in  the
  104.    PC file.
  105.  
  106. 5. When the data has completed being displayed, press the Stop Receive  push
  107.    button on the Ascii Receive dialog window.
  108.  
  109.  
  110.  
  111.  
  112.                               9.3 Compuserv B+                              
  113.  
  114.  
  115. Compuserv B+ File Transfer is used solely in conjunction with the  Compuserv
  116. Bulletin  Board.   To request the Compuserv B+ File Transfer,  request  Send
  117. file  or Receive file... and then Compuserv B+ from the File pull down  menu
  118. on the Terminal Emulation Window.
  119.  
  120.  
  121.  
  122.  
  123.                           9.4 XModem/YModem/ZModem                          
  124.  
  125.  
  126.  
  127. ┌────────────────┐
  128. │ 9.4.1 Overview │
  129. └────────────────┘
  130.  
  131.   The following  XModem,  YModem  and  ZModem  protocols  are  supported  by
  132.   TalkThru:
  133.  
  134.  
  135.  
  136.   XModem - CRC
  137.  
  138.    is the standard XModem file transfer with CRC error checking.
  139.  
  140.  
  141.   XModem - Checksum
  142.  
  143.    is the standard XModem file transfer with Checksum error checking.
  144.  
  145.  
  146.   XModem - 1K
  147.  
  148.    is a  single file protocol that is essentially XModem CRC with 1024  byte
  149.    packets.  It requires 8 data bits.
  150.  
  151.  
  152.   XModem - 1KG
  153.  
  154.    is the  same  as  XModem - 1K except that it does  not  provide  software
  155.    error  detection  or  recovery  -- it is  designed  for  use  with  error
  156.    correcting modems.
  157.  
  158.  
  159.   YModem
  160.  
  161.    this  the same as XModem - 1K except that it allows multiple files to  be
  162.    sent  in one transfer.  Filenames can be unique or contain  the  standard
  163.    wildcard characters * and ?.
  164.  
  165.  
  166.   YModem - G
  167.  
  168.    is the  same  as YModem except that it does not  provide  software  error
  169.    detection  or  recovery -- it is designed for use with  error  correcting
  170.    modems.
  171.  
  172.  
  173.  
  174.   ZModem
  175.  
  176.    is the standard ZModem file transfer.
  177.  
  178. ┌──────────────────┐
  179. │ 9.4.2 Procedures │
  180. └──────────────────┘
  181.  
  182.   From  a TalkThru Terminal Emulation Window, you invoke XModem  and  YModem
  183.   file transfer as follows:
  184.  
  185.   1. position your host session on the proper screen
  186.  
  187.   2. request the host to begin the file transfer process
  188.  
  189.   3. select Send File or Receive File from the File pull down menu
  190.  
  191.   4. select  the appropriate file transfer from the File  Transfer  Protocol
  192.      dialog
  193.  
  194.   5. indicate the OS/2 or host file name to be created by this file transfer
  195.  
  196.   During the file transfer process, a status dialog will appear.
  197.  
  198.   WARNING:
  199.        Once  the  file transfer is complete, the Status will be  updated  to
  200.        indicate  Complete, but the dialog will not go away until  you  press
  201.        Enter.
  202.  
  203.  
  204.  
  205.  
  206.                               9.5 IBM IND$FILE                              
  207.  
  208.  
  209.  
  210. ┌────────────────────┐
  211. │ 9.5.1 Introduction │
  212. └────────────────────┘
  213.  
  214.   TalkThru  will SEND or RECEIVE files communicating directly with  the  IBM
  215.   IND$FILE program on a VM/CMS, TSO, or CICS host.
  216.  
  217.   The following  sections  provide the procedures  for  performing  IND$FILE
  218.   File Transfer requests in the environments in which it is supported.
  219.  
  220.   WARNING:
  221.        The TalkThru  versions  of  the IBM SEND  and  RECEIVE  commands  are
  222.        called  TT2SEND.EXE  and TT2RECV.EXE respectively.  This is  so  that
  223.        there  will be no naming conflicts if you utilize TalkThru  and  3270
  224.        Sessions  on  the  same workstation.  If you are only  going  to  use
  225.        IND$FILE  File Transfer while within TalkThru asynchronous  sessions,
  226.        you may  rename  these  modules to SEND.EXE and  RECEIVE.EXE  if  you
  227.        wish.   They are present in the directory pointed to by the  TalkThru
  228.        PROGRAMS_DIRECTORY  Customization Variable.
  229.  
  230. ┌──────────────────────────────────────────┐
  231. │ 9.5.2 Procedures From Terminal Emulation │
  232. └──────────────────────────────────────────┘
  233.  
  234.  
  235.   ┌───────────────────────────────────────┐
  236.   │ 9.5.2.1 Sending A PC File To The Host │
  237.   └───────────────────────────────────────┘
  238.  
  239.     If you  wish to send a PC File to the host utilizing  IND$FILE,  perform
  240.     the following steps:
  241.  
  242.     1. Logon  to  the IBM CMS, TSO, or CICS system you wish to  receive  the
  243.        file.
  244.  
  245.     2. Position  yourself  on a host screen which will accept  the  IND$FILE
  246.        File Transfer command.
  247.  
  248.     3. Request  Send  file  from the File pull down  menu  on  the  Terminal
  249.        Emulator window.  
  250.  
  251.     From  this pull down menu, request the IND$FILE which matches your  host
  252.     environment and press Enter.
  253.  
  254.     The dialog that appears allows you to specify the PC and Host file names  
  255.     for  the  transfer.   Press  F1 or the  Help push button to  obtain more  
  256.     information on each of the fields on this window.  You may also refer to  
  257.     the IBM documentation on IND$FILE for more detailed information.
  258.  
  259.     Notice  that  the   default    PC     Data  Directory  is  the  TalkThru
  260.     DATA_DIRECTORY.   You may change this if you wish by providing the  full
  261.     file specification in the PC File dialog.
  262.  
  263.     Once you enter the file names and press Enter, the following will occur:
  264.  
  265.     1. The  Terminal Emulator window will be minimized on the bottom of  the
  266.        Desk Top.
  267.  
  268.     2. A status screen will appear indicating the progress of the transfer.
  269.  
  270.     If you  minimize  the status screen, it will appear as an  Icon  on  the
  271.     bottom  of  the  Desk Top, but will continue to provide  status  on  the
  272.     message line.
  273.  
  274.     Once  the file transfer is complete, the File Transfer window (or  Icon)
  275.     will  beep to inform you that a message is waiting and, once  maximized,
  276.     will cancel itself and maximize the Terminal Emulation Window.
  277.  
  278.   ┌───────────────────────────────────────────┐
  279.   │ 9.5.2.2 Receiving A PC File From The Host │
  280.   └───────────────────────────────────────────┘
  281.  
  282.     If you  wish  to  Receive a PC File from the  host  utilizing  IND$FILE,
  283.     perform the following steps:
  284.  
  285.     1. Logon  to  the IBM CMS, TSO, or CICS system you wish to  receive  the
  286.        file.
  287.  
  288.     2. Position  yourself  on a host screen which will accept  the  IND$FILE
  289.        File Transfer command.
  290.  
  291.     3. Request  Receive  file from the File pull down menu on  the  Terminal
  292.        Emulator window.  
  293.  
  294.     From  this  dialog  request   the   IND$FILE  which  matches  your  host
  295.     environment and press Enter.
  296.  
  297.     Depending  upon you Host Environment, you will now see a dialog  similar
  298.  
  299.     The dialog that appears allows you to specify the PC and Host file names  
  300.     for  the  transfer.   Press  F1 or the  Help push button to  obtain more  
  301.     information on each of the fields on this window.  You may also refer to  
  302.     the IBM documentation on IND$FILE for more detailed information.
  303.  
  304.     Notice  that  the   default    PC     Data  Directory  is  the  TalkThru
  305.     DATA_DIRECTORY.   You may change this if you wish by providing the  full
  306.     file specification in the PC File dialog.
  307.  
  308.     Once you enter the file names and press Enter, the following will occur:
  309.  
  310.     1. The  Terminal Emulator window will be minimized on the bottom of  the
  311.        Desk Top.
  312.  
  313.     2. A status screen will appear indicating the progress of the transfer.
  314.  
  315.     If you  minimize  the status screen, it will appear as an  Icon  on  the
  316.     bottom  of  the  Desk Top, but will continue to provide  status  on  the
  317.     message line.
  318.  
  319.     Once  the file transfer is complete, the File Transfer window (or  Icon)
  320.     will  beep to inform you that a message is waiting and, once  maximized,
  321.     will cancel itself and maximize the Terminal Window.
  322.  
  323. ┌───────────────────────────────────────┐
  324. │ 9.5.3 Procedures From An OS/2 Session │
  325. └───────────────────────────────────────┘
  326.  
  327.   You can  request  IND$FILE File Transfer from any OS\2 Session  prompt  or
  328.   from  an OS/2 Command File once you have positioned the Host Session to  a
  329.   screen that will accept a file transfer request.
  330.  
  331.   ┌────────────────────────────────┐
  332.   │ 9.5.3.1 File Transfer Commands │
  333.   └────────────────────────────────┘
  334.  
  335.     The following  two  commands are distributed with  TalkThru  to  perform
  336.     IND$FILE File Transfer:
  337.  
  338.     TT2SEND - This command will transfer a PC File to the Host.
  339.  
  340.     TT2RECV - This command will transfer a Host File to the PC.
  341.  
  342. ┌────────────────────────────────────┐
  343. │ 9.5.4 VM/CMS Specific Requirements │
  344. └────────────────────────────────────┘
  345.  
  346.  
  347.   ┌───────────────────────────────┐
  348.   │ 9.5.4.1 VM/CMS Command Format │
  349.   └───────────────────────────────┘
  350.  
  351.     The basic command format is:
  352.  
  353.   ┌──────────────────────────────────────────────────────────────────────┐
  354.   │ TT2SEND/TT2RECV  filespec [session-id:] filename filetype filemode   │
  355.   │                                                            ( options │
  356.   └──────────────────────────────────────────────────────────────────────┘
  357.  
  358.     A sample of the TT2RECV command would be:
  359.  
  360.         TT2RECV a:report.dat a: report script a (CRLF ASCII
  361.  
  362.   ┌──────────────────────────────────────┐
  363.   │ 9.5.4.2 VM/CMS Positional Parameters │
  364.   └──────────────────────────────────────┘
  365.  
  366.     filespec
  367.          The name  of the PC File. If the PC Name DOES NOT include disk  and
  368.          directory  information,  the file will be placed in  the  directory
  369.          specified by the DATA_DIRECTORY Customization Variable.
  370.  
  371.     session-id:
  372.          This  is the EHLLAPI session id of the TalkThru  Terminal  Emulator
  373.          session connected to the host environment.  It MUST be followed  by
  374.          a colon (:).
  375.  
  376.     filename
  377.          The VM/CMS File Name. This can be up to 8 characters in length.
  378.  
  379.     filetype
  380.          The VM/CMS  File Type. This is a required positional parameter  for
  381.          TT2SEND.  It  is an optional parameter for TT2RECV. If  it  is  not
  382.          specified, it will default to "*".
  383.  
  384.     filemode
  385.          The VM/CMS File Mode. This is an optional positional parameter.  If
  386.          this  parameter is omitted, the default for TT2SEND is "A" and  the
  387.          default for TT2RECV is "*".
  388.  
  389.   ┌────────────────────────────────────┐
  390.   │ 9.5.4.3 VM/CMS Optional Parameters │
  391.   └────────────────────────────────────┘
  392.  
  393.     The following  optional  parameters  must be  separated  from  the  last
  394.     positional parameter by a left parenthesis.
  395.  
  396.     ASCII
  397.            With  TT2SEND,  ASCII  causes  data  translation  from  ASCII  to
  398.            EBCDIC.  With TT2RECV, ASCII causes data translation from  EBCDIC
  399.            to ASCII. The default is NO TRANSLATION.
  400.  
  401.     CRLF
  402.            Specifying  CRLF  will maintain record level  integrity  in  both
  403.            directions.  With  TT2SEND, Carriage Return Line  Feeds  will  be
  404.            eliminated  but will trigger normal end of record. With  TT2RECV,
  405.            Carriage  Return  Line feeds will be appended at  end  of  record
  406.            locations. The default is no CRLF.
  407.  
  408.     APPEND
  409.            Causes  the file being transferred to be added to the end of  the
  410.            target file.
  411.  
  412.     LRECL n
  413.            Valid  for TT2SEND only. It provides a logical record length  for
  414.            the host file records.
  415.            
  416.            If an existing host file is being replaced, its record length  is
  417.            used  as  the record length of the new version  of  the  replaced
  418.            file except if LRECL is provided in this parameter list.
  419.            
  420.            When  LRECL is specified for a file which is being replaced,  the
  421.            specified values override the former record length of the file.
  422.            
  423.            If the  APPEND option is specified, the current record length  of
  424.            the file is used and the LRECL value specified is ignored.
  425.            
  426.            The default for LRECL is 80.
  427.  
  428.     RECFM F/V
  429.            Valid for TT2SEND only. This specifies the recording mode to  use
  430.            for the host file.
  431.            
  432.                F = Fixed Length
  433.                V = Variable Length
  434.            
  435.            The default  is F, unless the CRLF option is also  specified,  in
  436.            which case V is the default.
  437.  
  438. ┌─────────────────────────────────┐
  439. │ 9.5.5 TSO Specific Requirements │
  440. └─────────────────────────────────┘
  441.  
  442.  
  443.   ┌────────────────────────────┐
  444.   │ 9.5.5.1 TSO Command Format │
  445.   └────────────────────────────┘
  446.  
  447.     The basic command format is:
  448.  
  449.   ┌──────────────────────────────────────────────────────────────────────┐
  450.   │ TT2SEND/TT2RECV filespec                                             │
  451.   │       [session-id:]dsname(member)/password optio ns                  │
  452.   └──────────────────────────────────────────────────────────────────────┘
  453.  
  454.     A sample of the TT2RECV command would be:
  455.  
  456.         TT2RECV abc.txt a: reports(abc) ASCII
  457.  
  458.   ┌───────────────────────────────────┐
  459.   │ 9.5.5.2 TSO Positional Parameters │
  460.   └───────────────────────────────────┘
  461.  
  462.     filespec
  463.          The name  of the PC File. If the PC Name DOES NOT include disk  and
  464.          directory  information,  the file will be placed in  the  directory
  465.          specified by the DATA_DIRECTORY Customization Variable.
  466.  
  467.     session-id:
  468.          This  is the EHLLAPI session id of the TalkThru  Terminal  Emulator
  469.          session connected to the host environment.  It MUST be followed  by
  470.          a colon (:).
  471.  
  472.     dsname
  473.          The TSO File Name. This can be up to 44 characters in length.
  474.  
  475.     member
  476.          This  is a required positional parameter for Partitioned Data  Sets
  477.          (PDS). The PDS must exist before a TT2SEND command can occur.
  478.  
  479.     /password
  480.          Optional  parameter allowing access to password protected  Physical
  481.          Sequential or Partitioned Data Sets.
  482.  
  483.   ┌─────────────────────────────────┐
  484.   │ 9.5.5.3 TSO Optional Parameters │
  485.   └─────────────────────────────────┘
  486.  
  487.     The following  optional  parameters are valid for  TT2SEND  and  TT2RECV
  488.     commands. They are separated from the rest of the command and from  each
  489.     other by a space.
  490.  
  491.     ASCII
  492.            With  TT2SEND,  ASCII  causes  data  translation  from  ASCII  to
  493.            EBCDIC.  With TT2RECV, ASCII causes data translation from  EBCDIC
  494.            to ASCII. The default is NO TRANSLATION.
  495.  
  496.     CRLF
  497.            Specifying  CRLF  will maintain record level  integrity  in  both
  498.            directions.  With  TT2SEND, Carriage Return Line  Feeds  will  be
  499.            eliminated  but will trigger normal end of record. With  TT2RECV,
  500.            Carriage  Return  Line feeds will be appended at  end  of  record
  501.            locations. The default is no CRLF.
  502.  
  503.     APPEND
  504.            Causes  the file being transferred to be added to the end of  the
  505.            target file.
  506.  
  507.  
  508.     The following  optional parameters are only valid for  TT2SEND  commands
  509.     and the Data Set is Physical Sequential.
  510.  
  511.     LRECL(n)
  512.            Provides a logical record length for the host file records. 
  513.            
  514.            In the  case  of RECFM U or V, this is the  maximum  record  size
  515.            expected.
  516.            
  517.            If a  file  is  being  replaced,  or  if  the  APPEND  option  is
  518.            specified,  LRECL  MUST NOT be specified. In this case,  the  old
  519.            LRECL is utilized.
  520.            
  521.            The default  LRECL  for  RECFM F or U is 80,  for  RECFM  V,  84,
  522.            except under the APPEND conditions itemized above.
  523.  
  524.     BLKSIZE(n)
  525.            Provides the desired block size for the Host File.
  526.            
  527.            The default  for  BLKSIZE is LRECL for new files and  is  ignored
  528.            for APPEND or replace.
  529.  
  530.     RECFM(F,V,U)
  531.            Specifies the recording mode to use for the Host File.
  532.            
  533.              F = Fixed Length
  534.              V = Variable Length
  535.              U = Undefined Record Type
  536.            
  537.            The default  is F, unless the CRLF option is also  specified,  in
  538.            which case V is the default.
  539.  
  540.     SPACE(q,i)
  541.            Specifies  the  amount of space to be allocated for  a  new  Host
  542.            File.
  543.  
  544.            q
  545.             - the number of units of space to be added to the Data Set  each
  546.               time the previously allocated space has been filled.
  547.  
  548.            i
  549.             - the  number  of  units (increment) of space  to  be  allocated
  550.               initially  for a Data Set. This parameter is required  if  the
  551.               SPACE parameter is provided.
  552.            The default is SPACE(10,50).
  553.  
  554.     AVBLOCK(n)
  555.            This is only valid if SPACE is also provided. This specifies  the
  556.            average block length for the output Data Set.
  557.  
  558.     TRACKS
  559.            This  is  only valid if SPACE is also specified.  This  specifies
  560.            that the unit of space is to be by track.
  561.  
  562.     CYLINDERS
  563.            This is only valid if SPACE is also specified.
  564.  
  565.     NOTE:
  566.        The AVBLOCK,  TRACKS,   and      CYLINDERS  parameters  are  mutually
  567.        exclusive.  The  host  will reject the request if more  than  one  is
  568.        specified. If none of them are specified, the BLKSIZE parameter  will
  569.        be used as the unit value for SPACE.
  570.  
  571. ┌──────────────────────────────────┐
  572. │ 9.5.6 CICS Specific Requirements │
  573. └──────────────────────────────────┘
  574.  
  575.  
  576.   ┌─────────────────────────────┐
  577.   │ 9.5.6.1 CICS Command Format │
  578.   └─────────────────────────────┘
  579.  
  580.     The basic command format is:
  581.  
  582.   ┌──────────────────────────────────────────────────────────────────────┐
  583.   │ TT2SEND  filespec [session-id:]fn ( options ) comments               │
  584.   │                                                                      │
  585.   │ TT2RECV  filespec [session-id:]fn ( options                          │
  586.   └──────────────────────────────────────────────────────────────────────┘
  587.  
  588.     A sample of the TT2RECV command would be:
  589.  
  590.         TT2RECV abc.txt a: myfile ( ASCII
  591.  
  592.   ┌────────────────────────────────────┐
  593.   │ 9.5.6.2 CICS Positional Parameters │
  594.   └────────────────────────────────────┘
  595.  
  596.     filespec
  597.          The name  of the PC File. If the PC Name DOES NOT include disk  and
  598.          directory  information,  the file will be placed in  the  directory
  599.          specified by the DATA_DIRECTORY Customization Variable.
  600.  
  601.     session-id:
  602.          This  is the EHLLAPI session id of the TalkThru  Terminal  Emulator
  603.          session connected to the host environment.  It MUST be followed  by
  604.          a colon (:).
  605.  
  606.     fn
  607.          The CICS File Name. This can be up to 8 characters in length.
  608.  
  609.   ┌──────────────────────────────────┐
  610.   │ 9.5.6.3 CICS Optional Parameters │
  611.   └──────────────────────────────────┘
  612.  
  613.     The CICS  File  Transfer  command   can   have  two  types  of  optional
  614.     parameters:
  615.  
  616.      o Options
  617.  
  618.      o Comments (for TT2SEND only)
  619.  
  620.     They are separated as shown in the example under "CICS Command Format".
  621.  
  622.     The possible "Options" are:
  623.  
  624.      - ASCII or BINARY
  625.  
  626.      - CRLF or NOCRLF
  627.  
  628.     "comments"  may  be  used for control information to be  stored  in  the
  629.     first record of the Host File for the TT2SEND command only.
  630.  
  631. ┌───────────────────────────────────┐
  632. │ 9.5.7 IND$FILE Problem Resolution │
  633. └───────────────────────────────────┘
  634.  
  635.  
  636.   ┌─────────────────┐
  637.   │ 9.5.7.1 General │
  638.   └─────────────────┘
  639.  
  640.     The following sections describe various conditions which may cause  File
  641.     Transfer  errors.  Many of them reference timing parameters that can  be
  642.     modified to help File Transfer perform better.  All of these  parameters
  643.     can be  changed by making the following selections from any  Phone  Book
  644.     or Terminal Emulator window.
  645.  
  646.       1. Select File Transfer from the Settings pull down menu.
  647.    
  648.       2. Select IND$FILE from the File Transfer menu.
  649.  
  650.     Once you have done this, you will see the "IND$FILE Settings" dialog.
  651.  
  652.     From this dialog you can change any of the Timing Parameters  referenced
  653.     below.    If you request this dialog from Terminal  Emulation,  you  can
  654.     make  the changes temporarily and then exit Terminal  Emulation  without
  655.     saving them permanently.
  656.  
  657.   ┌───────────────────────────────────┐
  658.   │ 9.5.7.2 Release Incompatibilities │
  659.   └───────────────────────────────────┘
  660.  
  661.     In some rare instances where your host environment does not contain  the
  662.     most  recent versions of IND$FILE, File Transfer may terminate with  the
  663.     following message appearing on the Terminal Emulator screen:
  664.  
  665.     16 Incorrect request code:  file transfer canceled$
  666.  
  667.     If this  appears  consistently when you are using Send and  Receive,  it
  668.     may be  that an old version of IND$FILE is present on your host.  Before
  669.     contacting  the  SCA  Hotline, try adding  the  following  Customization
  670.     Variable to the TalkThru Customization File:
  671.  
  672.             IND$FILE_VERSION=MODIFIED
  673.  
  674.     Refer  to  the  Chapter,  The   TalkThru  Customization  File  for  more
  675.     information on how these variables are changed.
  676.  
  677.   ┌───────────────────────────────┐
  678.   │ 9.5.7.3 Common Error Messages │
  679.   └───────────────────────────────┘
  680.  
  681.  
  682.  
  683.   "CRC Error, Retrying ..."  <R><R>    OR<R><R>The IND$FILE file transfer program has detected a significant number of transmission ERRORS ..."
  684.  
  685.     This  message  usually occurs when the data CHECK DIGIT does  not  match
  686.     the Received  or Sent data check digit. The problem is mostly due to  an
  687.     unstable  (noisy) communications line. If the problem  persists,  either
  688.     have  the  communications  line    checked,  or  increase  the  IND$FILE
  689.     parameter (Maximum Consecutive Errors..).
  690.  
  691.  
  692.   "the HOST is NOT Responding, or<R>    the HOST is NOT Responding as Expected ..."
  693.  
  694.  
  695.     During  file  transfer, the transfer program either scans  the  terminal
  696.     buffer  looking for a particular pattern of data at a particular  screen
  697.     location,  or  it  waits until the cursor is moved  to  a  known  screen
  698.     position.  If  neither of these conditions are met, within  a  specified
  699.     period  of time, an error occurs.  This wait time is controlled  by  the
  700.     IND$FILE  parameter (Host response timeout). If you have a  particularly
  701.     sluggish  Host,  or  your Host has periods of  long  waits,  you  should
  702.     increase this parameter.
  703.  
  704.  
  705.   "the BURST ECHO option has detected a TIMEOUT ..."
  706.  
  707.     This  message occurs when the data being sent to the Host is being  sent
  708.     too fast.  Occasionally  a Host controller will "get  confused"  by  the
  709.     data  being  sent to it. The controller will just STOP.  To  get  around
  710.     this  problem File Transfer will attempt to restart the  controller.  If
  711.     this restart does not seem to work, or if another timeout error  occurs,
  712.     you will get this error message. Possible solutions:
  713.  
  714.       1. Decrease "Burst size" (number of characters sent at one time).
  715.  
  716.       2. Increase "Burst delay" (time between bursts).
  717.  
  718.       3. Increase "Burst wakeup count (number of times to nudge Host).
  719.  
  720.       4. Increase "Burst echo timeout (time between nudges).
  721.  
  722.   ┌─────────────────────────────────────────────────┐
  723.   │ 9.5.7.4 Tips To Correcting File Transfer Errors │
  724.   └─────────────────────────────────────────────────┘
  725.  
  726.     1. The following keys MUST be correctly defined:
  727.  
  728.            PF1 and PF2
  729.            TAB and ERASE_EOF (upload only)
  730.            RESET
  731.            LEFT and RIGHT Arrows
  732.            HOME
  733.            ENTER
  734.  
  735.      Get into  terminal emulation and verify that all of the  required  keys
  736.      are properly defined.
  737.  
  738.     2. During  your  first  few    file  transfers,  MAXIMIZE  the  Terminal
  739.        Emulator's  Window.  This will allow you to watch the  file  transfer
  740.        take  place. For RECEIVE, the transfer should be uniform  and  smooth
  741.        as  the screen fills with characters. For SEND, the  transfer  should
  742.        be  smooth  during  a BURST of sent characters.  After  a  BURST  you
  743.        should  see a slight PAUSE (Burst delay), then another  Burst,  etc..
  744.        If  the transfer seems jerky (high hesitations) you are  experiencing
  745.        a lot of Host stops (confused controllers).
  746.  
  747.         Symptom:
  748.  
  749.             The Host Stops,
  750.  
  751.                 File transfer nudges "Burst wakeup count"  | Hesitations
  752.                 File transfer waits  "Burst Echo"   |
  753.  
  754.             Hopefully transfer continues.
  755.  
  756.      If you  see  this erratic file transfer, try  various  combinations  of
  757.      "Burst size", and "Burst delay". If these changes do not seem to  work,
  758.      try varying the "Burst echo" time.
  759.  
  760.     NOTES:
  761.  
  762.       1. Try  not to increase the "Burst delay" too much. This could  impact
  763.          file transfer throughput.
  764.  
  765.       2. If  you receive CRC errors - have the communications  line  checked
  766.          as  these errors force file transfer to resend already  transferred
  767.          data.
  768.  
  769.       3. Try  to  maximize the "Burst size" and minimize  "Burst  delay"  as
  770.          long  as  it does not increase the "confused  controller  syndrome"
  771.          (hesitations).
  772.  
  773.  
  774.  
  775.  
  776.                                  9.6 Kermit                                 
  777.  
  778.  
  779. The Kermit file transfer has been implemented within TalkThru in two ways:
  780.  
  781.  - You  may  SEND or RECEIVE a single file to/from any host  which  supports
  782.    the Kermit Protocol.
  783.  
  784.  - You  may  invoke  Kermit Remote if you are attached to  a  host  where  a
  785.    Kermit Server is active.
  786.  
  787. To request to SEND or RECEIVE a file, you must:
  788.  
  789. 1. be connected to a host environment which supports Kermit File Transfer
  790.  
  791. 2. select  Send  or  Receive from the File pull down menu  on  any  Terminal
  792.    Emulator screen
  793.  
  794. 3. request Kermit from the File Transfer Protocol Selection dialog
  795.  
  796. If you wish to establish yourself as a Kermit Remote application, you must:
  797.  
  798. 1. position yourself on a host environment which supports the Kermit  Server
  799.    function
  800.  
  801. 2. select  Kermit  Remote  from  the File pull down  menu  on  any  Terminal
  802.    Emulator screen
  803.  
  804. Online  help  is available from every dialog.  There is also  the  following
  805. additional help available from the Help Index.
  806.  
  807.  
  808. remote (KERMIT)
  809.  
  810.  Provides more information on utilizing the Kermit Remote facility.
  811.  
  812.  
  813. transfer parameters (KERMIT)
  814.  
  815.  Provides  detailed  information on the parameters you can  modify  to  tune
  816.  your  file  transfer  requests.  These parameters are  modified  through  a
  817.  dialog  available from the Interfaces menu item on the Settings  pull  down
  818.  menu.
  819.