home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / honeywellcp6a / hc6ker.fcc < prev    next >
Text File  |  2020-01-01  |  46KB  |  910 lines
  1. 1
  2.  
  3.       CP-6 Kermit           Version: 1.00           January 1988           Page 1
  4.  
  5.       13.0  CP-6 Kermit
  6.  
  7.       Program:  Lee Hallin (Honeywell Bull, Los Angeles Development Center) with
  8.                 testing and suggestions from J. T. Anderson (Honeywell Bull, Los
  9.                 Angeles Developement Center), and Mike Iglesias and others
  10.                 (University California at Irvine).
  11.  
  12.                 Many thanks to John Stewart of Carleton University, Tom
  13.                 Erskine of CRC, Mike Iglesias of UC Irvine and Mike Schmidt
  14.                 of Honeywell Bull, Canada, for their help and supplied code
  15.                 for version 1.00.
  16.       Language: PL-6
  17.       Version:  1.00
  18.       Date:     January, 1988
  19.  
  20.       Please send any questions, bugs and/or suggestions to any of the following:
  21.  
  22.       U.S. Mail:
  23.         Honeywell Bull
  24.         5250 West Century Blvd
  25.         Los Angeles, CA  90045
  26.         Attn: Lee Hallin
  27.  
  28.       CP-6 Mail on the LADC support machine (aka L66A):
  29.         Lee Hallin
  30.  
  31.       ARPANET Address:
  32.         Lee-Hallin%LADC@BCO-MULTICS.ARPA
  33.  
  34.       13.1  Introduction
  35.  
  36.       This version of Kermit is written in PL-6; a PL/1-like implementation language
  37.       available on the Honeywell CP-6 operating system.  This Kermit contains all of
  38.       the "basic" Kermit features and several optional/advanced features.  Some of
  39.       the optional features are suggested in the Kermit User's Guide and/or Kermit
  40.       Protocol Manual, while others where implemented to provide added flexibility
  41.       on CP-6.  The following table briefly summarizes the capabilities of this
  42.       version of Kermit.
  43.  
  44.       Features this Kermit has or can do:
  45.         Transfers text files
  46.         Transfers binary files
  47.         Sends file groups (wildcarding)
  48.         File overwrite protection
  49.         Timeouts
  50.         8th-bit prefixing
  51.         Repeat count prefixing
  52.         Transaction logging
  53.         Debugging facility
  54.         Acts as a server
  55.         Talks to a server (limited)
  56.         Automatically reads default commands from a file
  57.         Reads commands from a file
  58.         Help for each of the commands
  59.         Graceful handling of interrupted group transfers
  60.  
  61.       Features not included in this version:
  62.         Advanced server commands
  63.         Extended block checks (2 and 3 byte checks)
  64.         Handling file attributes
  65. 1
  66.  
  67.  
  68.       CP-6 Kermit           Version: 1.00           January 1988           Page 2
  69.  
  70.       13.2  Invocation syntax
  71.  
  72.       The invocation syntax for CP-6 KERMIT is as follows:
  73.         !KERMIT [cmd-file] [,default-file] [{ON|TO|OVER|INTO} ,dest] [( options [)]]
  74.  
  75.       The invocation parameters have the following meaning:
  76.  
  77.         cmd-file -
  78.           is a CP-6 file containing KERMIT commands.  See Section 13.4 below for a
  79.           list of legal KERMIT commands.
  80.         default-file -
  81.           is a file containing KERMIT commands that will be read automatically
  82.           before most other commands are executed.  This file is read through the
  83.           F$DEFAULTS DCB and if the file name is not specified, it defaults to
  84.           :KERMIT_INI.
  85.         dest -
  86.           is where KERMIT will output messages that would go to the screen by
  87.           default.  These messages are written through the M$LO DCB.
  88.         options -
  89.           one or more of the options/commands, separated by semicolons, listed in
  90.           this help file.  Note that if any commands (other than DONT GREET, DONT
  91.           PROMPT, NO DEFAULTS and SILENT MODE) are specified on the invocation line,
  92.           when the last such command is completed, KERMIT will exit rather than
  93.           prompt for more commands.
  94.  
  95.  
  96.       13.3  Commands only legal on invocation line
  97.  
  98.       The following commands are intended for use on the CP-6 KERMIT invocation
  99.       line.  Although most of them may be issued after you are already in CP-6
  100.       KERMIT, there is little reason to do so because by then it's too late for them
  101.       to be effective (e.g., specifying NO GREETING after you are already in KERMIT
  102.       makes little sense and will have no effect).
  103.  
  104.       { D[ONT] | N[O] } G[REETING]
  105.               Causes the greeting (KERMIT 1.00 Here (01/25/87)) to be suppressed.
  106.  
  107.       { D[ONT] | N[O] } P[ROMPT]
  108.               Causes the prompt string to be suppressed.
  109.  
  110.       N[O] D[EFAULTS]
  111.               By default, when KERMIT is invoked it looks for a file called
  112.               :KERMIT_INI in the current directory.  If it is NOT found, then the
  113.               logon account is searched (if it is not the current account).  If the
  114.               file is found in either account, it is read and any KERMIT commands in
  115.               it are executed.  This NO DEFAULTS option suppresses this behavior if
  116.               it is specified on the command line.  Furthermore, if it is the only
  117.               option on the command line, KERMIT will prompt the user for additional
  118.               commands.  Otherwise, all the commands/options on the command line are
  119.               executed and then KERMIT exits.
  120.  
  121.       SILE[NT] [M[ODE]]
  122.               Causes KERMIT to NOT write anything through the M$LO DCB (DCB4).  This
  123.               may not be completely successful in some situations.
  124. 1
  125.  
  126.  
  127.       CP-6 Kermit           Version: 1.00           January 1988           Page 3
  128.  
  129.       13.4  Normal CP-6 KERMIT Commands
  130.  
  131.       !command
  132.               Any command which may be entered from IBEX may be entered while in
  133.               KERMIT by preceding the IBEX command with a !  (the IBEX prompt
  134.               character).  For all of these commands, with the exception of !XEQ,
  135.               the user is returned to KERMIT after the command is executed.
  136.  
  137.               Note: This feature will NOT work on pre-C00 versions of CP-6.
  138.  
  139.       ?
  140.               Requests that the next level of HELP be displayed.  This should only
  141.               be issued after a HELP or ? command.  See the HELP command below for
  142.               more information.
  143.  
  144.       ??
  145.               Requests all remaining HELP on the most recently specified topic.
  146.               This should only be issued after a HELP or ? command.  See the HELP
  147.               command below for more information.
  148.  
  149.       BYE
  150.               Tells "the other" KERMIT (which should be running in SERVER mode) to
  151.               exit and terminate the session.
  152.  
  153.       CG = comgroup_name
  154.               Specifies the name of the ComGroup to be used for file transfers.
  155.               This option is only meaningful when specified in conjunction with the
  156.               STATION option.  If either the CG or STATION options are specified
  157.               without the other option then the option that was specified will
  158.               be IGNORED.
  159.  
  160.       C[OPY] sourcelist [{ON|TO|OVER|INTO} destination] [FROM fid]
  161.               Causes CP-6 KERMIT to M$LINK to PCL, passing the entire COPY command
  162.               to PCL.  Since PCL, not KERMIT, is really doing the COPY, the command
  163.               specified may have any of the options that the PCL COPY command
  164.               accepts.
  165.  
  166.       DATE
  167.               Displays the current date and time in the format:
  168.                mmm dd 'yy hh:mm    (month) (day) (year) (hour) (minute)
  169.  
  170.       DEB[UG] [[{ON|TO|OVER|INTO}] debug-file] [( option, [,option...] )]
  171.               Specifies what information will be written to the debug file.
  172.  
  173.               The debug parameters have the following meaning:
  174.  
  175.               debug-file
  176.                   is a CP-6 file where the requested (via options) debug information
  177.                   will be written.  If 'debug-file' is not specified on a command,
  178.                   any previously specified 'debug-file' name will be used.  If this
  179.                   is the first DEBUG command issued, the file name '*DEBUG' will be
  180.                   used by default.
  181.               option
  182.                   is one of the following:
  183. 1
  184.  
  185.  
  186.       CP-6 Kermit           Version: 1.00           January 1988           Page 4
  187.  
  188.       13.4  Normal CP-6 KERMIT Commands (DEBUG continued)
  189.  
  190.               A[LL] -
  191.                   writes ALL available debug information
  192.               C[OMMAND] -
  193.                   writes a copy of the command issued by the user.  This is handy
  194.                   when you are DEBUGging INTO the same file (as might be done when
  195.                   the DEBUG command is in the :KERMIT_INI file) and you want/need to
  196.                   know at what point in the DEBUG file each CP-6 KERMIT session
  197.                   began.
  198.  
  199.               E[RROR] -
  200.                   writes unexpected monitor errors
  201.               I[NFORMATION] -
  202.                   writes "miscellaneous" information.  Currently, this just means
  203.                   include a copy of the CP-6 KERMIT invocation line (B$JIT.CCBUF) in
  204.                   the debug file.
  205.               M[ICRO] -
  206.                   writes a debug record for each packet sent and received, timeout
  207.                   value change and unexpected monitor errors.  This is a shorthand
  208.                   method of specifying the ERROR, RECEIVE, SEND and TIMEOUT options.
  209.               OF[F] -
  210.                   Causes CP-6 KERMIT to CLOSE the debug file and cease writing debug
  211.                   information to it.  A subsequent DEBUG command without a
  212.                   'debug-file' specified will cause the previous debug file to be
  213.                   extended.
  214.               ON -
  215.                   Causes CP-6 KERMIT to start/continue writing debug information to
  216.                   the debug file.
  217.               REA[D] -
  218.                   writes a debug record for each record READ from a CP-6 file being
  219.                   transferred to "the other" computer.
  220.               REC[EIVE] -
  221.                   writes a debug record for each packet received from "the other"
  222.                   computer.
  223.               S[END] -
  224.                   writes a debug record containing packets that CP-6 KERMIT sends to
  225.                   "the other" computer.
  226.               T[IMEOUT] -
  227.                   writes a debug record indicating that either a read timeout value
  228.                   was changed or that a timeout occurred; the text of the record
  229.                   indicates which occurred.
  230.               W[RITE] -
  231.                   writes records as they were written to a CP-6 file; as a result of
  232.                   a RECEIVE command on CP-6 or a SEND command on "the other"
  233.                   computer when CP-6 KERMIT was running as a SERVER.
  234.  
  235.               The default is to NOT DEBUG.  However, if a DEBUG command is specified
  236.               with no parameters, the default is DEBUG INTO *DEBUG(MICRO).
  237.  
  238.               Each record written to the debug file is preceded by a 15 byte header.
  239.               The first four bytes indicate what type of record it is and have the
  240.               following meanings:
  241. 1
  242.  
  243.  
  244.       CP-6 Kermit           Version: 1.00           January 1988           Page 5
  245.  
  246.       13.4  Normal CP-6 KERMIT Commands (DEBUG continued)
  247.  
  248.               'Cmnd' - the record contains a KERMIT command as issued by the user.
  249.               'Info' - the record contains miscellaneous information.  With this
  250.                        version of CP-6 KERMIT, the record will contain a copy of the
  251.                        KERMIT invocation line.
  252.               'Read' - the record was one READ from a CP-6 file and was eventually
  253.                        SENT (hopefully) to the "other" computer.
  254.               'Rcvd' - the record was RECEIVEd from the "other" computer.
  255.               'Sent' - the record was SENT to the "other" computer.
  256.               'Timo' - either a read timed out or a timeout value was changed.  The
  257.                        remaining portion of the record (past the header) contains a
  258.                        message indicating what happened.
  259.               'Writ' - the record was written as a logical record to the file that
  260.                        was RECEIVEd from the "other" computer.
  261.  
  262.               The remaining 11 bytes of header is a time stamp which is provided to
  263.               aid the user in finding "timing holes" which may exist between the
  264.               personal computer and CP-6 versions of KERMIT.
  265.  
  266.  
  267.       [LOCAL] DEL[ETE] sourcelist [FROM fid]
  268.               Causes CP-6 KERMIT to M$LINK to PCL, passing the entire DELETE command
  269.               (minus the LOCAL if it was specified) to PCL.  Since PCL, not CP-6
  270.               KERMIT, is really doing the DELETE, the command specified may have any
  271.               of the options that the PCL DELETE command accepts.
  272.  
  273.       { DIRECTORY | DIR } [[DP#packset].account | R[ESET]]
  274.               Changes the default account and optionally, the default packset.  The
  275.               default account and packset are the account and associated packset
  276.               that are selected if an account is not supplied as part of a disk fid.
  277.               Initially, the default account is the logon or running account and the
  278.               packset name is nil.  When used without parameters, the DIRECTORY
  279.               command displays the current directory.
  280.  
  281.       DO command-to-be-passed-to-IBEX
  282.               Any command which may be entered from IBEX may be entered while in
  283.               CP-6 KERMIT by preceding the IBEX command with 'DO '.  For all of
  284.               these commands, with the exception of DO XEQ, the user is returned to
  285.               CP-6 KERMIT after the command is executed.
  286.  
  287.               Note: This feature will NOT work on pre-C00 versions of CP-6.
  288.  
  289.       { E[ND] | EX[IT] | X[IT] | Q[UIT] }
  290.               Exits CP-6 KERMIT after closing and saving any currently OPEN files.
  291.  
  292.       ERASE [ALL | ldevlist]
  293.               ERASE deletes the accumulated output for ALL or for the specified
  294.               logical devices defined for the session or job.  If no parameters are
  295.               specified, ALL is assumed.
  296.  
  297.       FIN[ISH]
  298.               Tells the "other" KERMIT (which is assumed to be running in SERVER
  299.               mode) to exit.  Unlike the BYE command, the "other" session remains
  300.               active.
  301. 1
  302.  
  303.  
  304.       CP-6 Kermit           Version: 1.00           January 1988           Page 6
  305.  
  306.       13.4  Normal CP-6 KERMIT Commands (continued)
  307.  
  308.       H/ELP [(processor)][ TOPICS ][ keyword1 ][ - ][ keyword2]
  309.  
  310.               HELP prints information.
  311.  
  312.               HELP messages have levels.  Once the initial level has been printed,
  313.               typing a question mark prints the next level, usually containing
  314.               greater detail.  Typing two question marks prints the entire message.
  315.  
  316.               Any processor with a standard HELP file can be read from KERMIT.
  317.  
  318.               The HELP can be issued at the double-bang (!!) without losing the
  319.               suspended activity.  Thus, one may exit a processor (such as FORTRAN)
  320.               with a <CNTL><Y>, query for HELP information, and then issue GO to
  321.               return to FORTRAN.
  322.  
  323.               Parameters have the following meanings:
  324.  
  325.               processor -
  326.                   specifies a program or processor that has an associated HELP file.
  327.                   The default is the processor currently under control (in this
  328.                   case, KERMIT).
  329.  
  330.               TOPICS -
  331.                   specifies that only a list of available topics (message names) is
  332.                   required.  The range of topics is determined by keyword1 or
  333.                   keyword2.
  334.  
  335.               keyword1  -
  336.                   specifies the name of the message to be printed.
  337.  
  338.               keyword2  -
  339.                   if a range is specified (by including a dash " - " or greater than
  340.                   ">"), keyword2 is the upper limit of the range.  If a range is not
  341.                   specified, keyword2 is a submessage, or category within a message.
  342.  
  343.       L[IST] [(listopt)] [sourcelist [{ON|TO|OVER|INTO} destination]] [FROM fid]
  344.               Causes KERMIT to M$LINK to PCL, passing your entire LIST command to
  345.               PCL.  Since PCL is really doing the LIST, the command specified may
  346.               have any of the options that the PCL LIST command accepts.
  347.  
  348.       LOC[AL] { CWD [[.] account] | DIR[ECTORY] [listopt] }
  349.               The LOCAL commands are miscellaneous commands to be performed on the
  350.               local machine; in this case CP-6.  The LOCAL CWD (Change Working
  351.               Directory) performs the same function as the CP-6 DIRECTORY command.
  352.               The LOCAL DIRECTORY command performs the same function as the CP-6 PCL
  353.               LIST command.
  354. 1
  355.  
  356.  
  357.       CP-6 Kermit           Version: 1.00           January 1988           Page 7
  358.  
  359.       13.4  Normal CP-6 KERMIT Commands (continued)
  360.  
  361.       LOG [T[RANSACTIONS]] [{ON|TO|OVER|INTO}] fid
  362.               LOGs information about the files transferred into the specified file.
  363.               This is especially useful when CP-6 KERMIT is running as a SERVER.  In
  364.               SERVER mode it is difficult (at best) to get "informational" messages
  365.               displayed to the user because the "other" computer is in transfer mode
  366.               all the time.
  367.  
  368.               LOG information is written to the indicated EDIT KEYED file with the
  369.               fractional portion of the EDIT key being the same for like types.  The
  370.               following is a summary of the various types currently generated:
  371.  
  372.               xxxxx.000 - Date, time and users logon account and name
  373.               xxxxx.100 - A message indicating the direction (SEND or RECEIVE) of
  374.                           the transfer, file name, number of records and the mode
  375.                           (TEXT or BINARY).  This record is actually written twice;
  376.                           once when the transfer starts (the text indicates this)
  377.                           and again when the transfer completes.  This is the reason
  378.                           why this file is KEYED and makes it possible to tell if a
  379.                           started transfer actually finished normally.
  380.               xxxxx.200 - Packet sizes used (by each side) for the transfer
  381.               xxxxx.300 - Number of Data packets used and how many bytes were
  382.                           transferred
  383.               xxxxx.600 - Elapsed time of the transfer
  384.               xxxxx.700 - Error message from any error that may have prematurely
  385.                           stopped the transfer
  386.  
  387.       OUT[PUT] [{ON|TO|OVER|INTO}] destination
  388.               Directs KERMIT's primary output to the specified destination.
  389.  
  390.               The default is OUTPUT ON ME.
  391.  
  392.       PRINT [ALL | ldevlist]
  393.               Causes accumulated output for the specified logical device to be
  394.               released to the symbiont.  If no parameters are specified, ALL is
  395.               assumed.
  396.  
  397.       PROM[PT] 'prompt-string'
  398.               Specifies the prompt string that KERMIT will subsequently prompt with.
  399.  
  400.               The default is PROMPT 'CP-6 Kermit> '.
  401.  
  402.       { READ | TAKE } fid
  403.               Causes subsequent KERMIT commands to be read from 'fid'.  When the end
  404.               of 'fid' is reached, input reverts back to the source in use prior to
  405.               the READ command.  READ commands may NOT be nested; that is, a file
  406.               being READ cannot contain a READ command.
  407.  
  408.       REC[EIVE] [{ destfid | otherfid {ON|TO|OVER|INTO} destfid }]
  409.               Instructs KERMIT to RECEIVE file(s).  If no parameters are specified,
  410.               the file name is taken from the file packet sent to CP-6 from "the
  411.               other" computer.  If destfid is specified, it overrides the name sent
  412.               in the file packet.  If otherfid is specified, it is ignored!
  413. 1
  414.  
  415.  
  416.       CP-6 Kermit           Version: 1.00           January 1988           Page 8
  417.  
  418.       13.4  Normal CP-6 KERMIT Commands (continued)
  419.  
  420.       SEN[D] sourcefid [[AS] destfid]
  421.               Causes KERMIT to SEND sourcefid to "the other" computer.  If destfid
  422.               is specified and sourcefid is NOT wildcarded, destfid will be sent as
  423.               the file name in the file packet to "the other" computer.  'sourcefid'
  424.               may be wildcarded using the question mark (?) as the wildcard
  425.               character.
  426.  
  427.       SER[VER]
  428.               Puts CP-6 KERMIT into file SERVER mode.  In this mode, CP-6 KERMIT
  429.               accepts its commands through packets from "the other" computer.  Once
  430.               this command is issued on CP-6, it can be stopped in any one of three
  431.               ways:
  432.  
  433.                 1) If "the other" computer goes back to emulator mode on CP-6 and a
  434.                    carriage return(s) are entered, CP-6 KERMIT will again prompt the
  435.                    user for commands.
  436.                 2) Issue the FINISH command on "the other" computer.  This will
  437.                    cause CP-6 KERMIT to exit to IBEX.
  438.                 3) Issue the BYE command on "the other" computer which causes CP-6
  439.                    KERMIT to be exited and an !OFF command to be issued thus
  440.                    terminating the CP-6 session.
  441.  
  442.       SET B[LOCK] [-] [C[HECK]] [=] { 1 | 2 | 3 } [CHARACTER] [CHECKSUM]
  443.               Note:  Only 1 is supported at the present time.
  444.  
  445.               KERMIT checks the validity of data in each packet via a block check.
  446.               The sender of the packet computes the block check based on the other
  447.               characters in the packet and the receiver recomputes it the same way.
  448.               If these quantities agree, the packet is accepted and the transmission
  449.               proceeds.  If they disagree, the packet is rejected and transmitted
  450.               again.
  451.  
  452.               There are three different block checks (sometimes know as checksums)
  453.               that are supported in the KERMIT protocol.  The first one ("1" in the
  454.               option list above) is the simplest block check and is required to be
  455.               supported in all versions of KERMIT.  At the present time, this is the
  456.               ONLY one supported by CP-6 KERMIT.  This block check is only a 6-bit
  457.               quantity (the low order 8 bits of the arithmetic sum folded upon
  458.               itself).  With only six bits of accuracy, the chances are one in 64
  459.               that an error can occur which will not be detected in the checksum,
  460.               assuming that all errors are equally likely.
  461.  
  462.               The second block check ("2" in the option list above) is much like the
  463.               first except that it is a 12-bit checksum instead of 6-bit.  This
  464.               reduces the chance of an undetected error to be one in 4096 but also
  465.               takes another byte in the packet that otherwise could have been used
  466.               for data.
  467.  
  468.               The third and last block check ("3" in the option list above) is a
  469.               3-character, 16-bit Cyclic Redundancy Check, CCITT format.  In
  470.               addition to errors in any odd number of bits, this method detects
  471.               double bit errors, all error bursts of length 16 or less and more than
  472.               99.99% of all possible longer bursts.  This method also uses two more
  473.               bytes in the packet that could have otherwise been used for data.
  474. 1
  475.  
  476.  
  477.       CP-6 Kermit           Version: 1.00           January 1988           Page 9
  478.  
  479.       13.4  Normal CP-6 KERMIT Commands (continued)
  480.  
  481.       SET D[ELAY] [=] value
  482.               "value" specifies the number of seconds to wait before sending the
  483.               first packet to "the other" computer after a SEND command is issued to
  484.               CP-6 KERMIT.  The reason for this is to give you enough time to
  485.               "escape" back to "the other" computer and issue a RECEIVE command.
  486.               This "delay" does NOT occur when CP-6 KERMIT is in SERVER mode.
  487.  
  488.               The default is SET DELAY = 10.
  489.  
  490.       SET F[ILE] parameter
  491.  
  492.               B[INARY] EX[TENSIONS] [=] 'suffix' [,'suffix'...]
  493.                       This option, when used in conjunction with SET FILE
  494.                       MODE=AUTOMATIC and SET FILE PC EXTENSION=YES, allows the user
  495.                       to specify a list of (possibly wildcarded) binary file
  496.                       extensions (i.e., suffixes).  If the name of a file being
  497.                       transferred matches any of the extensions specified in this
  498.                       option, the file will be transferred in BINARY mode.
  499.                       Otherwise, the transfer will be done in TEXT mode.  Each of
  500.                       the extensions you specify is implicitly preceded with a '?'.
  501.  
  502.                       The default is SET FILE BINARY EXTENSIONS = '-ARC', '_ARC',
  503.                       '-COM', '_COM', '-EXE', '_EXE', '-LIB', '_LIB'.
  504.  
  505.               C[P] [-] [6] [F[IDS]] [P[ERMITTED]] [=] { Y[ES] | N[O] }
  506.                       If YES is specified, CP-6 KERMIT will expect the file names
  507.                       passed, in type 'F' packets, to be legal CP-6 fids.  This
  508.                       being the case, any periods in names will be treated as CP-6
  509.                       file name, account and/or password delimiters as opposed to PC
  510.                       name and extension separators.  If NO is specified, then CP-6
  511.                       KERMIT looks for illegal fid characters in the passed file
  512.                       names.  If any are found, they are replaced with the SET FILE
  513.                       REPLACEMENT character, which is an underscore (_) by default.
  514.  
  515.                       The default is SET FILE CP6 FIDS PERMITTED = NO.
  516.  
  517.               E[DIT] [K[EY]] [=] { Y[ES] | N[O] }
  518.                       If YES is specified, then RECEIVEd file will be EDIT KEYED.
  519.                       Otherwise, the file will be created as a CONSECutive file.
  520.  
  521.                       The default is SET FILE EDIT KEYED = NO.
  522.  
  523.               E[ND] O[F] R[ECORD] [=] dec3 [,dec3]
  524.                       This option allows the user to specify the "end of record"
  525.                       sequence that will be sent in packets to delimit logical
  526.                       records.  The values are specified in decimal and separated
  527.                       with commas.
  528.  
  529.                       The default is SET FILE END OF RECORD = 13, 10 which is CR,
  530.                       LF.
  531. 1
  532.  
  533.  
  534.       CP-6 Kermit           Version: 1.00           January 1988           Page 10
  535.  
  536.       13.4  Normal CP-6 KERMIT Commands (SET FILE continued)
  537.  
  538.               I[NCOMPLETE] [=] { D[ISCARD] | K[EEP] }
  539.                       If KEEP is specified, any portion of a file transfer (to CP-6)
  540.                       prior to an interruption will be kept.  If DISCARD is
  541.                       specified, only successfully transferred files will be
  542.                       retained.
  543.  
  544.                       The default is SET FILE INCOMPLETE = DISCARD.
  545.  
  546.               M[ODE] [=] { A[UTOMATIC] | B[INARY] | T[EXT] }
  547.                       This option controls the file transfer mode.
  548.  
  549.                       If BINARY is specified, all records being read or written
  550.                       from/to a CP-6 file should be 128 bytes.  All bytes are
  551.                       transmitted such that they will end up on "the other" machine
  552.                       as they were on the source machine (e.g., TAB characters will
  553.                       end up as TAB characters rather than an appropriate number of
  554.                       blanks).
  555.  
  556.                       If TEXT is specified, each record being sent from a CP-6 file
  557.                       will have the END OF RECORD (see SET FILE END OF RECORD)
  558.                       character(s) appended to it in the packet.  Similarly, packets
  559.                       being received will have the END OF RECORD character(s)
  560.                       removed from each record before the record is written to the
  561.                       CP-6 file.
  562.  
  563.                       If AUTOMATIC is specified, a RECEIVE transfer will be done in
  564.                       BINARY mode if:
  565.                         1) the SET FILE PC EXTENSIONS = YES and
  566.                         2) if the name of the file being transferred matches one of
  567.                            those extensions in the extension list (see SET FILE
  568.                            BINARY EXTENSIONS).
  569.                       If AUTOMATIC is specified and a SEND is being done, the
  570.                       transfer will be done in BINARY if:
  571.                         1) the CP-6 files 'TY' field equals 'BI' (as in BInary) or
  572.                         2) if SET FILE PC EXTENSIONS = YES and the name of the file
  573.                            being transferred matches at least one of the extensions
  574.                            in the binary extension list (see SET FILE BINARY
  575.                            EXTENSIONS option).
  576.  
  577.                       The default is SET FILE MODE AUTOMATIC.
  578.  
  579.               N[AMES] [=] { A[S] [IS] | L[OWER] [C[ASE]] | U[PPER] [C[ASE]] }
  580.                       This option controls if and how file names will be changed
  581.                       prior to being used on CP-6.
  582.  
  583.                       If AS IS is specified, then the file names will be used "as
  584.                       is" on CP-6.
  585.  
  586.                       If LOWERCASE is specified, then the file name will be changed
  587.                       to all lowercase prior to being used on CP-6.
  588.  
  589.                       If UPPERCASE is specified, then the file name will be changed
  590.                       to all uppercase prior to being used on CP-6.
  591.  
  592.                       The default is SET FILE NAMES = AS IS.
  593. 1
  594.  
  595.  
  596.       CP-6 Kermit           Version: 1.00           January 1988           Page 11
  597.  
  598.       13.4  Normal CP-6 KERMIT Commands (SET FILE continued)
  599.  
  600.               [PC] EX[TENSIONS] [=] { YES | NO }
  601.                       This option controls whether the BINARY EXTENSION list will be
  602.                       used to determine the MODE of file transfers.  See SET FILE
  603.                       MODE and SET FILE BINARY EXTENSIONS options for more
  604.                       information.
  605.  
  606.                       The default is SET FILE PC EXTENSIONS YES.
  607.  
  608.               PR[EFIX] [=] '19characters'
  609.                       This option allows a CP-6 file prefix (up to 19 characters) to
  610.                       be specified.When a file is RECEIVEd on CP-6, this prefix will
  611.                       precede the file name passed from "the other" computer.  When
  612.                       a file is SENDed from CP-6, this prefix (if present) will be
  613.                       removed from the file name sent to "the other" computer.  This
  614.                       feature was added to aid, for example, those users who are
  615.                       using CP-6 to "backup" the files on their "other" machine
  616.                       (usually a micro).
  617.  
  618.                       For instance, suppose you have a hard disk on your "other"
  619.                       computer that has multiple subdirectories.  In several of
  620.                       those subdirectories is a file called 'READ.ME'.  If you were
  621.                       to "backup" all those subdirectories into a single account on
  622.                       CP-6, you would end up with one READ.ME file.  The file would
  623.                       be either from the first (if SET FILE WARNING ON) or the last
  624.                       (if SET FILE WARNING OFF) subdirectory you "backed-up".  With
  625.                       this option, you could specify a different PREFIX (I.e., the
  626.                       subdirectory name) for each subdirectory you "backup".  This
  627.                       would result in all of the READ.ME files ending up with unique
  628.                       names on CP-6.
  629.  
  630.                       For another way to get files "restored" back to "the other"
  631.                       computer, see the SET FILE SUBDIRECTORY CHAR command.
  632.  
  633.                       The default is SET FILE PREFIX = '' which effectively disables
  634.                       this feature.
  635.  
  636.               R[EPLACEMENT] [C[HARACTER]] [=] '1character'
  637.                       If SET FILE CP-6 FIDS PERMITTED = NO is in effect, CP-6 KERMIT
  638.                       will check all specified CP-6 file names for illegal
  639.                       characters (including periods).  If any are found, they are
  640.                       replaced with the '1character' specified on this option.
  641.  
  642.                       The default is SET FILE REPLACEMENT CHARACTER = '_'.
  643. 1
  644.  
  645.  
  646.       CP-6 Kermit           Version: 1.00           January 1988           Page 12
  647.  
  648.       13.4  Normal CP-6 KERMIT Commands (SET FILE continued)
  649.  
  650.               SUB [DIRECTORY] C[HARACTER] [=] '1character'
  651.                       This command permits the user to simulate subdirectories
  652.                       (to a limited extent) on CP-6.  This is done by choosing a
  653.                       character to represent the subdirectory separator character.
  654.                       This character and all characters preceding it will be
  655.                       removed from file names sent to the local Kermit.
  656.  
  657.                       For example, if you type:
  658.                         SET FILE SUBDIRECTORY CHARACTER = ':'
  659.                         SEND TEST:FILE_EXT
  660.                       the file would be sent under the name 'FILE.EXT'.
  661.  
  662.                       If you want to turn this feature off, simply type:
  663.                         SET FILE SUBDIRECTORY OFF
  664.                       This will disable the feature until a subsequent
  665.                       SET FILE SUBDIRECTORY ON command is issued.  Event when this
  666.                       feature is disabled, the SET FILE SUBDIRECTORY CHARACTER is
  667.                       still retained so once specified it doesn't need to be SET
  668.                       again.
  669.  
  670.                       Initially, this feature is OFF, but the character is set to
  671.                       ':'.  This character was chosen because it can't occur in a PC
  672.                       filename, but it can in a CP-6 filename.  This feature is
  673.                       mainly intended to help organize CP-6 directories which are
  674.                       being used as central repositories for micro software.
  675.  
  676.                       The default is SET FILE SUBDIRECTORY CHARACTER = ':' and
  677.                                      SET FILE SUBDIRECTORY OFF.
  678.  
  679.               SUB [DIRECTORY] [=] { OFF | ON }
  680.                       When ON is specified, the feature described under the SET FILE
  681.                       SUBDIRECTORY CHAR command will be used.  When OFF is specified
  682.                       said feature is disabled but the character specified in
  683.                       SET SUB DIRECTORY CHAR will be retained.
  684.  
  685.               W[ARNING] [=] { OFF | OVER | ON | TO | INTO }
  686.                       This option controls what happens if the file being sent to
  687.                       CP-6 already exists.
  688.  
  689.                       If OFF or OVER is specified, any existing file of the same
  690.                       name is overwritten.  If no file currently exists, a new one
  691.                       is created.
  692.  
  693.                       If ON or TO is specified and a file of the same name already
  694.                       exists, an error is returned and the existing file remains
  695.                       unchanged.
  696.  
  697.                       If INTO is specified and the file already exists, the file
  698.                       will be extended.  If no file currently exists then one is
  699.                       created.
  700.  
  701.                       The default is SET FILE WARNING ON.
  702. 1
  703.  
  704.  
  705.       CP-6 Kermit           Version: 1.00           January 1988           Page 13
  706.  
  707.       13.4  Normal CP-6 KERMIT Commands (continued)
  708.  
  709.       SET R[ETRY] [C[OUNT]] [F[OR]] { I[NITIAL] [P[ACKETS]] | P[ACKETS] }
  710.               This option sets the error retry threshold for either the Initial
  711.               packet or Data packets.
  712.  
  713.               The defaults are SET RETRY COUNT FOR INITIAL PACKET = 10 and
  714.                                SET RETRY COUNT FOR PACKETS = 10.
  715.  
  716.       SET SEN[D] parameter
  717.  
  718.               EI[GHT] [B[IT]] [Q[UOTING]] [C[HARACTER]] [=] '1character'
  719.                       This option will only be used when the parity of the
  720.                       communications line is something other than NONE or ZERO
  721.                       (i.e., when the eighth bit is not available for data).  When
  722.                       specified, this character must be "Y" or "N" or a character in
  723.                       the range ASCII 33-62 ("!" through ">") or 96-126 ("'" through
  724.                       "~"), but MUST be different from the SEND QUOTE and SEND REPT
  725.                       values.  The value is interpreted as follows:
  726.  
  727.                       Y  CP-6 KERMIT will do 8-bit quoting if "the other" KERMIT
  728.                          requests it.
  729.                       N  8-bit quoting will NOT be done.
  730.                       &  (or any other character in the range 33-62 or 96-126) means
  731.                          CP-6 KERMIT will use this character for 8-bit quoting (if
  732.                          "the other" KERMIT responds with a "Y" or the same
  733.                          character).  The "&" is the recommended 8-bit quote
  734.                          character.
  735.  
  736.                       The default is SET SEND EIGHT BIT QUOTING CHARACTER = 'Y'.
  737.  
  738.               E[ND] O[F] L[INE] [=] dec3
  739.                       The ASCII character that will be used as the line terminator
  740.                       for all outgoing packets.  The default value is 13 (Carriage
  741.                       Return).
  742.  
  743.               PACK[ET] [L[ENGTH]] [=] dec
  744.                       The maximum length packet that CP-6 KERMIT wants to receive, a
  745.                       number in the range 7 to 94, inclusive.  It is recommended
  746.                       that this value be 94 (the maximum) unless numerous retries
  747.                       are occurring in which case the value should be gradually
  748.                       decreased until retries only occur occasionally, if at all.
  749.  
  750.                       The default is SET SEND PACKET LENGTH = 94.
  751.  
  752.               PAU[SE] [=] dec
  753.                       Specifies how many seconds to pause before ACKnowledging a
  754.                       packet.  Setting this to a nonzero value will slow down the
  755.                       rate at which data packets arrive, which may be necessary for
  756.                       systems that have "sensitive" front ends and cannot accept
  757.                       input at a high rate.
  758.  
  759.                       The default is SET SEND PAUSE = 0.
  760. 1
  761.  
  762.  
  763.       CP-6 Kermit           Version: 1.00           January 1988           Page 14
  764.  
  765.       13.4  Normal CP-6 KERMIT Commands (SET SEND continued)
  766.  
  767.               PADC[HAR] [=] dec3
  768.                       This is a padding character that the "other computer" will
  769.                       send before each packet.  The number of padding characters
  770.                       required is determined by the value of the SEND PADDING
  771.                       parameter.  It is doubtful that you will ever need to set this
  772.                       or the SEND PADDING values.
  773.  
  774.                       The default is SET SEND PADCHAR = 0.
  775.  
  776.               PADD[ING] [=] dec
  777.                       This indicates the number of padding characters (see SET SEND
  778.                       PADCHAR) that the "other computer" should send before each
  779.                       packet.  It is doubtful that you will ever need to set this
  780.                       value.  A value of 0 (zero) means that no padding characters
  781.                       are needed.
  782.  
  783.                       The default is SET SEND PADDING = 0.
  784.  
  785.               Q[UOTE] [CTL] [=] '1character'
  786.                       This is the printable ASCII character CP-6 KERMIT will use to
  787.                       quote control characters.  This must be a printable character
  788.                       and the MUST be different from both the EIGHT BIT QUOTING
  789.                       CHARACTER and the REPEAT CHARACTER.
  790.  
  791.                       The default is SET SEND QUOTE CTL = '#'.
  792.  
  793.               R[EP] [E[A]] [T] [C[HARACTER]] [=] '1character'
  794.                       This is the character that will indicate a repeated character.
  795.                       This can be any printable character in the range ASCII 33-62
  796.                       ("!" through ">") or 96-126 ("'" through "~") but MUST be
  797.                       different than both the SEND QUOTE and SEND EIGHT BIT QUOTING
  798.                       CHARACTER.  Any character outside this range indicates
  799.                       repeating will NOT be done.  The tilde (ASCII 126, "~") is the
  800.                       recommended and normal repeat prefix.  If "the other" KERMIT
  801.                       does not respond with the same character, no repeating will be
  802.                       done.  If repeating is possible by both KERMITs, it will be
  803.                       used to represent 4 or more consecutive occurrences of the
  804.                       same character.
  805.  
  806.                       The default is SET SEND REPEAT CHARACTER = '~'.
  807.  
  808.               S[TART] [O[F]] [P[ACKET]] [=] dec
  809.                       The synchronization character that marks the beginning of the
  810.                       packet.  This is a SOH (CTRL-A) by default but may be
  811.                       changed if needed.
  812.  
  813.                       The default is SET SEND START OF PACKET = 1.
  814.  
  815.               T[IMEOUT] [=] dec
  816.                       The number of seconds after which CP-6 KERMIT wants "the
  817.                       other" KERMIT to time out while waiting for a packet from
  818.                       CP-6.
  819.  
  820.                       The default is SET SEND TIMEOUT = 8.
  821. 1
  822.  
  823.  
  824.       CP-6 Kermit           Version: 1.00           January 1988           Page 15
  825.  
  826.       13.4  Normal CP-6 KERMIT Commands (continued)
  827.  
  828.       SET TAB EX[PANSION] [=] { OFF | ON }
  829.               Indicates if received TAB characters are to be replaced with an
  830.               appropriate number of spaces to move to the next "tab stop".  If ON is
  831.               specified, it is only honored during TEXT mode transfers (i.e., in a
  832.               BINARY transfer, TABs will be sent as TAB characters).
  833.  
  834.               The default is SET TAB EXPANSION ON.
  835.  
  836.       SET TABS [ dec [,dec...] ]
  837.               Accepts the desired "tab stop" settings.  Up to 40 values may be
  838.               specified but they must be in ascending order.  A value of 0 (zero)
  839.               means revert back to the default.
  840.  
  841.               These values are only used on TEXT mode transfers and only if SET TAB
  842.               EXPANSION = ON, which IS the default.
  843.  
  844.               The default is SET TABS 9,17,25,33,41,49,57, ... ,305,313,321.
  845.  
  846.       SHOW
  847.               Shows the current settings for SETable items.
  848.  
  849.       STATION = station_name
  850.               Specifies the name of the ComGroup station to be used for file
  851.               transfers.  This option is only meaningful when specified in
  852.               conjunction with the CG option.  If either the CG or STATION options
  853.               are specified without the other option then the option that was
  854.               specified will be IGNORED.
  855.  
  856.       TR[ANSMIT] fid
  857.               Sends 'fid' to the "other computer" raw; that is, with no protocol
  858.               involved.  CP-6 KERMIT will DELAY the sending of 'fid' by the number
  859.               of seconds currently set for the SET DELAY option.
  860. 1
  861.  
  862.  
  863.       CP-6 Kermit           Version: 1.00           January 1988           Page 16
  864.  
  865.       13.5  Installation
  866.  
  867.       13.5.1  To start the installation of this version of KERMIT, put the following
  868.               files into the same account.  They may coexist with other files in
  869.               the account.
  870.  
  871.                HC6KERMIT_BLD      Section 13.5 (Installation) of HC6KERMIT_DOC
  872.                HC6KERMIT_C61      INCLUDEd file used in HC6KERMIT_PAR & _PL6 files
  873.                HC6KERMIT_DOC      Documentation for this version of CP-6 KERMIT
  874.                HC6KERMIT_FCC      HC6KERMIT_DOC file with Fortran Carriage Control
  875.                HC6KERMIT_HER      HERMAN.X source file; used to create HELP:KERMIT:
  876.                HC6KERMIT_INS      CP-6 XEQ file that customizes the HC6KERMIT_JCL
  877.                HC6KERMIT_JCL      File to !XEQ that creates KERMIT & HELP:KERMIT:
  878.                HC6KERMIT_PAR      Source file for the PARTRGE processor
  879.                HC6KERMIT_PL6      Source file for the PL-6 compiler
  880.                HC6KERMIT_UPD      List of changes/fixes made to CP-6 Kermit
  881.                HC6KERMIT_UPD_PAR  If present, CP-6 style updates to HC6KERMIT_PAR
  882.                HC6KERMIT_UPD_PL6  If present, CP-6 style updates to HC6KERMIT_PL6
  883.  
  884.       13.5.2  Change, via the !DIR command, your file management directory to the
  885.               account where the above files reside.
  886.  
  887.       13.5.3  Make a listing of HC6KERMIT_FCC by issuing the following command:
  888.                !LDEV LP30 LP,FORM='LONG'
  889.                !COPY HC6KERMIT_FCC TO LP30(VFC,FVFC)
  890.                !PRINT LP30
  891.  
  892.       13.5.4  Next, !XEQ HC6KERMIT_INS.  This file MUST be XEQ'd (not BATCH'd)
  893.               because it will ask various questions and then will change other files
  894.               based upon your answers to the questions.
  895.  
  896.               The logon account that HC6KERMIT_INS is XEQ'd from will need WRITE
  897.               access to the account where the HC6? files reside.
  898.  
  899.       13.5.5  Be certain that the account you will be running HC6KERMIT_JCL from is
  900.               authorized to run with the resources specified on the !RES/ORES
  901.               commands in the HC6KERMIT_JCL file.  Furthermore, that account must
  902.               have access to execute PL6.:SYS, PARTRGE.:SYS and HERMAN.X.
  903.  
  904.       13.5.6  Next, XEQ or BATCH HC6KERMIT_JCL.  This will create the KERMIT
  905.               run unit and the HELP:KERMIT: file, used by the CP-6 HELP facility.
  906.  
  907.               Note:  By default, the listings produced by the PL-6 compile and
  908.               PARTRGE will be EDGEMARK'd.  If you do NOT want them EDGEMARK'd,
  909.               include DEST=LP as a substitution on your XEQ/BATCH of HC6KERMIT_JCL.
  910.