*@ KERMIT HELP SYSTEM MESSAGE TEXT MODULE @
*@ ====== ==== ====== ======= ==== ====== @
 
*CREATE(KMTHELPMTM)
*PROC(KMTHELPMTM)
*VERSION(101)
*PARAMS(EXP&ICL)
*LINESPLIT(SPACE)
 
*@ N.B. NIL IS ASSUMED TO HAVE A VALUE OF -1 @
 
*1        @ text to validate command for which help required @
 
<CASE P2 STARTS
         <> OR <-1>        THEN J20,   @ no command specified @
         <SERVER>          THEN J250,
         <RECEIVE>         THEN J500,
         <SEND>            THEN J750,
         <HELP>            THEN J1000,
         <EXIT>            THEN J1250,
         <SET>             THEN J1500,
         <SHOW>            THEN J1750,
         <STATISTICS   >   THEN J2000,
         <START-OF-PACKET> THEN J9000  @ not a command, START-OF-PACKET info @
      DEFAULT                   J10    @ invalid command @
 ESAC
>
 
*10        @ invalid command entry @
 
<L1><P2> is not a VME Kermit command.
 
*20        @ no command specified, display menu @
 
<L1>Help is available for the following VME Kermit commands: <HALT -1>
<L1>(n.b. square brackets enclose optional parameters and should
omitted when entering a command.) <L1><HALT -1>
<S3>(1) SERVER <TAB 35>: select Kermit Server mode <HALT -1>
<S3>(2) RECEIVE [VME-filename] <TAB 35>: prepare to receive file <HALT -1>
<TAB 35>[save as VME-filename] <HALT -1>
<S3>(3) SEND VME-filename [dest-filename] : send file <HALT -1>
<TAB 35>[store as dest-filename] <HALT -1>
<S3>(4) HELP [command] [params] <TAB 35>: obtain help <HALT -1>
<TAB 35>[for command or command and parameters] <HALT -1>
<S3>(5) EXIT <TAB 35>: exit from VME Kermit <HALT -1>
<S3>(6) SET param value <TAB 35>: set Kermit parameter <HALT -1>
<S3>(7) SHOW <TAB 35>: show value of all Kermit parameters <HALT -1>
<S3>(8) STATISTICS <TAB 35>: display details of last transfer <HALT -1,J30>
 
*30        @ Select command prompt @
 
<L1>Select command (Enter 1 to 8 or 0 if no further help required): <HALT 40>
 
*40        @ validate response to Select command @
 
<CASE P2 EQUALS
         <0> THEN <>,
         <1> THEN J250,
         <2> THEN J500,
         <3> THEN J750,
         <4> THEN J1000,
         <5> THEN J1250,
         <6> THEN J1500,
         <7> THEN J1750,
         <8> THEN J2000
      DEFAULT     J50
 ESAC
>
 
 
*50        @ invalid response to Select command prompt @
 
<L1>**** Invalid response, please re-select. <HALT -1><J30>
 
*60        @ more help prompt @
 
<L1>Any more help required (YES/NO)? <HALT 70>
 
*70        @ validate more help reply @
 
<CASE P2 STARTS
         <YES> OR <yes> THEN J20,
         <NO>  OR <no>  THEN <>
      DEFAULT         J60
 ESAC
>
 
*250       @ SERVER command help @
 
<L1>SERVER command: <HALT -1>
<L1><TAB 15>Syntax: SERVER <HALT -1>
<L1>The SERVER command selects VME Kermit Server mode. All further commands
are sent to VME Kermit by the user Kermit (running on your micro). File
transfers are initiated via commands given to the micro Kermit. VME Kermit
will remain in Server mode until the user Kermit instructs VME Kermit to exit
to VME command level (after you have issued a FINISH command to the micro
Kermit) or the user Kermit tells VME Kermit to log out (after you have issued
a BYE command to the micro Kermit). <HALT -1>
<L1>WARNING: It is inadvisable to select VME Kermit Server mode if your micro
Kermit doesn't have the following commands for communicating with servers:
GET, BYE and FINISH. If in doubt, consult your documentation. <HALT -1>
<CASE P1 <>,J60 ESAC>
 
*500       @ RECEIVE command help @
 
RECEIVE command: <HALT -1>
<L1><TAB 15>Syntax: RECEIVE [VME-filename] <HALT -1>
<L1>The RECEIVE command prepares VME Kermit for the arrival of a file from
the micro Kermit. If a VME filename is specified, the file will be saved with
this name. If no filename is specified, a filename will be sent by the micro
Kermit and, if possible, the file will be saved with that name. <HALT -1>
<L1>After issuing the RECEIVE command, escape back to the micro Kermit and
initiate the file transfer by entering a SEND command. <HALT -1>
<CASE P1 <>,J60 ESAC>
 
*750       @ SEND command help @
 
<L1>SEND command: <HALT -1>
<L1><TAB 15>Syntax: SEND VME-filename [destination-filename] <HALT -1>
<L1>The VME file is sent to the micro Kermit. If a destination filename
is included, the file will be stored by the micro with this name,
otherwise the VME filename will be used. <HALT -1>
<L1>After issuing the SEND command escape back to the micro Kermit and
prepare the micro for the arrival of the file by issuing a RECEIVE
command. <HALT -1>
<CASE P1 <>,J60 ESAC>
 
*1000      @ HELP command help @
 
<L1>HELP command: <HALT -1>
<L1><TAB 15>Syntax: HELP [command] [parameter(s)]
<L1>The HELP command gives information for the specified command, or allows
the user to request information via a menu. If a command is specified,
it may be qualified by appending parameter names. <HALT -1>
<CASE P1 <>,J60 ESAC>
 
*1250      @ EXIT command help @
 
<L1>EXIT command: <HALT -1>
<L1><TAB 15>Syntax: EXIT <HALT -1>
<L1>The EXIT command terminates the VME Kermit session, closes any logging
files and returns the user to VME command level. <HALT -1>
<CASE P1 <>,J60 ESAC>
 
*1500      @ SET command help @
 
<CASE P3 STARTS
         <> OR <-1>        THEN J1505, @ no parameter specified @
         <DEBUG>           THEN J1520,
         <DELAY>           THEN J1540,
         <PAUSE>           THEN J1560,
         <RETRY>           THEN J1580,
         <FILE>            THEN J1600,
         <SEND>            THEN J1620,
         <RECEIVE>         THEN J1640
      DEFAULT                   J1504  @ invalid parameter @
 ESAC
>
 
*1501      @ SET command help exit @
 
<CASE P1 <>,J1502 ESAC>
 
 
*1502      @ more help prompt @
 
<L1>Any more help required? Select:- <HALT -1>
<S3>(0) No more help <HALT -1>
<S3>(1) More help for this command <HALT -1>
<S3>(2) More help for another command <HALT -1>
<L1>Enter choice (0 to 2): <HALT 1503>
 
 
*1503      @ validate more help response @
 
<CASE P2 EQUALS
         <0> THEN <>,
         <1> THEN J1505,
         <2> THEN J20
      DEFAULT     J1502  @ invalid response, reprompt @
 ESAC
>
 
 
*1504      @ invalid SET parameter @
 
<L1>**** <P3> is not a SET parameter. <HALT -1><J1501>
 
*1505      @ SET command menu @
 
<L1>SET command: <HALT -1>
<L1><TAB 15>Syntax: SET parameter value <HALT -1>
<L1>The SET command establishes or modifies various parameters for file
transfer or logging. <HALT -1>
<L1>The following parameters may be set: <L1><HALT -1>
<S3>(1) DEBUG {FILE/PROTOCOL/PACKET/DEVICE/ALL} {ON/OFF} <HALT -1>
<S3>(2) DELAY seconds <HALT -1>
<S3>(3) PAUSE 10th-seconds <HALT -1>
<S3>(4) RETRY maximum-retries <HALT -1>
<S3>(5) FILE parameter value <HALT -1>
<S3>         TYPE {EBCDIC/ASCII/BINARY} <HALT -1>
<S3>         NAMING {UNTRANSLATED/NORMAL-FORM} <HALT -1>
<S3>         OVERWRITE {ON/OFF} <HALT -1>
<S3>         INCOMPLETE {DISCARD/KEEP} <HALT-1>
<S3>(6) SEND parameter value <HALT -1>
<S3>(7) RECEIVE parameter value <HALT -1>
<S3>            START-OF-PACKET ctl-char <HALT -1>
<S3>            PACKET-LENGTH number <HALT -1>
<S3>            TIMEOUT number <HALT -1>
<S3>            END-OF-LINE ctl-char <HALT -1>
<S3>            PADDING number <HALT -1>
<S3>            PAD-CHARACTER ctl-char <HALT -1>
<S3>            QUOTE char <HALT -1>
<S3>            EIGHTH-BIT-PREFIX char <HALT -1>
<J1506>
 
 
*1506      @ select SET parameter @
 
<L1>For further information enter choice (1 to 7) or 0 if no further
information is required: <HALT 1507>
 
 
*1507      @ validate selection @
 
<CASE P2 EQUALS
         <0> THEN <>,
         <1> THEN J1520,
         <2> THEN J1540,
         <3> THEN J1560,
         <4> THEN J1580,
         <5> THEN J1600,
         <6> THEN J1620,
         <7> THEN J1640
      DEFAULT     J1508  @ invalid selection @
 ESAC
>
 
 
*1508      @ invalid selection @
 
<L1>**** Invalid response, please re-select.<HALT -1><J1506>
 
 
*1520      @ SET DEBUG @
 
<CASE P4 STARTS
         <> OR <-1>  THEN J1525,  @ no parameter specified @
         <FILE>      THEN J1530,
         <PROTOCOL>  THEN J1531,
         <PACKET>    THEN J1532,
         <DEVICE>    THEN J1533,
         <ALL>       THEN J1534
      DEFAULT             J1524   @ invalid parameter @
 ESAC
>
 
 
*1521      @ SET DEBUG command help exit @
 
<CASE P1 <>, J1522 ESAC>
 
 
*1522      @ more help prompt @
 
<L1>Any more help required? Select:- <HALT -1>
<S3>(0) No more help <HALT -1>
<S3>(1) More help for this command <HALT -1>
<S3>(2) More help for another command <HALT -1>
<L1>Enter choice (0 to 2): <HALT 1523>
 
 
*1523      @ validate more help response @
 
<CASE P2 EQUALS
         <0>  THEN <>,
         <1>  THEN J1525,
         <2>  THEN J20
      DEFAULT      J1522      @ invalid response, reprompt @
 ESAC
>
 
 
*1524      @ invalid SET DEBUG parameter @
 
<L1>**** <P4> is not a SET DEBUG parameter.<HALT -1><J1521>
 
 
*1525      @ SET DEBUG command menu @
 
<L1>SET DEBUG: <HALT-1>
<L1><TAB 15>Syntax: SET DEBUG parameter option <HALT -1>
<L1>Sets the various debugging facilities on or off.<HALT -1>
<L1>The following parameters may be set:<L1><HALT -1>
<S3>(1) FILE     {ON/OFF} <HALT -1>
<S3>(2) PROTOCOL {ON/OFF} <HALT -1>
<S3>(3) PACKET   {ON/OFF} <HALT -1>
<S3>(4) DEVICE   {ON/OFF} <HALT -1>
<S3>(5) ALL      {ON/OFF} <HALT -1>
<J1526>
 
 
*1526      @ select SET DEBUG parameter @
 
<L1>For further information enter choice (1 to 5) or 0 if no further
information is required: <HALT 1527>
 
 
*1527      @ validate selection @
 
<CASE P2 EQUALS
         <0>  THEN <>,
         <1>  THEN J1530,
         <2>  THEN J1531,
         <3>  THEN J1532,
         <4>  THEN J1533,
         <5>  THEN J1534
      DEFAULT      J1528      @ invalid selection @
 ESAC
>
 
 
*1528      @ invalid selection @
 
<L1>**** Invalid response, please re-select.<HALT -1><J1526>
 
 
*1530      @ SET DEBUG FILE @
 
<L1>SET DEBUG FILE: <HALT -1>
<L1><TAB 15>Syntax: SET DEBUG FILE option <HALT -1>
<L1>Turns file record tracing on or off. If option is ON then the contents of
all file records read or written will be logged (in hex) to the job journal.
The default is OFF. <HALT -1>
<L1>e.g. SET DEBUG FILE ON - turns on file record tracing. <HALT -1>
<J1521>
 
 
*1531      @ SET DEBUG PROTOCOL @
 
<L1>SET DEBUG PROTOCOL: <HALT -1>
<L1><TAB 15>Syntax: SET DEBUG PROTOCOL option <HALT -1>
<L1>Turns protocol state/event tracing on or off. If option is ON then the
internal states and events of the protocol handler will be logged to the job
journal. The default is OFF. <HALT -1>
<L1>e.g. SET DEBUG PROTOCOL ON - turns on protocol state/event tracing.<HALT -1>
<J1521>
 
 
*1532      @ SET DEBUG PACKET @
 
<L1>SET DEBUG PACKET: <HALT -1>
<L1><TAB 15>Syntax: SET DEBUG PACKET option <HALT -1>
<L1>Turns packet tracing on or off. If option is ON then the contents of all
packets sent and received will be logged to the job journal. The
default is OFF. <HALT -1>
<L1>e.g. SET DEBUG PACKET ON - turns on packet tracing. <HALT -1>
<J1521>
 
 
*1533      @ SET DEBUG DEVICE @
 
<L1>SET DEBUG DEVICE: <HALT -1>
<L1><TAB 15>Syntax: SET DEBUG DEVICE option <HALT -1>
<L1>Turns device tracing on or off. If option is ON then all the data sent and
received over the terminal link will be logged (in hex) to the job journal. The
default is OFF. <HALT -1>
<L1>e.g. SET DEBUG DEVICE ON - turns on device tracing. <HALT -1>
<J1521>
 
 
*1534      @ SET DEBUG ALL @
 
<L1>SET DEBUG ALL: <HALT -1>
<L1><TAB 15>Syntax: SET DEBUG ALL option <HALT -1>
<L1>Turns all tracing on or off. If option is ON then the contents of all file
records read or written, the internal states and events of the protocol handler,
the contents of all packets sent and received and all the data sent and
received over the terminal link will be logged to the job journal. The default
is OFF. <HALT -1>
<L1>e.g. SET DEBUG ALL ON - turns on all tracing. <HALT -1>
<J1521>
 
 
*1540      @ SET DELAY @
 
<L1>SET DELAY: <HALT -1>
<L1><TAB 15>Syntax: SET DELAY seconds <HALT -1>
<L1>Sets the length of delay before transmitting the first packet after
a SEND command has been issued. The default delay is 30 seconds. The
minimum delay that can be set is 5 seconds and the maximum is 300
seconds. Seconds may be expressed as a decimal value (e.g. 9) or as a
hexadecimal value (e.g. X09). <HALT -1>
<L1>e.g. SET DELAY 15 - sets the delay period to 15 seconds. <HALT -1>
<J1501>
 
 
*1560      @ SET PAUSE @
 
<L1>SET PAUSE: <HALT -1>
<L1><TAB 15>Syntax: SET PAUSE 10ths-second <HALT -1>
<L1>Sets the length of time to pause between receiving a packet from the remote
system and transmitting the next packet to it. The default pause is 0 tenths
of a second. The maximum pause that can be set is 50 tenths of a second.
10ths-second may be expressed as a decimal value (e.g. 9) or as a hexadecimal
value (e.g. X09). <HALT -1>
<L1>e.g. SET PAUSE 10 - sets the pause period to 10 tenths of a second.<HALT -1>
<J1501>
 
 
*1580      @ SET RETRY @
 
<L1>SET RETRY: <HALT -1>
<L1><TAB 15>Syntax: SET RETRY number <HALT -1>
<L1>Sets the maximum number of times to attempt to send or receive a packet
before abandoning the transfer. The default retry is 4. The maximum retry that
can be set is 10. Number may be expressed as a decimal value (e.g. 4) or as a
hexadecimal value (e.g. X04). <HALT -1>
<L1>e.g. SET RETRY 8 - sets the retry limit to 8 retries. <HALT -1>
<J1501>
 
 
*1600      @ SET FILE @
 
<CASE P4 STARTS
         <> OR <-1>    THEN J1605,  @ no parameter specified @
         <TYPE>        THEN J1610,
         <NAMING>      THEN J1611,
         <OVERWRITE>   THEN J1612,
         <INCOMPLETE>  THEN J1613
      DEFAULT               J1604   @ invalid parameter @
 ESAC
>
 
 
*1601      @ SET FILE command help exit @
 
<CASE P1 <>, J1602 ESAC>
 
 
*1602      @ more help prompt @
 
<L1>Any more help required? Select:- <HALT -1>
<S3>(0) No more help <HALT -1>
<S3>(1) More help for this command <HALT -1>
<S3>(2) More help for another command <HALT -1>
<L1>Enter choice (0 to 2): <HALT 1603>
 
 
*1603      @ validate more help response @
 
<CASE P2 EQUALS
         <0>  THEN <>,
         <1>  THEN J1605,
         <2>  THEN J20
      DEFAULT      J1602      @ invalid response, reprompt @
 ESAC
>
 
 
*1604      @ invalid SET FILE parameter @
 
<L1>**** <P4> is not a SET FILE parameter.<HALT -1><J1601>
 
 
*1605      @ SET FILE command menu @
 
<L1>SET FILE: <HALT-1>
<L1><TAB 15>Syntax: SET FILE parameter option <HALT -1>
<L1>Sets the various file attributes.<HALT -1>
<L1>The following parameters may be set:<L1><HALT -1>
<S3>(1) TYPE       {EBCDIC/ASCII/BINARY} <HALT -1>
<S3>(2) NAMING     {UNTRANSLATED/NORMAL-FORM} <HALT -1>
<S3>(3) OVERWRITE  {ON/OFF} <HALT -1>
<S3>(4) INCOMPLETE {DISCARD/KEEP} <HALT -1>
<J1606>
 
 
*1606      @ select SET FILE parameter @
 
<L1>For further information enter choice (1 to 4) or 0 if no further
information is required: <HALT 1607>
 
 
*1607      @ validate selection @
 
<CASE P2 EQUALS
         <0>  THEN <>,
         <1>  THEN J1610,
         <2>  THEN J1611,
         <3>  THEN J1612,
         <4>  THEN J1613
      DEFAULT      J1608      @ invalid selection @
 ESAC
>
 
 
*1608      @ invalid selection @
 
<L1>**** Invalid response, please re-select.<HALT -1><J1606>
 
 
*1610      @ SET FILE TYPE @
 
<L1>SET FILE TYPE: <HALT -1>
<L1><TAB 15>Syntax: SET FILE TYPE option <HALT -1>
<L1>Defines the type of file to be sent, or received.
option may be one of: <HALT -1>
<S3>EBCDIC meaning that the VME file contains, or is to contain EBCDIC <HALT -1>
<S3>       text and data conversion between EBCDIC and ASCII is <HALT -1>
<S3>       required. <HALT -1>
<S3>ASCII  meaning that the VME file contains, or is to contain ASCII <HALT -1>
<S3>       text and no data conversion is required. <HALT -1>
<S3>BINARY meaning that the VME file contains, of is to contain binary <HALT -1>
<S3>       data and no data conversion is required. Note in this case <HALT -1>
<S3>       the record boundaries of the VME file are not significant <HALT -1>
<S3>       to KERMIT. <HALT -1>
The default is EBCDIC. <HALT -1>
<L1>e.g. SET FILE TYPE BINARY - sets file transfer is to be binary.<HALT -1>
<J1601>
 
 
*1611      @ SET FILE NAMING @
 
<L1>SET FILE NAMING: <HALT -1>
<L1><TAB 15>Syntax: SET FILE NAMING option <HALT -1>
<L1>Defines how file names are to represented/interpretted. If option is
NORMAL-FORM then the VME and remote file names will be normalised. If option is
UNTRANSLATED then no file name normalisation will take place. The default is
NORMAL-FORM. <HALT -1>
<L1>e.g. SET FILE NAMING UNTRANSLATED - turns off file name normalisation.
<HALT -1>
<J1601>
 
 
*1612      @ SET FILE OVERWRITE @
 
<L1>SET FILE OVERWRITE: <HALT -1>
<L1><TAB 15>Syntax: SET FILE OVERWRITE option <HALT -1>
<L1>Defines the action to be taken when receiving a file and a VME file of the
same name and generation number already exists. If option is ON then the file
will be overwritten. If option is OFF then the file transfer will abandoned.
The default is OFF. <HALT -1>
<L1>e.g. SET FILE OVERWRITE ON - incoming file will be overwritten if it already
exists. <HALT -1>
<J1601>
 
 
*1613      @ SET FILE INCOMPLETE @
 
<L1>SET FILE INCOMPLETE: <HALT -1>
<L1><TAB 15>Syntax: SET FILE INCOMPLETE option <HALT -1>
<L1>Defines the action to be taken when receiving a file and the file transfer
is abandoned. If option is KEEP then the VME file will be saved. If option is
DISCARD then the VME file will not be saved. <HALT -1>
<L1>e.g. SET FILE INCOMPLETE KEEP - file to be saved if transfer abandoned.
<HALT -1>
<J1601>
 
 
*1620      @ SET SEND @
 
<J1650>
 
 
*1640      @ SET RECEIVE @
 
<J1650>
 
 
*1650      @ SET SEND/RECEIVE @
 
<CASE P4 STARTS
         <> OR <-1>          THEN J1655,  @ no parameter specified @
         <START-OF-PACKET>   THEN J1660,
         <PACKET-LENGTH>     THEN J1661,
         <TIMEOUT>           THEN J1662,
         <END-OF-LINE>       THEN J1663,
         <PADDING>           THEN J1664,
         <PAD-CHARACTER>     THEN J1665,
         <QUOTE>             THEN J1666,
         <EIGHTH-BIT-PREFIX>  THEN J1667
      DEFAULT                     J1654   @ invalid parameter @
 ESAC
>
 
 
*1651      @ SET SEND/RECEIVE command help exit @
 
<CASE P1 <>, J1652 ESAC>
 
 
*1652      @ more help prompt @
 
<L1>Any more help required? Select:- <HALT -1>
<S3>(0) No more help <HALT -1>
<S3>(1) More help for this command <HALT -1>
<S3>(2) More help for another command <HALT -1>
<L1>Enter choice (0 to 2): <HALT 1653>
 
 
*1653      @ validate more help response @
 
<CASE P2 EQUALS
         <0>  THEN <>,
         <1>  THEN J1655,
         <2>  THEN J20
      DEFAULT      J1652      @ invalid response, reprompt @
 ESAC
>
 
 
*1654      @ invalid SET SEND/RECEIVE parameter @
 
<L1>**** <P4> is not a SET SEND/RECEIVE parameter.<HALT -1><J1651>
 
 
*1655      @ SET SEND/RECEIVE command menu @
 
<L1>SET SEND/RECEIVE: <HALT-1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} parameter option <HALT -1>
<L1>Sets the various configuration parameters to allow the tailoring of
dissimilar systems to accomodate the peculiarities of the communication path.
Note a number of the configuration parameters may be modified during the
exchange of S or I packets and the acknowledgements to those packets. <HALT -1>
<L1>The following parameters may be set:<L1><HALT -1>
<S3>(1) START-OF-PACKET ctl_char <HALT -1>
<S3>(2) PACKET-LENGTH number <HALT -1>
<S3>(3) TIMEOUT seconds <HALT -1>
<S3>(4) END-OF-LINE ctl-char <HALT -1>
<S3>(5) PADDING number <HALT -1>
<S3>(6) PAD-CHARACTER ctl-char <HALT -1>
<S3>(7) QUOTE char <HALT -1>
<S3>(8) EIGHTH-BIT-PREFIX char <HALT -1>
<J1656>
 
 
*1656      @ select SET SEND/RECEIVE parameter @
 
<L1>For further information enter choice (1 to 8) or 0 if no further
information is required: <HALT 1657>
 
 
*1657      @ validate selection @
 
<CASE P2 EQUALS
         <0>  THEN <>,
         <1>  THEN J1660,
         <2>  THEN J1661,
         <3>  THEN J1662,
         <4>  THEN J1663,
         <5>  THEN J1664,
         <6>  THEN J1665,
         <7>  THEN J1666,
         <8>  THEN J1667
      DEFAULT      J1658      @ invalid selection @
 ESAC
>
 
 
*1658      @ invalid selection @
 
<L1>**** Invalid response, please re-select.<HALT -1><J1656>
 
 
*1660      @ SET SEND/RECEIVE START-OF-PACKET @
 
<L1>SET SEND/RECEIVE START-OF-PACKET: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} START-OF-PACKET ctl-char <HALT -1>
<L1>Sets the ASCII control character to be used as the start-of-packet marker.
The default is Record Separator (decimal 30, hex 1E). 'Ctl-char' may be
expressed as a decimal value (e.g. 30) or as a hexadecimal value (e.g. X1E).
Note a number of control characters are not accepted by VME as valid
start-of-packet markers. <HALT -1>
<L1>e.g. SET SEND START-OF-PACKET X1F - sets the start-of-packet marker for
output packets to Unit Separator. <HALT -1>
<J1651>
 
 
*1661      @ SET SEND/RECEIVE PACKET-LENGTH @
 
<L1>SET SEND/RECEIVE PACKET-LENGTH: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} PACKET-LENGTH number <HALT -1>
<L1>Sets the maximum length for a packet. The maximum packet-length plus the
padding (if any) must not exceed the limits of the VME terminal description
(normally 80 for output and 128 for input). The default packet-length is 80
characters. The minimum packet-length that can be set is 30 characters and the
maximum is defined by the terminal description (normally 80 for output and 94
for input). 'Number' may be expressed as a decimal value (e.g. 80) or as a
hexadecimal value (e.g. X50). <HALT -1>
<L1>e.g. SET RECEIVE PACKET-LENGTH 72 - sets the maximum packet-length of input
packets to 72 characters. <HALT -1>
<J1651>
 
 
*1662      @ SET SEND/RECEIVE TIMEOUT @
 
<L1>SET SEND/RECEIVE TIMEOUT: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} TIMEOUT seconds <HALT -1>
<L1>Sets the length of time to wait for a packet to arrive. The default is 0
seconds i.e. indefinite wait. The maximum timeout that can be set is 94 seconds.
'Seconds' may be expressed as a decimal value (e.g. 20) or as a hexadecimal
value (e.g. X14). <HALT -1>
<L1>e.g. SET RECEIVE TIMEOUT 20 - sets the timeout value for input packets to 20
seconds. <HALT -1>
<J1651>
 
 
*1663      @ SET SEND/RECEIVE END-OF-LINE @
 
<L1>SET SEND/RECEIVE END-OF-LINE: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} END-OF-LINE ctl-char <HALT -1>
<L1>Sets the ASCII control character to be used as the end of packet terminator.
The default is Carriage Return (decimal 13, hex 0D). 'Ctl-char' may be expressed
as a decimal value (e.g. 13) or as a hexadecimal value (e.g. X0D). Note a number
of control characters are not accepted by VME as valid end-of-line terminators.
<HALT -1>
<L1>e.g. SET RECEIVE END-OF-LINE X09 - sets the input packet end-of-line
terminator to Tab. <HALT -1>
<J1651>
 
 
*1664      @ SET SEND/RECEIVE PADDING @
 
<L1>SET SEND/RECEIVE PADDING: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} PADDING number <HALT -1>
<L1>Sets the number of padding characters to be sent before each packet. The
padding plus the maximum packet length must not exceed the limits of the VME
terminal description (normally 80 for output and 128 for input). The default
padding is 0 characters i.e. no padding. The maximum padding that can be set is
defined by the VME terminal description. <HALT -1>
<L1>e.g. SET SEND PADDING 4 - sets the padding for output packets to 4 pad
characters. <HALT -1>
<J1651>
 
 
*1665      @ SET SEND/RECEIVE PAD-CHARACTER @
 
<L1>SET SEND/RECEIVE PAD-CHARACTER: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} PAD-CHARACTER ctl-char <HALT -1>
<L1>Sets the ASCII control character to be used as a pad character to be sent
before each packet. The default is Null (decimal 0, hex 00). 'Ctl-char' may be
expressed as a decimal value (e.g. 0) or as a hexadecimal value (e.g X00).
Note a number of the control characters are not accepted by VME as valid pad
characters. <HALT -1>
<L1>e.g. SET SEND PAD-CHARACTER 7 - sets the output packet pad character to
Bell. <HALT -1>
<J1651>
 
 
*1666      @ SET SEND/RECEIVE QUOTE @
 
<L1>SET SEND/RECEIVE QUOTE: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} QUOTE char <HALT -1>
<L1>Sets the printable ASCII character to be used for control character
prefixing. It may be any printable character but it must be different from the
eighth-bit-prefix character. The default value is Hash (#) (decimal 35, hex 23).
'Char' may be expressed as an ASCII character (e.g. #), as a decimal value
(e.g. 35) or as a hexadecimal value (e.g. X23). <HALT -1>
<L1>e.g. SET SEND QUOTE ? - sets the output packet quote character to question
mark. <HALT -1>
<J1651>
 
 
*1667      @ SET SEND/RECEIVE EIGHTH-BIT-PREFIX @
 
<L1>SET SEND/RECEIVE EIGHTH-BIT-PREFIX: <HALT -1>
<L1><TAB 15>Syntax: SET {SEND/RECEIVE} EIGHTH-BIT-PREFIX char <HALT -1>
<L1>Sets the printable ASCII character to be used for eighth bit prefixing.
It may be any printable character in the range ASCII 32 to 62 or ASCII 96 TO 126
but it must be different from the control character prefix.
The default value is Ampersand (&) (decimal 38, hex 26).
'Char' may be expressed as an ASCII character (e.g. &), as a decimal value
(e.g. 38) or as a hexadecimal value (e.g. X26). <HALT -1>
<L1>e.g. SET SEND EIGHTH-BIT-PREFIX ! - sets the output packet eighth-bit-prefix
character to exclamation mark. <HALT -1>
<J1651>
 
 
*1750     @ SHOW command help @
 
<L1>SHOW command: <HALT -1>
<L1><TAB 15>Syntax: SHOW <HALT -1>
<L1>Displays the current values of SET parameters, capabilities etc. <HALT -1>
<CASE P1 <>,J60 ESAC>
 
*2000     @ STATISTICS command help @
 
<L1>STATISTICS command: <HALT -1>
<L1><TAB 15>Syntax: STATISTICS <HALT -1>
<L1>Displays statistical information about the most recent file transfer.
<HALT -1>
<CASE P1 <>,J60 ESAC>
 
*9000     @ START-OF-PACKET info @
 
<L>VME I/0 cannot handle the standard Kermit START-OF-PACKET character Hex 01
(decimal 1) so initially the VME Kermit START-OF-PACKET character is set to
Hex 1E (decimal 30). For a Kermit file transfer to work, the START-OF-PACKET
character on the micro Kermit must be set to correspond to the VME Kermit
START-OF-PACKET character. Consult the documentation for the micro Kermit to
find out how to change the START-OF-PACKET character on the micro.<HALT -1>
<L>If the VME Kermit START-OF-PACKET character isn't suitable for the micro
Kermit then the START-OF-PACKET character should be altered on BOTH Kermits.
Appendix 2 of the VME KERMIT User Guide lists the characters that VME I/O
can handle. To change the START-OF-PACKET character on VME Kermit use the
commands SET RECEIVE START-OF-PACKET and SET SEND START-OF-PACKET. HELP is
available for these commands. If you attempt to alter the START-OF-PACKET
character to an unacceptable character you will be notified.
 
*END