home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: DFÜ und Kommunikation / SOS-DFUE.ISO / programm / dos / protokol / bonez / bone$.doc < prev    next >
Encoding:
Text File  |  1993-10-05  |  24.5 KB  |  677 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.00b
  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, Q-MODEM, HYPERACCESS/5, etc..  It must support the use
  37. of external protocols OR have the ability to shell-out to DOS while on-line.
  38. 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.     UNICOM
  96.     TELIX
  97.     
  98. Please call 1-808-329-5426 if you have a protocol converter that is not on
  99. the list, or if you have any other compatibility questions.
  100.  
  101.  
  102.  
  103. *-----------------------------------------------------------------------------*
  104.                               WHAT'S ON THE DISK
  105. *-----------------------------------------------------------------------------*
  106.  
  107. ORDER   .FRM    BEAR BONE$ order form
  108. BONE$   .EXE    The BEAR BONE$ executable program
  109. BONE$   .PRM    Default parameter file
  110. BONE$   .DOC    This document
  111. BONE$   .WAS    Script file for PROCOMM Plus for Windows
  112. RECEIVE .BAT    Sample batch file for downloading
  113. SEND    .BAT    Sample batch file for uploading
  114. GENERIC .111    Sample parameter file for a generic protocol converter using
  115.                 VT100 emulation - Modify this parameter file to suit your
  116.                 protocol converter
  117. 3174-31 .111    3174 using 3101 emulation
  118. 3174-FT .111    3174 using FTTERM emulation
  119. 3174-TV .111    3174 using TV950 emulation
  120. 3174-VT .111    3174 using VT100 emulation
  121. 3270-950.111    Generic protocol converter using PROCOMM 3270/950 emulation -
  122.                 Modify this file to suit your protocol converter
  123. 3708-31 .111    3708 using 3101 emulation
  124. 3708-31 .1      3708 using 3101 emulation and IND$FILE version 1
  125. 3708-FT .111    3708 using FTTERM emulation
  126. 3708-FT .1      3708 using FTTERM emulation and IND$FILE version 1
  127. 3708-TV .111    3708 using TV950 emulation
  128. 3708-VT .111    3708 using VT100 emulation
  129. 7171-31 .111    7171 using 3101 emulation
  130. 7171-TV .111    7171 using TV950 emulation
  131. 7171-VT .111    7171 using VT100 emulation
  132. HYII-HY .111    HYDRA-II using HYDRA/PCCR emulation
  133.  
  134.  
  135.  
  136. *-----------------------------------------------------------------------------*
  137.                        DETERMINING THE IND$FILE VERSION
  138. *-----------------------------------------------------------------------------*
  139.  
  140. Before you attempt a transfer, it is important to find out what version of
  141. IND$FILE is running on the host.  Please follow the steps below:
  142.  
  143.     1)  Dial or connect to the host using your terminal emulation software.
  144.     
  145.     2)  Log on to your account.
  146.     
  147.     3)  Get to the "Ready" state by issuing a "Clear-Screen" command or
  148.         <Control-C>.
  149.         
  150.     4)  Type "IND$FILE PTP <MF File Name>", followed by <Enter>.
  151.         (Please see the MAINFRAME OPTIONS sections for examples of valid
  152.          mainframe file names.)
  153.              
  154.     5)  IF VERSION 1.1.1 IS RUNNING,
  155.  
  156.         the screen will clear and "Caaa" will appear in the upper left hand
  157.         corner.  Press the <PF2> or <Clear> key several times to cancel the
  158.         transfer.  In this case, you should specify the following options in
  159.         your parameter file (more on parameter files in the next section):
  160.         
  161.             SEN=IND$FILE PTP
  162.             REC=IND$FILE GTP
  163.  
  164.     6)  IF VERSION 1 IS RUNNING, EITHER
  165.  
  166.         ... the screen will clear and the cursor will move to the bottom right
  167.         hand corner of the screen.  You are running version 1 but DO NOT have
  168.         "non-display" fields available.  You will either need to modify your
  169.         protocol converter's TDF (terminal definition file) or get an upgrade
  170.         to version 1.1.1 of IND$FILE.
  171.  
  172.         ... OR the screen will clear and you will get a "TRANS16 Incorrect
  173.         request code: file transfer canceled$" or similar message.  You are
  174.         running version 1 of IND$FILE.  Use the following options in your
  175.         parameter file:
  176.         
  177.             SEN=IND$FILE PUT
  178.             REC=IND$FILE GET
  179.  
  180.  
  181.  
  182. *-----------------------------------------------------------------------------*
  183.                               INVOKING BEAR BONE$
  184. *-----------------------------------------------------------------------------*
  185.  
  186. Before invoking BEAR BONE$, be sure that you are in the "READY" state on the
  187. host.  This is normally done by hitting the <Clear> key or Control-C.  If
  188. you'd like, you can include the code for the <Clear> key in the PRE=
  189. parameter.
  190.  
  191. Now, call up BEAR BONE$ by invoking it as an external protocol (see one of
  192. the EXTERNAL PROTOCOL SETUP sections below), or if your communications
  193. package doesn't have this feature, shell out to DOS and type in your command
  194. line manually.
  195.  
  196. The format of a BEAR BONE$ command line looks like the following:
  197.  
  198.     BONE$ <Param-file> PUT|GET <PC-file> <MF-file> <MF-options>
  199.  
  200. <Param-file> is the name of a file containing multiple lines of BEAR BONE$
  201. options (see BEAR BONE$ OPTIONS below).  Any line that does not have an
  202. EQUAL in the fourth position is considered to be a comment line and is
  203. discarded.  Here is a sample parameter file:
  204.  
  205.     ******************************************************************
  206.     ***  VM IND$FILE 1.1.1 using FTTERM emulation on a 3174 w/AEA  ***
  207.     ******************************************************************
  208.     
  209.     SEND AND RECEIVE COMMANDS
  210.     -------------------------
  211.     sen=ind$file ptp
  212.     rec=ind$file gtp
  213.     
  214.     ERR-CHECK METHOD, TYPE-AHEAD BUFFER LENGTH, ETC..
  215.     -------------------------------------------------
  216.     err=auto
  217.     buf=2000
  218.     blk=700
  219.     dly=0
  220.     
  221.     TERMINAL TYPE AND KEY SEQUENCES
  222.     -------------------------------
  223.     trm=ftterm               
  224.     ent=^m                   
  225.     rht=^[c                  
  226.     rst=^r                   
  227.     try=^[r                  
  228.     can=^[2^m
  229.     pre=^[>^[o
  230.     pst=^[<<^[p^c
  231.     
  232.     COMMUNICATION PORT OPTIONS
  233.     --------------------------
  234.     prt=1
  235.     adr=0
  236.     irq=0
  237.  
  238. Unless a path is specified for the parameter file, BEAR BONE$ will first try
  239. and open a parameter file from the same path where the BEAR BONE$ executable
  240. is located.  If it can't find it, BEAR BONE$ will try and open it from your
  241. current path.  This means that you are able to conveniently place all your
  242. parameter files in one directory.  We suggest that you put BEAR BONE$ and
  243. its associated parameter files in the same directory as your communications
  244. software.
  245.  
  246. You may omit the <Param-file> if you have a file named BONE$.PRM in either
  247. your current directory, or in the same directory as your BONE$.EXE.
  248.  
  249. Next on the command line, you need to specify either a PUT to send a file to
  250. the host, or a GET to download a file from the host.  You may abbreviate these
  251. to P and G.  Also, SEND and RECEIVE are valid and will perform the same
  252. functions as PUT and GET.
  253.  
  254. <PC-file> is the name of the file on the PC.  If you are doing a PUT, data is
  255. read from this file and transmitted to the host.  If you are doing a GET,
  256. this file is created and host data is written to it.
  257.  
  258. <MF-file> is a proper file name, or data set name on your mainframe.
  259.  
  260. <MF-options> are file format and translation options that are available
  261. on your mainframe IND$FILE program (see MAINFRAME OPTIONS below).
  262.  
  263.  
  264.  
  265. *-----------------------------------------------------------------------------*
  266.                                 BATCH TRANSFERS
  267. *-----------------------------------------------------------------------------*
  268.  
  269. If you would like to do batch transfers, you may use a command line like
  270. this:
  271.  
  272.     BONE$ <Param-file> @<List-file>
  273.  
  274. Each line of the <List-file> should contain one transaction.  Here's an
  275. example:
  276.  
  277.     PUT C:\AUTOEXEC JUNK TEST A
  278.     GET JUNK. JUNK TEST A
  279.     PUT D:DATA.FIL JUNK DATA A
  280.  
  281.     
  282.         
  283. *-----------------------------------------------------------------------------*
  284.                 EXTERNAL PROTOCOL SETUP FOR PROCOMM-PLUS v2.01
  285. *-----------------------------------------------------------------------------*
  286.  
  287. From PROCOMM's terminal mode, hit ALT-S to bring up the setup menu, then select
  288. PROTOCOL OPTIONS.  Next, select EXTERNAL PROTOCOL OPTIONS.  Here is a sample
  289. setup for BEAR BONE$ using a parameter file named VM:
  290.  
  291.     EXTERNAL PROTOCOL 1
  292.     A- Name ................  BONE$
  293.     B- Type ................  PROGRAM
  294.     C- Upload command ......  BONE$ VM PUT
  295.     H- Download command ....  BONE$ VM GET
  296.  
  297.  
  298.  
  299. *-----------------------------------------------------------------------------*
  300.                    EXTERNAL PROTOCOL SETUP FOR QMODEM v4.31
  301. *-----------------------------------------------------------------------------*
  302.  
  303. Type ALT-N from QMODEM's terminal mode.  Next, select the PROTOCOLS pull-down
  304. menu.  Here is a sample setup:
  305.  
  306.     Select Character    $
  307.     Protocol            BONE$
  308.     Upload BAT          BONE$ VM PUT
  309.     Download BAT        BONE$ VM GET
  310.     Filename Prompt     Y
  311.  
  312.  
  313.  
  314. *-----------------------------------------------------------------------------*
  315.                               BEAR BONE$ OPTIONS
  316. *-----------------------------------------------------------------------------*
  317.  
  318.  
  319. MAINFRAME STRINGS
  320. -----------------
  321.  
  322. SEN=<string>                        (Default: SEN=IND$FILE PTP)
  323.  
  324.     This is the string that BEAR BONE$ will send to the mainframe to invoke
  325.     an upload.  You would normally use IND$FILE PTP if your mainframe is
  326.     running version 1.1.1 of IND$FILE, or IND$FILE PUT if your mainframe
  327.     is running version 1 of IND$FILE.
  328.  
  329. REC=<string>                        (Default: REC=IND$FILE GTP)
  330.  
  331.     BEAR BONE$ will send this string to the mainframe to initiate a download.
  332.     You should use either IND$FILE GTP (v1.1.1) or IND$FILE GET (v1).
  333.  
  334. OPT=<string>                        (Default: NOT USED)
  335.  
  336.     Default mainframe options used if none specified on the command line.
  337.  
  338.     Example:
  339.         OPT=(ASCII CRLF
  340.  
  341.         
  342. RELIABILITY OPTIONS
  343. -------------------
  344.     
  345. ERR=AUTO|CHECKSUM|CRC               (Default: ERR=AUTO)
  346.  
  347.     This option is only available for uploads.
  348.  
  349.     ERR=AUTO will cause BEAR BONE$ to determine the type of error checking
  350.     that is performed on the mainframe.  This is a typically used option,
  351.     but is not recommended for use with the CICS IND$FILE.
  352.         
  353.     ERR=CHECKSUM forces BEAR BONE$ to use a one byte checksum error detection.
  354.     Use this option only if your mainframe is running version 1 of IND$FILE,
  355.     or running a CICS version.
  356.  
  357.     ERR=CRC tells BEAR BONE$ to use an advanced 6 byte CRC (Cyclical
  358.     Redundancy Check).  Version 1.1.1 supports this feature.
  359.  
  360. BUF=<number from 20 to 2000>        (Default: BUF=50)
  361.  
  362.     Specifies the size of your protocol converter's type-ahead buffer.  When
  363.     sending a file, BEAR BONE$ will never be more than <number> characters
  364.     ahead of echoed back characters.  Generally, the lower the number, the
  365.     slower the transfer will be.  On the other hand, if BUF is set too high,
  366.     your protocol converter may disconnect, or lock up on you during your
  367.     transfer.  Experiment to get the best results.
  368.  
  369. BLK=<number from 200 to 1914>       (Default: BLK=1914)
  370.  
  371.     Sets the block size of the data for uploads only. As with the BUF
  372.     parameter, a small block size will slow the transfer.  Use this 
  373.     option only if you are having problems with file uploads.
  374.  
  375. DLY=<number from 0 to 50>           (Default: DLY=0)
  376.  
  377.     BEAR BONE$ will pause this many ticks (1/18th second intervals) between
  378.     blocks, to make the transfer more reliable.
  379.  
  380. CLK=A,B,C                           (Default: NOT USED)
  381.  
  382.     Tells BEAR BONE$ to use the mainframes XCLOCK to determine when the
  383.     screen has been updated.  "A" is the ROW NUMBER, "B" is the COLUMN
  384.     NUMBER, and "C" is the character located at that position.
  385.  
  386.     Example:
  387.         CLK=25,9,X
  388.  
  389. TMO=A,B                             (Default: TMO=20,3)
  390.  
  391.     Sets the time-out limit and number of retries.  If the communications
  392.     port remains inactive for "A" seconds, BEAR BONE$ will request a
  393.     screen refresh from the host.  The valid range for "A" is 5 seconds
  394.     to 150 seconds.  The "B" parameter specifies the maximum number of
  395.     times BEAR BONE$ will ask for a screen refresh for any given frame.
  396.     The valid range for "B" is 1 to 10.
  397.  
  398.     
  399. TERMINAL TYPES AND KEY DEFINITIONS
  400. ----------------------------------
  401.     
  402. TRM=VT100|ANSI|FTTERM|3101|TV950|HYDRA    (Default: TRM=VT100)
  403.  
  404.     Tells BEAR BONE$ what type of terminal to emulate during the transfer.
  405.     The transfer will not work if this option is set incorrectly.  It should
  406.     match the terminal type that your communications software is emulating.
  407.  
  408.     TV950 should be used if you are using PROCOMM's 3270/950 emulation.
  409.     The key mappings are likely to be different, however, so please double
  410.     check them using PROCOMM's PCKEYMAP utility.
  411.  
  412.  
  413. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  414. NOTE:
  415.  
  416.     The following key definitions should coincide with the terminal type and
  417.     key mapping that your communications package uses.
  418.  
  419.     An <extended string> may be any combination of the following definitions:
  420.     
  421.         Normal displayable ASCII characters:
  422.             IND$FILE PTP
  423.  
  424.         ASCII DIGITS surrounded by parenthesis and separated with spaces:
  425.             (123 12 32 42)
  426.  
  427.         HEXADECIMAL DIGITS surrounded by less-than/greater-than symbols and
  428.         separated with spaces:
  429.             <0F 1B C4 12>
  430.             
  431.         ASCII CONTROL CHARACTERS may be defined by using the carat (^)
  432.         followed by an ASCII character in the range of 64-95 (DECIMAL) or
  433.         40-5F (HEXADECIMAL):
  434.             ^C^M
  435.  
  436.         Special cases are ^, (, and <.  They may be specified by using
  437.         ^^, ((, and << respectively.
  438.                 
  439.         The following examples are all equivalent:
  440.             ^[J1
  441.             <1B>J1
  442.             (27)J1
  443.             ^[<4A 32>
  444.             (27 74 49)
  445.  
  446. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  447.  
  448. ENT=<extended string>               (Default: ENT=^M)
  449.  
  450.     The key sequence your mainframe expects for the <Enter> key.
  451.  
  452. RHT=<extended string>               (Default: RHT=^[[C)
  453.  
  454.     The key sequence your mainframe expects for the <Right Arrow> key.  This
  455.     key must be defined correctly for uploads to work.
  456.  
  457. RST=<extended string>               (Default: RST=^R)
  458.  
  459.     The key sequence your mainframe expects for the <Reset> key.  BEAR BONE$
  460.     sends this key when the protocol converter has locked up and sent us the
  461.     bell character (hexadecimal 07).
  462.  
  463. TRY=<extended string>               (Default: TRY=^[r)
  464.  
  465.     The key sequence for your protocol converter's "REDISPLAY SCREEN" function.
  466.     If your protocol converter does not have such a function, try using the
  467.     <PF1> key definition.
  468.  
  469. CAN=<extended string>               (Default: CAN=^[2^C^C)
  470.  
  471.     BEAR BONE$ will send this sequence to cancel a file transfer.  Usually
  472.     this is defined as your <PF2> key followed by a couple of <Clear> keys.
  473.     
  474. PRE=<extended string>               (Default: NOT USED)
  475.  
  476.     The preamble string.  BEAR BONE$ will send it to the protocol converter
  477.     before initiating a transfer.  Use this to set up XON/XOFF flow control,
  478.     or other protocol converter dependent options that the manufacturer
  479.     recommends.  Ask your systems operator or call CVI for more information.
  480.  
  481.     If your protocol converter displays the status line on the 24th line
  482.     instead of the 25th line, you MUST disable it before starting a transfer.
  483.  
  484. MID=<extended string>               (Default: NOT USED)
  485.  
  486.     The "midamble" string.  BEAR BONE$ will send this between batch transfers
  487.     to get the host back to a "Ready" state.
  488.  
  489. PST=<extended string>               (Default: NOT USED)
  490.  
  491.     The postamble string.  BEAR BONE$ will send it when the transfer is
  492.     complete to "undo" the preamble.
  493.  
  494.     
  495. PORT OPTIONS
  496. ------------
  497.  
  498. PRT=<number from 1 to 8>            (Default: PRT=1)
  499.  
  500.     Specifies the communications port number on the PC.
  501.  
  502. ADR=<number>                        (Default: ADR=0)
  503.  
  504.     The address of the communications port in hexadecimal (i.e., 03F8).
  505.     If you specify 0 for the port address, BEAR BONE$ will use the port
  506.     defaults.
  507.     
  508. IRQ=<number from 0 to 15>           (Default: IRQ=0)
  509.  
  510.     Specifies the port's IRQ.  Use 0 to have BEAR BONE$ use port's default
  511.     IRQ.
  512.  
  513. BDR=<number>                        (Default: NOT USED)
  514.  
  515.     Causes the port's baud rate to be set when opened.  By default,
  516.     BEAR BONE$ leaves the baud rate alone.  Valid options are 1200, 2400,
  517.     4800, 9600, and 19200.   This option (and the BTS option) must be
  518.     specified if you are using BEAR BONE$ in conjunction with a Windows
  519.     product (such as PROCOMM for Windows).
  520.  
  521. BTS=ABC                             (Default: NOT USED)
  522.  
  523.     Where "A" is the number of DATA BITS (7 or 8), "B" is the PARITY 
  524.     (N=None, O=Odd, E=Even, M=Mark, and S=Space), and "C" is the number of
  525.     STOP BITS (1 or 2).
  526.  
  527.     Example:
  528.         BTS=8N1
  529.             or
  530.         BTS=7E1
  531.  
  532. NET=INT14|NASI                      (Default: USE LOCAL COM PORT)
  533.  
  534.     Tells BEAR BONE$ to use either INT14 or NASI/NCSI calls to route data
  535.     through your LAN's "modem pool".  You must also be using a "network"
  536.     communications package that supports one of these methods.
  537.  
  538.     If you specify NASI, BEAR BONE$ will use the first active virtual
  539.     circuit.  Because of this, you must have only one circuit open.
  540.  
  541.     
  542. MISCELLANEOUS OPTIONS
  543. ---------------------
  544.  
  545. DEL=<number from 20 to 200>         (Default: NOT USED)
  546.  
  547.     Tells BEAR BONE$ to delete two characters every X number of bytes.
  548.     This is useful to strip carriage return/line feed pairs if you mainframe
  549.     IND$FILE puts them in when it shouldn't.
  550.     
  551. LOG=<filename>                      (Default: NOT USED)
  552.  
  553.     Will cause BEAR BONE$ to append the results of the transfer to the
  554.     specified log file:
  555.  
  556.         SEN FAIL  04/12/93 08:19:49    0:03    1632 c:autoexec.bat
  557.         REC -OK-  04/12/93 08:23:42    0:09    6285 pcodes.doc
  558.                                  .
  559.                                  .
  560.                                  .
  561.  
  562. PAU=<number from 0 to 99>           (Defualt: 3)
  563.  
  564.     Forces BEAR BONE$ will pause this many seconds before exiting.
  565.     
  566. RET=A,B                             (Default: RET=0,1)
  567.  
  568.     Sets the values that BEAR BONE$ will return on exit.  "A" is the
  569.     return code for a successful transfer, and "B" is the return code for
  570.     a failed transfer.
  571.     
  572. TRC=<filename>                      (Default: NOT USED)
  573.  
  574.     Causes BEAR BONE$ to record all data that is sent or received on the
  575.     communications port.  Use this option only for debugging, as it creates
  576.     a VERY LARGE file.
  577.  
  578. VID=COLOR|B&W                       (Default: COLOR)
  579.  
  580.     Tells BEAR BONE$ to write to the screen either in full color, or black
  581.     and white.  This option could be useful on laptop machines or machines
  582.     with paper-white VGA monitors.
  583.  
  584. WAT=YES|NO                          (Default: NO)
  585.  
  586.     Lets you watch the emulation screen as the transfer takes place.
  587.  
  588.     
  589.     
  590. *-----------------------------------------------------------------------------*
  591.                                MAINFRAME OPTIONS
  592. *-----------------------------------------------------------------------------*
  593.  
  594. This section gives a brief listing of the mainframe IND$FILE options.  Please
  595. refer to your mainframe IND$FILE manual for detailed descriptions of the
  596. following options.
  597.  
  598.  
  599. CICS:
  600.  
  601.     SEND Options                RECEIVE Options
  602.     -------------------------------------------
  603.     ASCII|BINARY                APPEND
  604.     CRLF|NOCRLF                 ASCII|BINARY
  605.     P(xxx)                      CRLF|NOCRLF
  606.                                 P(xxx)
  607.  
  608.     ASCII CRLF is the default data type.
  609.  
  610.     Example:  BONE$ CICS.PRM PUT C:\AUTOEXEC.BAT JUNK (ASCII CRLF
  611.         
  612. IWS:
  613.  
  614.     SEND Options                RECEIVE Options
  615.     -------------------------------------------
  616.     ASCII|BINARY                ASCII|BINARY
  617.     BLANK                       BLANK
  618.     CRLF|NOCRLF                 CRLF|NOCRLF
  619.     NOREPLACE|REPLACE           REPLACE|APPEND
  620.     P(xxx)                      P(xxx)
  621.     FILE=HTF|FILE=TS            FILE=HTF|FILE=TS
  622.  
  623.     if FILE=HTF:                if FILE=HTF:
  624.         FOR=usid1...usid8           FROM=usid
  625.         PRIVATE|PUBLIC              DELETE|KEEP
  626.         TYPE=EDIT|TYPE=PRINT
  627.  
  628.     if FILE=TS:                 if FILE=TS:
  629.         QNAME=CFTRxxxx              QNAME=CFTRxxxx
  630.         PROGRAM=CFTRxxxx            PROGRAM=CFTRxxxx
  631.  
  632.     ASCII is the default data type.
  633.     BINARY is used for binary files.
  634.     Options available depends on the level of VSE/SP.
  635.  
  636.     Example:  BONE$ IWS.PRM PUT C:\COMMAND.COM JUNK (BINARY
  637.     
  638. MVS/TSO:
  639.  
  640.     SEND Options                RECEIVE Options
  641.     -------------------------------------------
  642.     APPEND                      APPEND
  643.     ASCII                       ASCII
  644.     CRLF                        CRLF
  645.     BLKSIZE(n)                  P(xxx)
  646.     LRECL(n)
  647.     P(xxx)
  648.     RECFM(F|V|U)
  649.     SPACE(n1,n2)AVBLOCK(n)
  650.     SPACE(n1,n2)CYLINDERS
  651.     SPACE(n1,n2)TRACKS
  652.  
  653.     BINARY is the default data type.
  654.     ASCII and CRLF are commonly used for text files.
  655.     ASCII and CRLF are the only valid options for members of a partitioned
  656.         data set.
  657.     80 characters is default length for a fixed length records.
  658.  
  659.     Example:  BONE$ TSO.PRM PUT C:\CONFIG.SYS 'JUNK.TEST.A' ASCII CRLF
  660.         (Note that a left-paren does not precede the option list.)
  661.     
  662. VM/SP:
  663.  
  664.     SEND Options                RECEIVE Options
  665.     -------------------------------------------
  666.     APPEND                      APPEND
  667.     ASCII                       ASCII
  668.     CRLF                        CRLF
  669.     LRECL                       P(xxx)
  670.     P(xxx)                      
  671.     RECFM V|F
  672.  
  673.     BINARY is the default data type.
  674.     ASCII and CRLF are commonly used for text files.
  675.  
  676.     Example:  BONE$ VM.PRM PUT D:\README.DOC JUNK TEST A (ASCII CRLF
  677.