home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / MODEM / BONEZ.ZIP / BONE$.DOC < prev    next >
Text File  |  1994-01-13  |  33KB  |  886 lines
  1. *-----------------------------------------------------------------------------*
  2.                               B e a r   B o n e $
  3.            "The IND$FILE-Compatible External File Transfer Protocol"
  4.        Copyright (c) 1993  Computer Vectors, Inc.  All rights reserved.
  5.                     TECHNICAL REFERENCE MANUAL - VERSION 2.5
  6. *-----------------------------------------------------------------------------*
  7.  
  8.  
  9.  
  10. Computer Vectors, Inc.
  11. 74-5599 Luhia St., Suite E-7
  12. Kailua-Kona, Hawaii 96740
  13.  
  14. Marketing.............1-808-329-6645
  15. Tech Support..........1-808-329-5426
  16. Bulletin Board........1-808-329-5142
  17. FAX...................1-808-329-6523
  18.  
  19.  
  20.  
  21. *-----------------------------------------------------------------------------*
  22.                                  INTRODUCTION
  23. *-----------------------------------------------------------------------------*
  24.  
  25. BEAR BONE$ is an IND$FILE external protocol designed to work with most any PC-
  26. based asynchronous communications package. It allows the user to transfer text
  27. and binary files to and from IBM hosts that support IND$FILE.
  28.  
  29.  
  30.  
  31. *-----------------------------------------------------------------------------*
  32.                                  REQUIREMENTS
  33. *-----------------------------------------------------------------------------*
  34.  
  35. You will need an asynchronous communications package such as PROCOMM Plus,
  36. PROCOMM for Windows, DYNACOMM, Q-MODEM, HYPERACCESS/5, etc..  It must support 
  37. the use of external protocols OR have the ability to shell-out to DOS while 
  38. on-line.  It must also emulate one of the following terminals:
  39.  
  40.     VT100
  41.     ANSI
  42.     3101
  43.     FTTERM
  44.     HYDRA/PCCR
  45.     TV950 (Procomm 3270/950)
  46.  
  47.     
  48. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  49. NOTE FOR WINDOWS USERS:
  50.  
  51.     Two options: BDR=<number> and BTS=ABC (explained near the end of the
  52.     "BEAR BONE$ OPTIONS" section) must be set to use BEAR BONE$ with a
  53.     "true" Windows communications product.  These options deal with the way
  54.     Windows resets the communications port when opening a "DOS BOX".
  55.  
  56.     Also, you should set the device contention to "never warn" under the
  57.     386 Enhanced options of the control panel.
  58.     
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60.     
  61. Among others, BEAR BONE$ is compatible with the following protocol converters:
  62.  
  63.     DATALYNX 3174
  64.     HYDRA II
  65.     HYDRA SNA
  66.     HYDRA 3000
  67.     IBM 3708
  68.     IBM 3174 w/AEA
  69.     IBM 7171
  70.     IBM 9370
  71.     INTERLYNX
  72.     TYMNET
  73.  
  74. ...and has been tested to work with the following communications packages:
  75.  
  76.     CEDER ISLAND LINK
  77.     COM-AND
  78.     CROSSTALK MK. IV
  79.     CROSSTALK FOR WINDOWS
  80.     DYNACOMM ASYNCHRONOUS FOR WINDOWS
  81.     FTTERM
  82.     HYPERACCESS/5
  83.     HYPERACCESS FOR WINDOWS
  84.     MICROPHONE PRO FOR WINDOWS
  85.     MIRROR III
  86.     MIRROR FOR WINDOWS
  87.     PERELINE
  88.     PROCOMM PLUS
  89.     PROCOMM PLUS FOR WINDOWS
  90.     PROCOMM PLUS NETWORK VERSION
  91.     QMODEM
  92.     RCOM-2/PC
  93.     RELAY
  94.     REXXTERM
  95.     SimPC
  96.     UNICOM
  97.     TELIX
  98.     
  99. Please call 1-808-329-5426 if you have a protocol converter that is not on
  100. the list, or if you have any other compatibility questions.
  101.  
  102.  
  103.  
  104. *-----------------------------------------------------------------------------*
  105.                 EXTERNAL PROTOCOL SETUP FOR PROCOMM-PLUS v2.01
  106. *-----------------------------------------------------------------------------*
  107.  
  108. From PROCOMM's terminal mode, hit ALT-S to bring up the setup menu, then select
  109. PROTOCOL OPTIONS.  Next, select EXTERNAL PROTOCOL OPTIONS.  Here is a sample
  110. setup for BEAR BONE$ using a parameter file named VM.PRM:
  111.  
  112.     EXTERNAL PROTOCOL 1
  113.     A- Name ................  BONE$
  114.     B- Type ................  PROGRAM
  115.     C- Upload command ......  BONE$ VM PUT
  116.     H- Download command ....  BONE$ VM GET
  117.  
  118. Once set up, BEAR BONE$ will appear on PROCOMM's upload and download protocol
  119. selection boxes.  After you choose BEAR BONE$ as the protocol type, you will
  120. be prompted to "Enter parameters:".  You only need to enter the PC filename 
  121. followed by the mainframe filename and mainframe options, like this:
  122.  
  123.     C:\AUTOEXEC.BAT JUNK TEST A (ASCII CRLF
  124.  
  125.  
  126.  
  127. *-----------------------------------------------------------------------------*
  128.               EXTERNAL PROTOCOL SETUP FOR PROCOMM-PLUS FOR WINDOWS
  129. *-----------------------------------------------------------------------------*
  130.  
  131. We have included a script file for use with PROCOMM-PLUS for WINDOWS.  We
  132. recommend that you bind a meta-key to the script file ("BONE$.WAS") to make
  133. it easier to use.
  134.  
  135. The script simply pops up a dialog box and asks you to "Enter parameters:".
  136. Unlike PROCOMM-PLUS for DOS, you must type in "PUT" or "GET" before entering
  137. the PC filename and mainframe filename:
  138.  
  139.     PUT C:\AUTOEXEC.BAT JUNK TEST A (ASCII CRLF
  140.  
  141.  
  142.  
  143. *-----------------------------------------------------------------------------*
  144.                    EXTERNAL PROTOCOL SETUP FOR QMODEM v4.31
  145. *-----------------------------------------------------------------------------*
  146.  
  147. Type ALT-N from QMODEM's terminal mode.  Next, select the PROTOCOLS pull-down
  148. menu.  Here is a sample setup:
  149.  
  150.     Select Character    $
  151.     Protocol            BONE$
  152.     Upload BAT          BONE$ VM PUT
  153.     Download BAT        BONE$ VM GET
  154.     Filename Prompt     Y
  155.  
  156. Once set up, BEAR BONE$ will appear on QMODEM's upload and download protocol
  157. selection boxes.  After you choose BEAR BONE$ as the protocol type, you will
  158. be prompted with "Upload file allocation:".  You only need to enter the PC
  159. filename followed by the mainframe filename and mainframe options, like this:
  160.  
  161.     C:\AUTOEXEC.BAT JUNK TEST A (ASCII CRLF
  162.  
  163.  
  164.  
  165. *-----------------------------------------------------------------------------*
  166.                               WHAT'S ON THE DISK
  167. *-----------------------------------------------------------------------------*
  168.  
  169. ORDER   .FRM    BEAR BONE$ order form
  170. BONE$   .EXE    The BEAR BONE$ executable program
  171. BONE$   .PRM    Default parameter file
  172. BONE$   .DOC    This document
  173. BONE$   .WAS    Script file for PROCOMM Plus for Windows
  174. RECEIVE .BAT    Sample batch file for downloading
  175. SEND    .BAT    Sample batch file for uploading
  176. GENERIC .111    Sample parameter file for a generic protocol converter using
  177.                 VT100 emulation - Modify this parameter file to suit your
  178.                 protocol converter
  179. 3174-31 .111    3174 using 3101 emulation
  180. 3174-FT .111    3174 using FTTERM emulation
  181. 3174-TV .111    3174 using TV950 emulation
  182. 3174-VT .111    3174 using VT100 emulation
  183. 3270-950.111    Generic protocol converter using PROCOMM 3270/950 emulation -
  184.                 Modify this file to suit your protocol converter
  185. 3708-31 .111    3708 using 3101 emulation
  186. 3708-31 .1      3708 using 3101 emulation and IND$FILE version 1
  187. 3708-FT .111    3708 using FTTERM emulation
  188. 3708-FT .1      3708 using FTTERM emulation and IND$FILE version 1
  189. 3708-TV .111    3708 using TV950 emulation
  190. 3708-VT .111    3708 using VT100 emulation
  191. 7171-31 .111    7171 using 3101 emulation
  192. 7171-TV .111    7171 using TV950 emulation
  193. 7171-VT .111    7171 using VT100 emulation
  194. HYII-HY .111    HYDRA-II using HYDRA/PCCR emulation
  195.  
  196.  
  197.  
  198. *-----------------------------------------------------------------------------*
  199.                        DETERMINING THE IND$FILE VERSION
  200. *-----------------------------------------------------------------------------*
  201.  
  202. Before you attempt a transfer, it is important to find out what version of
  203. IND$FILE is running on the host.  Please follow the steps below:
  204.  
  205.     1)  Dial or connect to the host using your terminal emulation software.
  206.     
  207.     2)  Log on to your account.
  208.     
  209.     3)  Get to the "Ready" state by issuing a "Clear-Screen" command or
  210.         <Control-C>.
  211.         
  212.     4)  Type "IND$FILE PTP <MF File Name>", followed by <Enter>.
  213.         (Please see the MAINFRAME OPTIONS sections for examples of valid
  214.          mainframe file names.)
  215.              
  216.     5)  IF VERSION 1.1.1 IS RUNNING,
  217.  
  218.         the screen will clear and "Caaa" will appear in the upper left hand
  219.         corner.  Press the <PF2> or <Clear> key several times to cancel the
  220.         transfer.  In this case, you should specify the following options in
  221.         your parameter file (more on parameter files in the next section):
  222.         
  223.             SEN=IND$FILE PTP
  224.             REC=IND$FILE GTP
  225.  
  226.     6)  IF VERSION 1 IS RUNNING, EITHER
  227.  
  228.         ... the screen will clear and the cursor will move to the bottom right
  229.         hand corner of the screen.  You are running version 1 but DO NOT have
  230.         "non-display" fields available.  You will either need to modify your
  231.         protocol converter's TDF (terminal definition file) or get an upgrade
  232.         to version 1.1.1 of IND$FILE.
  233.  
  234.         ... OR the screen will clear and you will get a "TRANS16 Incorrect
  235.         request code: file transfer canceled$" or similar message.  You are
  236.         running version 1 of IND$FILE.  Use the following options in your
  237.         parameter file:
  238.         
  239.             SEN=IND$FILE PUT
  240.             REC=IND$FILE GET
  241.  
  242.  
  243.  
  244. *-----------------------------------------------------------------------------*
  245.                               INVOKING BEAR BONE$
  246. *-----------------------------------------------------------------------------*
  247.  
  248. Before invoking BEAR BONE$, be sure that you are in the "READY" state on the
  249. host.  This is normally done by hitting the <Clear> key or Control-C.  If
  250. you'd like, you can include the code for the <Clear> key in the PRE=
  251. parameter.
  252.  
  253. Now, call up BEAR BONE$ by invoking it as an external protocol (see one of
  254. the EXTERNAL PROTOCOL SETUP sections below), or if your communications
  255. package doesn't have this feature, shell out to DOS and type in your command
  256. line manually.
  257.  
  258. The format of a BEAR BONE$ command line looks like the following:
  259.  
  260.     BONE$ <Param-file> PUT|GET <PC-file> <MF-file> [<MF-options>]
  261.  
  262. <Param-file> is the name of a file containing multiple lines of BEAR BONE$
  263. options (see BEAR BONE$ OPTIONS below).  Any line that does not have an
  264. EQUAL SIGN in it is considered to be a comment line and is discarded.  
  265. Another way to comment a line out is to put a semicolon at the BEGINING of
  266. the line.  Here is a sample parameter file:
  267.  
  268.     ******************************************************************
  269.     ***  VM IND$FILE 1.1.1 using FTTERM emulation on a 3174 w/AEA  ***
  270.     ******************************************************************
  271.     
  272.     SEND AND RECEIVE COMMANDS
  273.     -------------------------
  274.     sen=ind$file ptp
  275.     rec=ind$file gtp
  276.     
  277.     ERR-CHECK METHOD, TYPE-AHEAD BUFFER LENGTH, ETC..
  278.     -------------------------------------------------
  279.     err=auto
  280.     buf=2000
  281.     blk=700
  282.     dly=0
  283.     
  284.     TERMINAL TYPE AND KEY SEQUENCES
  285.     -------------------------------
  286.     trm=ftterm               
  287.     ent=^m                   
  288.     rht=^[c                  
  289.     rst=^r                   
  290.     try=^[r                  
  291.     can=^[2^m
  292.     pre=^[>^[o
  293.     pst=^[<<^[p^c
  294.     
  295.     COMMUNICATION PORT OPTIONS
  296.     --------------------------
  297.     prt=1
  298.     adr=0
  299.     irq=0
  300.  
  301. Unless a path is specified for the parameter file, BEAR BONE$ will first try
  302. and open a parameter file from the same path where the BEAR BONE$ executable
  303. is located.  If it can't find it, BEAR BONE$ will try and open it from your
  304. current path.  This means that you are able to conveniently place all your
  305. parameter files in one directory.  We suggest that you put BEAR BONE$ and
  306. its associated parameter files in the same directory as your communications
  307. software.
  308.  
  309. You may omit the <Param-file> if you have a file named BONE$.PRM in either
  310. your current directory, or in the same directory as your BONE$.EXE.
  311.  
  312. Next on the command line, you need to specify either a PUT to send a file to
  313. the host, or a GET to download a file from the host.  You may abbreviate these
  314. to P and G.  Also, SEND and RECEIVE are valid and will perform the same
  315. functions as PUT and GET.
  316.  
  317. <PC-file> is the name of the file on the PC.  If you are doing a PUT, data is
  318. read from this file and transmitted to the host.  If you are doing a GET,
  319. this file is created and host data is written to it.
  320.  
  321. <MF-file> is a proper file name, or data set name on your mainframe.
  322.  
  323. <MF-options> are file format and translation options that are available
  324. on your mainframe IND$FILE program (see MAINFRAME OPTIONS below).
  325.  
  326.  
  327.  
  328. *-----------------------------------------------------------------------------*
  329.                                 BATCH TRANSFERS
  330. *-----------------------------------------------------------------------------*
  331.  
  332. If you would like to do batch transfers, you may use a command line like
  333. this:
  334.  
  335.     BONE$ <Param-file> @<List-file>
  336.  
  337. Each line of the <List-file> should contain one transaction.  Here's an
  338. example:
  339.  
  340.     PUT C:\AUTOEXEC JUNK TEST A
  341.     GET JUNK. JUNK TEST A
  342.     PUT D:DATA.FIL JUNK DATA A
  343.  
  344.     
  345.         
  346. *-----------------------------------------------------------------------------*
  347.                               BEAR BONE$ OPTIONS
  348. *-----------------------------------------------------------------------------*
  349.  
  350.  
  351. MAINFRAME STRINGS
  352. -----------------
  353.  
  354. SEN=<string>                        (Default: SEN=IND$FILE PTP)
  355. SEND=<string>
  356.  
  357.     This is the string that BEAR BONE$ will send to the mainframe to invoke
  358.     an upload.  You would normally use IND$FILE PTP if your mainframe is
  359.     running version 1.1.1 of IND$FILE, or IND$FILE PUT if your mainframe
  360.     is running version 1 of IND$FILE.
  361.  
  362. REC=<string>                        (Default: REC=IND$FILE GTP)
  363. RECEIVE=<string>
  364.  
  365.     BEAR BONE$ will send this string to the mainframe to initiate a download.
  366.     You should use either IND$FILE GTP (v1.1.1) or IND$FILE GET (v1).
  367.  
  368. OPT=<string>                        (Default: NOT USED)
  369. OPTIONS=<string>
  370. PARAMETERS=<string>
  371. DEFAULTS=<string>
  372.  
  373.     Default mainframe options used if none specified on the command line.
  374.  
  375.     Example:
  376.         OPT=(ASCII CRLF
  377.             or
  378.         DEFAULTS=(BINARY NOCRLF
  379.  
  380.         
  381. RELIABILITY OPTIONS
  382. -------------------
  383.     
  384. ERR=AUTO|CHECKSUM|CRC               (Default: ERR=AUTO)
  385. ERRORCHECK=AUTO|CHECKSUM|CRC
  386.  
  387.     This option is only available for uploads.
  388.  
  389.     ERR=AUTO will cause BEAR BONE$ to determine the type of error checking
  390.     that is performed on the mainframe.  This is a typically used option,
  391.     but is not recommended for use with the CICS IND$FILE.
  392.         
  393.     ERR=CHECKSUM forces BEAR BONE$ to use a one byte checksum error detection.
  394.     Use this option only if your mainframe is running version 1 of IND$FILE,
  395.     or running a CICS version.
  396.  
  397.     ERR=CRC tells BEAR BONE$ to use an advanced 6 byte CRC (Cyclical
  398.     Redundancy Check).  Version 1.1.1 supports this feature.
  399.  
  400. BUF=<number from 1 to 2000>        (Default: BUF=50)
  401. BUFFERSIZE=<number from 1 to 2000>
  402. TYPEAHEAD=<number from 1 to 2000>
  403. KEYBOARDBUFFER=<number from 1 to 2000>
  404. PACING=<number from 1 to 2000>
  405.  
  406.     Specifies the size of your protocol converter's type-ahead buffer.  When
  407.     sending a file, BEAR BONE$ will never be more than <number> characters
  408.     ahead of echoed back characters.  Generally, the lower the number, the
  409.     slower the transfer will be.  On the other hand, if BUF is set too high,
  410.     your protocol converter may disconnect, or lock up on you during your
  411.     transfer.  Experiment to get the best results.
  412.  
  413. BLK=<number from 200 to 1914>       (Default: BLK=1914)
  414. BLOCKSIZE=<number from 200 to 1914>
  415. FRAMESIZE=<number from 200 to 1914>
  416.  
  417.     Sets the block size of the data for uploads only. As with the BUF
  418.     parameter, a small block size will slow the transfer.  Use this 
  419.     option only if you are having problems with file uploads.
  420.  
  421. DLY=<number from 0 to 50>           (Default: DLY=0)
  422. FRAMEDELAY=<number from 0 to 50>
  423.  
  424.     BEAR BONE$ will pause this many ticks (1/18th second intervals) between
  425.     blocks, to make the transfer more reliable.
  426.  
  427. CLK=A,B,C                           (Default: NOT USED)
  428. XCLOCK=A,B,C
  429.  
  430.     Tells BEAR BONE$ to use the mainframes XCLOCK to determine when the
  431.     screen has been updated.  "A" is the ROW NUMBER, "B" is the COLUMN
  432.     NUMBER, and "C" is the character located at that position.
  433.  
  434.     Example:
  435.         CLK=25,9,X
  436.  
  437. TMO=A,B                             (Default: TMO=20,3)
  438. TIMEOUT=A,B
  439.  
  440.     Sets the time-out limit and number of retries.  If the communications
  441.     port remains inactive for "A" seconds, BEAR BONE$ will request a
  442.     screen refresh from the host.  The valid range for "A" is 5 seconds
  443.     to 150 seconds.  The "B" parameter specifies the maximum number of
  444.     times BEAR BONE$ will ask for a screen refresh for any given frame.
  445.     The valid range for "B" is 1 to 10.
  446.  
  447.     
  448. TERMINAL TYPES AND KEY DEFINITIONS
  449. ----------------------------------
  450.     
  451. TRM=VT100|ANSI|FTTERM|3101|TV950|HYDRA    (Default: TRM=VT100)
  452. TERMTYPE=VT100|ANSI|FTTERM|3101|TV950|HYDRA
  453.  
  454.     Tells BEAR BONE$ what type of terminal to emulate during the transfer.
  455.     The transfer will not work if this option is set incorrectly.  It should
  456.     match the terminal type that your communications software is emulating.
  457.  
  458.     TV950 should be used if you are using PROCOMM's 3270/950 emulation.
  459.     The key mappings are likely to be different, however, so please double
  460.     check them using PROCOMM's PCKEYMAP utility.
  461.  
  462.  
  463. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  464. NOTE:
  465.  
  466.     The following key definitions should coincide with the terminal type and
  467.     key mapping that your communications package uses.
  468.  
  469.     An <extended string> may be any combination of the following definitions:
  470.     
  471.         Normal displayable ASCII characters:
  472.             IND$FILE PTP
  473.  
  474.         ASCII DIGITS surrounded by parenthesis and separated with spaces:
  475.             (123 12 32 42)
  476.  
  477.         HEXADECIMAL DIGITS surrounded by less-than/greater-than symbols and
  478.         separated with spaces:
  479.             <0F 1B C4 12>
  480.             
  481.         ASCII CONTROL CHARACTERS may be defined by using the carat (^)
  482.         followed by an ASCII character in the range of 64-95 (DECIMAL) or
  483.         40-5F (HEXADECIMAL):
  484.             ^C^M
  485.  
  486.         Special cases are ^, (, and <.  They may be specified by using
  487.         ^^, ((, and << respectively.
  488.                 
  489.         The following examples are all equivalent:
  490.             ^[J1
  491.             <1B>J1
  492.             (27)J1
  493.             ^[<4A 32>
  494.             (27 74 49)
  495.  
  496. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  497.  
  498. ENT=<extended string>               (Default: ENT=^M)
  499. ENTER=<extended string>
  500.  
  501.     The key sequence your mainframe expects for the <Enter> key.
  502.  
  503. RHT=<extended string>               (Default: RHT=^[[C)
  504. RIGHT=<extended string>
  505.  
  506.     The key sequence your mainframe expects for the <Right Arrow> key.  This
  507.     key must be defined correctly for uploads to work.
  508.  
  509. RST=<extended string>               (Default: RST=^R)
  510. RESET=<extended string>
  511.  
  512.     The key sequence your mainframe expects for the <Reset> key.  BEAR BONE$
  513.     sends this key when the protocol converter has locked up and sent us the
  514.     bell character (hexadecimal 07).
  515.  
  516. TRY=<extended string>               (Default: TRY=^[r)
  517. RETRY=<extended string>
  518. REDISPLAY=<extended string>
  519.  
  520.     The key sequence for your protocol converter's "REDISPLAY SCREEN" function.
  521.     If your protocol converter does not have such a function, try using the
  522.     <PF1> key definition.
  523.  
  524. CAN=<extended string>               (Default: CAN=^[2^C^C)
  525. CANCEL=<extended string>
  526.  
  527.     BEAR BONE$ will send this sequence to cancel a file transfer.  Usually
  528.     this is defined as your <PF2> key followed by a couple of <Clear> keys.
  529.     
  530. PRE=<extended string>               (Default: NOT USED)
  531. PREAMBLE=<extended string>
  532.  
  533.     The preamble string.  BEAR BONE$ will send it to the protocol converter
  534.     before initiating a transfer.  Use this to set up XON/XOFF flow control,
  535.     or other protocol converter dependent options that the manufacturer
  536.     recommends.  Ask your systems operator for more information.
  537.  
  538.     If your protocol converter displays the status line on the 24th line
  539.     instead of the 25th line, you MUST disable it before starting a transfer.
  540.  
  541. PR2AMBLE=<extended string>            (Default: NOT USED)
  542.  
  543.     This is our "2nd" preamble.  Only use this if the mainframe    pauses and 
  544.     needs the enter key or something before    actually starting the transfer.
  545.  
  546. MID=<extended string>               (Default: NOT USED)
  547. MIDAMBLE=<extended string>
  548.  
  549.     The "midamble" string.  BEAR BONE$ will send this between batch transfers
  550.     to get the host back to a "Ready" state.
  551.  
  552. PST=<extended string>               (Default: NOT USED)
  553. POSTAMBLE=<extended string>
  554.  
  555.     The postamble string.  BEAR BONE$ will send it when the transfer is
  556.     complete to "undo" the preamble.
  557.  
  558.     
  559. PORT OPTIONS
  560. ------------
  561.  
  562. PRT=<number from 1 to 8>            (Default: PRT=1)
  563. PORT=<number from 1 to 8>
  564. COM=<number from 1 to 8>
  565.  
  566.     Specifies the communications port number on the PC.
  567.  
  568. ADR=<number>                        (Default: ADR=0)
  569. ADDRESS=<number>
  570.  
  571.     The address of the communications port in hexadecimal (i.e., 03F8).
  572.     If you specify 0 for the port address, BEAR BONE$ will use the port
  573.     defaults.
  574.     
  575. IRQ=<number from 0 to 15>           (Default: IRQ=0)
  576.  
  577.     Specifies the port's IRQ.  Use 0 to have BEAR BONE$ use port's default
  578.     IRQ.
  579.  
  580. PS2=YES|NO                            (Default: NO)
  581.     
  582.     'Yes' indicates you are using a genuine IBM PS/2. This will cause
  583.     Bear Bones to use default port addresses specific to the ps/2, unless
  584.     you specify the address using the ADDRESS parameter.
  585.     
  586. BDR=<number>                        (Default: NOT USED)
  587. BAUD=<number>
  588. SPEED=<number>
  589.  
  590.     Causes the port's baud rate to be set when opened.  By default,
  591.     BEAR BONE$ leaves the baud rate alone.  Valid options are 1200, 2400,
  592.     4800, 9600, 19200, 38400, 57600, 115000.  This option (and the BTS 
  593.     option) must be specified if you are using BEAR BONE$ in conjunction 
  594.     with a Windows product (such as PROCOMM for Windows).
  595.  
  596. BTS=ABC                             (Default: NOT USED)
  597. BITS=ABC
  598.  
  599.     Where "A" is the number of DATA BITS (7 or 8), "B" is the PARITY 
  600.     (N=None, O=Odd, E=Even, M=Mark, and S=Space), and "C" is the number of
  601.     STOP BITS (1 or 2).
  602.  
  603.     Example:
  604.         BTS=8N1
  605.             or
  606.         BTS=7E1
  607.  
  608. NET=INT14|NASI                      (Default: USE LOCAL COM PORT)
  609. NETWORK=INT14|NASI
  610.  
  611.     Tells BEAR BONE$ to use either INT14 or NASI/NCSI calls to route data
  612.     through your LAN's "modem pool".  You must also be using a "network"
  613.     communications package that supports one of these methods.
  614.  
  615.     If you specify NASI, BEAR BONE$ will use the first active virtual
  616.     circuit.  Because of this, you must have only one circuit open.
  617.  
  618.     
  619. MISCELLANEOUS OPTIONS
  620. ---------------------
  621.  
  622. DEL=<number from 20 to 200>         (Default: NOT USED)
  623. DELETE=<number from 20 to 200>
  624.  
  625.     Tells BEAR BONE$ to delete two characters every X number of bytes.
  626.     This is useful to strip carriage return/line feed pairs if your mainframe
  627.     IND$FILE puts them in when it shouldn't.
  628.     
  629. LOG=<filename>                      (Default: NOT USED)
  630. LOGFILE=<filename>
  631.  
  632.     Will cause BEAR BONE$ to append the results of the transfer to the
  633.     specified log file:
  634.  
  635.         SEN FAIL  04/12/93 08:19:49    0:03    1632 c:autoexec.bat
  636.         REC -OK-  04/12/93 08:23:42    0:09    6285 pcodes.doc
  637.                                  .
  638.                                  .
  639.                                  .
  640.  
  641. PAU=<number from 0 to 1000>           (Default: 3)
  642. PAUSE=<number from 0 to 1000>
  643.  
  644.     Forces BEAR BONE$ will pause this many seconds before exiting.
  645.     
  646. RET=A,B                             (Default: RET=0,1)
  647. RETURNCODES=A,B
  648.  
  649.     Sets the values that BEAR BONE$ will return on exit.  "A" is the
  650.     return code for a successful transfer, and "B" is the return code for
  651.     a failed transfer.
  652.     
  653. SOUND=YES|NO                        (Default: YES)
  654.  
  655.     'No' Turns off the beeping at the end of the transfer.
  656.  
  657.  
  658. TRC=<filename>                      (Default: NOT USED)
  659. TRACEFILE=<filename>
  660.  
  661.     Causes BEAR BONE$ to record all data that is sent or received on the
  662.     communications port.  Use this option only for debugging, as it creates
  663.     a VERY LARGE file.
  664.  
  665. VID=COLOR|B&W                       (Default: COLOR)
  666. VIDEO=COLOR|B&W
  667.  
  668.     Tells BEAR BONE$ to write to the screen either in full color, or black
  669.     and white.  This option could be useful on laptop machines or machines
  670.     with paper-white VGA monitors.
  671.  
  672. WAT=YES|NO                          (Default: NO)
  673. WATCH=YES|NO
  674.  
  675.     Lets you watch the emulation screen as the transfer takes place.
  676.  
  677.     
  678.     
  679. *-----------------------------------------------------------------------------*
  680.                                MAINFRAME OPTIONS
  681. *-----------------------------------------------------------------------------*
  682.  
  683. This section gives a brief listing of the mainframe IND$FILE options.  Please
  684. refer to your mainframe IND$FILE manual for detailed descriptions of the
  685. following options.
  686.  
  687.  
  688. CICS:
  689.  
  690.     SEND Options                RECEIVE Options
  691.     -------------------------------------------
  692.     ASCII|BINARY                APPEND
  693.     CRLF|NOCRLF                 ASCII|BINARY
  694.     P(xxx)                      CRLF|NOCRLF
  695.                                 P(xxx)
  696.  
  697.     ASCII CRLF is the default data type.
  698.  
  699.     Example:  BONE$ CICS.PRM PUT C:\AUTOEXEC.BAT JUNK (ASCII CRLF
  700.         
  701. IWS:
  702.  
  703.     SEND Options                RECEIVE Options
  704.     -------------------------------------------
  705.     ASCII|BINARY                ASCII|BINARY
  706.     BLANK                       BLANK
  707.     CRLF|NOCRLF                 CRLF|NOCRLF
  708.     NOREPLACE|REPLACE           REPLACE|APPEND
  709.     P(xxx)                      P(xxx)
  710.     FILE=HTF|FILE=TS            FILE=HTF|FILE=TS
  711.  
  712.     if FILE=HTF:                if FILE=HTF:
  713.         FOR=usid1...usid8           FROM=usid
  714.         PRIVATE|PUBLIC              DELETE|KEEP
  715.         TYPE=EDIT|TYPE=PRINT
  716.  
  717.     if FILE=TS:                 if FILE=TS:
  718.         QNAME=CFTRxxxx              QNAME=CFTRxxxx
  719.         PROGRAM=CFTRxxxx            PROGRAM=CFTRxxxx
  720.  
  721.     ASCII is the default data type.
  722.     BINARY is used for binary files.
  723.     Options available depends on the level of VSE/SP.
  724.  
  725.     Example:  BONE$ IWS.PRM PUT C:\COMMAND.COM JUNK (BINARY
  726.     
  727. MVS/TSO:
  728.  
  729.     SEND Options                RECEIVE Options
  730.     -------------------------------------------
  731.     APPEND                      APPEND
  732.     ASCII                       ASCII
  733.     CRLF                        CRLF
  734.     BLKSIZE(n)                  P(xxx)
  735.     LRECL(n)
  736.     P(xxx)
  737.     RECFM(F|V|U)
  738.     SPACE(n1,n2)AVBLOCK(n)
  739.     SPACE(n1,n2)CYLINDERS
  740.     SPACE(n1,n2)TRACKS
  741.  
  742.     BINARY is the default data type.
  743.     ASCII and CRLF are commonly used for text files.
  744.     ASCII and CRLF are the only valid options for members of a partitioned
  745.         data set.
  746.     80 characters is default length for a fixed length records.
  747.  
  748.     Example:  BONE$ TSO.PRM PUT C:\CONFIG.SYS 'JUNK.TEST.A' ASCII CRLF
  749.         (Note that a left-paren does not precede the option list.)
  750.     
  751. VM/SP:
  752.  
  753.     SEND Options                RECEIVE Options
  754.     -------------------------------------------
  755.     APPEND                      APPEND
  756.     ASCII                       ASCII
  757.     CRLF                        CRLF
  758.     LRECL                       P(xxx)
  759.     P(xxx)                      
  760.     RECFM V|F
  761.  
  762.     BINARY is the default data type.
  763.     ASCII and CRLF are commonly used for text files.
  764.  
  765.     Example:  BONE$ VM.PRM PUT D:\README.DOC JUNK TEST A (ASCII CRLF
  766.  
  767.  
  768.  
  769. *-----------------------------------------------------------------------------*
  770.                                  ERROR MESSAGES
  771. *-----------------------------------------------------------------------------*
  772.  
  773. Can't allocate memory for communications buffer.
  774. Can't allocate memory for screen buffer.
  775. Can't allocate memory for frame buffer.
  776.     These errors usually mean that you don't have enough low memory available.
  777.     Try unloading some TSR's.
  778.  
  779. Timeout limit reached while waiting for frame.
  780.     The mainframe failed to give us a valid format screen.  This error message
  781.     only pops up after BEAR BONE$ has tried to redisplay the screen several
  782.     times.  Double-check the codes for your TRY= key in the parameter file.
  783.     
  784. Transfer ABORTED by user.
  785.     The user has hit the ESCAPE key.
  786.  
  787. Invalid port number specified.
  788. No port found at specified address.
  789. No default port address available.
  790. No default IRQ defined for this port.
  791. Error opening communications port.
  792.     These errors usually mean that you are trying to access a port that isn't
  793.     there.  Double-check the PRT= parameter.  If the PRT= parameter looks
  794.     correct, try adding the ADR= and IRQ= parameters.  You can usually find
  795.     these values in your communication program's setup screens.
  796.  
  797. Can't set DTR on exit.
  798. Can't set remote XON/XOFF flow control.
  799. Can't set local XON/XOFF flow control.
  800. Can't set baud rate.
  801. Can't set parity.
  802. Can't set data bits.
  803. Can't set stop bits.
  804.     This sounds like your port or UART has some register-level problems.  Try
  805.     hooking up your modem to a different port.
  806.  
  807. NASI/NCSI not loaded.
  808.     The NASI/NCSI device driver was not found.  Make sure that NASI/NCSI
  809.     software is loaded.
  810.  
  811. NASI/NCSI virtual circuit not found.
  812.     The NASI/NCSI device driver was found, but no circuits are active.  It
  813.     sounds like you're not connected to the host.
  814.  
  815. Transfer ABORTED by user.
  816.  
  817. Error reading from send-file.
  818. Error writing to receive-file.
  819.     There was a problem with the disk.  Run CHKDSK on your drive or
  820.     another disk checker program like NORTON DISK DOCTOR.
  821.  
  822. Option SEN= cannot be empty.
  823. Option REC= cannot be empty.
  824. Option ENT= cannot be empty.
  825. Option RHT= cannot be empty.
  826.     These options cannot be defined as blank.  Check your parameter file for
  827.     the appropriate option.
  828.  
  829. Illegal baud rate specified.
  830.     The parameter file or command line contained an illegal baud rate 
  831.     specifier.  Valid baud rates are: 1200, 2400, 4800, 9600, 19200, 38400,
  832.     57600, AND 115000.  If you'd like, you only need to use the first two
  833.     digits.
  834.  
  835. The XCLOCK scan character may not be a SPACE.
  836.     Make sure there aren't any spaces in you CLK= parameter.  "CLK=24,9,X"
  837.     is valid, while "CLK=24, 9, X" is not.
  838.  
  839. Illegal XCLOCK position.
  840.     You had specified a screen position that is out of range.  The maximum
  841.     column number is 79, and the maximim row is 24 (origin at [0,0]).
  842.  
  843. Illegal CRLF strip position.
  844.     The DEL= parameter can take values in the range of 20 to 200 only.
  845.  
  846. Default parameter file (BONE$.PRM) not found.
  847.     BEAR BONE$ could not find any parameter file to open.
  848.  
  849. Usage: BONE$ <Param-file> PUT|GET <PC-file> <MF-file>
  850. Protocol converter appears to have hung.
  851.     The protocol converter has sent us many bell characters (0x07).  And
  852.     appears to be frozen.  BEAR BONE$ will try to reset the converter several
  853.     times before bombing out.
  854.  
  855. Unable to open BATCH file.
  856.     The specified batch file does not exist.
  857.  
  858. Received an unexpected screen type.  Transfer canceled.
  859.     The mainframe has become lost and sent us the wrong type of screen.
  860.  
  861. Can't open PC file for input.
  862.     The PC file does not exist.
  863.  
  864. Can't open PC file for output.
  865.     The PC filename is invalid or cannot be created.
  866.  
  867. Bad key definition "?????" on line ? of parm file.
  868.     There is a syntax problem with a key definition in the paramter file.
  869.  
  870. Bad key definition "?????" on command line.
  871.     There is a syntax problem with a key definition on the command line.  We
  872.     recommend that you put all your key definitions in your parameter file.
  873.  
  874. Can't find parameter file "?????"
  875.     The first option is the parameter file name. The one specified could not 
  876.     be opened. Maybe its in another directory, or the name was typed wrong. 
  877.     A 'PRM' extension is added if none is specified. BONE$.PRM is the default
  878.     parameter file.
  879.  
  880. Invalid option "?????", expected GET or PUT.
  881.     The second option must be GET, PUT, SEND or RECEIVE (may be abbreviated).
  882.     Something else was found here.
  883.  
  884. Batch file error: ?????
  885.     There was an error inside the batch file when we expected to find the
  886.     direction (GET, PUT, SEND, RECEIVE).