home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / iclvme2900 / kmt_help_mtm < prev    next >
Text File  |  2020-01-01  |  27KB  |  812 lines
  1. *@ KERMIT HELP SYSTEM MESSAGE TEXT MODULE @
  2. *@ ====== ==== ====== ======= ==== ====== @
  3.  
  4. *CREATE(KMTHELPMTM)
  5. *PROC(KMTHELPMTM)
  6. *VERSION(101)
  7. *PARAMS(EXP&ICL)
  8. *LINESPLIT(SPACE)
  9.  
  10. *@ N.B. NIL IS ASSUMED TO HAVE A VALUE OF -1 @
  11.  
  12. *1        @ text to validate command for which help required @
  13.  
  14. <CASE P2 STARTS
  15.          <> OR <-1>        THEN J20,   @ no command specified @
  16.          <SERVER>          THEN J250,
  17.          <RECEIVE>         THEN J500,
  18.          <SEND>            THEN J750,
  19.          <HELP>            THEN J1000,
  20.          <EXIT>            THEN J1250,
  21.          <SET>             THEN J1500,
  22.          <SHOW>            THEN J1750,
  23.          <STATISTICS   >   THEN J2000,
  24.          <START-OF-PACKET> THEN J9000  @ not a command, START-OF-PACKET info @
  25.       DEFAULT                   J10    @ invalid command @
  26.  ESAC
  27. >
  28.  
  29. *10        @ invalid command entry @
  30.  
  31. <L1><P2> is not a VME Kermit command.
  32.  
  33. *20        @ no command specified, display menu @
  34.  
  35. <L1>Help is available for the following VME Kermit commands: <HALT -1>
  36. <L1>(n.b. square brackets enclose optional parameters and should
  37. omitted when entering a command.) <L1><HALT -1>
  38. <S3>(1) SERVER <TAB 35>: select Kermit Server mode <HALT -1>
  39. <S3>(2) RECEIVE [VME-filename] <TAB 35>: prepare to receive file <HALT -1>
  40. <TAB 35>[save as VME-filename] <HALT -1>
  41. <S3>(3) SEND VME-filename [dest-filename] : send file <HALT -1>
  42. <TAB 35>[store as dest-filename] <HALT -1>
  43. <S3>(4) HELP [command] [params] <TAB 35>: obtain help <HALT -1>
  44. <TAB 35>[for command or command and parameters] <HALT -1>
  45. <S3>(5) EXIT <TAB 35>: exit from VME Kermit <HALT -1>
  46. <S3>(6) SET param value <TAB 35>: set Kermit parameter <HALT -1>
  47. <S3>(7) SHOW <TAB 35>: show value of all Kermit parameters <HALT -1>
  48. <S3>(8) STATISTICS <TAB 35>: display details of last transfer <HALT -1,J30>
  49.  
  50. *30        @ Select command prompt @
  51.  
  52. <L1>Select command (Enter 1 to 8 or 0 if no further help required): <HALT 40>
  53.  
  54. *40        @ validate response to Select command @
  55.  
  56. <CASE P2 EQUALS
  57.          <0> THEN <>,
  58.          <1> THEN J250,
  59.          <2> THEN J500,
  60.          <3> THEN J750,
  61.          <4> THEN J1000,
  62.          <5> THEN J1250,
  63.          <6> THEN J1500,
  64.          <7> THEN J1750,
  65.          <8> THEN J2000
  66.       DEFAULT     J50
  67.  ESAC
  68. >
  69.  
  70.  
  71. *50        @ invalid response to Select command prompt @
  72.  
  73. <L1>**** Invalid response, please re-select. <HALT -1><J30>
  74.  
  75. *60        @ more help prompt @
  76.  
  77. <L1>Any more help required (YES/NO)? <HALT 70>
  78.  
  79. *70        @ validate more help reply @
  80.  
  81. <CASE P2 STARTS
  82.          <YES> OR <yes> THEN J20,
  83.          <NO>  OR <no>  THEN <>
  84.       DEFAULT         J60
  85.  ESAC
  86. >
  87.  
  88. *250       @ SERVER command help @
  89.  
  90. <L1>SERVER command: <HALT -1>
  91. <L1><TAB 15>Syntax: SERVER <HALT -1>
  92. <L1>The SERVER command selects VME Kermit Server mode. All further commands
  93. are sent to VME Kermit by the user Kermit (running on your micro). File
  94. transfers are initiated via commands given to the micro Kermit. VME Kermit
  95. will remain in Server mode until the user Kermit instructs VME Kermit to exit
  96. to VME command level (after you have issued a FINISH command to the micro
  97. Kermit) or the user Kermit tells VME Kermit to log out (after you have issued
  98. a BYE command to the micro Kermit). <HALT -1>
  99. <L1>WARNING: It is inadvisable to select VME Kermit Server mode if your micro
  100. Kermit doesn't have the following commands for communicating with servers:
  101. GET, BYE and FINISH. If in doubt, consult your documentation. <HALT -1>
  102. <CASE P1 <>,J60 ESAC>
  103.  
  104. *500       @ RECEIVE command help @
  105.  
  106. RECEIVE command: <HALT -1>
  107. <L1><TAB 15>Syntax: RECEIVE [VME-filename] <HALT -1>
  108. <L1>The RECEIVE command prepares VME Kermit for the arrival of a file from
  109. the micro Kermit. If a VME filename is specified, the file will be saved with
  110. this name. If no filename is specified, a filename will be sent by the micro
  111. Kermit and, if possible, the file will be saved with that name. <HALT -1>
  112. <L1>After issuing the RECEIVE command, escape back to the micro Kermit and
  113. initiate the file transfer by entering a SEND command. <HALT -1>
  114. <CASE P1 <>,J60 ESAC>
  115.  
  116. *750       @ SEND command help @
  117.  
  118. <L1>SEND command: <HALT -1>
  119. <L1><TAB 15>Syntax: SEND VME-filename [destination-filename] <HALT -1>
  120. <L1>The VME file is sent to the micro Kermit. If a destination filename
  121. is included, the file will be stored by the micro with this name,
  122. otherwise the VME filename will be used. <HALT -1>
  123. <L1>After issuing the SEND command escape back to the micro Kermit and
  124. prepare the micro for the arrival of the file by issuing a RECEIVE
  125. command. <HALT -1>
  126. <CASE P1 <>,J60 ESAC>
  127.  
  128. *1000      @ HELP command help @
  129.  
  130. <L1>HELP command: <HALT -1>
  131. <L1><TAB 15>Syntax: HELP [command] [parameter(s)]
  132. <L1>The HELP command gives information for the specified command, or allows
  133. the user to request information via a menu. If a command is specified,
  134. it may be qualified by appending parameter names. <HALT -1>
  135. <CASE P1 <>,J60 ESAC>
  136.  
  137. *1250      @ EXIT command help @
  138.  
  139. <L1>EXIT command: <HALT -1>
  140. <L1><TAB 15>Syntax: EXIT <HALT -1>
  141. <L1>The EXIT command terminates the VME Kermit session, closes any logging
  142. files and returns the user to VME command level. <HALT -1>
  143. <CASE P1 <>,J60 ESAC>
  144.  
  145. *1500      @ SET command help @
  146.  
  147. <CASE P3 STARTS
  148.          <> OR <-1>        THEN J1505, @ no parameter specified @
  149.          <DEBUG>           THEN J1520,
  150.          <DELAY>           THEN J1540,
  151.          <PAUSE>           THEN J1560,
  152.          <RETRY>           THEN J1580,
  153.          <FILE>            THEN J1600,
  154.          <SEND>            THEN J1620,
  155.          <RECEIVE>         THEN J1640
  156.       DEFAULT                   J1504  @ invalid parameter @
  157.  ESAC
  158. >
  159.  
  160. *1501      @ SET command help exit @
  161.  
  162. <CASE P1 <>,J1502 ESAC>
  163.  
  164.  
  165. *1502      @ more help prompt @
  166.  
  167. <L1>Any more help required? Select:- <HALT -1>
  168. <S3>(0) No more help <HALT -1>
  169. <S3>(1) More help for this command <HALT -1>
  170. <S3>(2) More help for another command <HALT -1>
  171. <L1>Enter choice (0 to 2): <HALT 1503>
  172.  
  173.  
  174. *1503      @ validate more help response @
  175.  
  176. <CASE P2 EQUALS
  177.          <0> THEN <>,
  178.          <1> THEN J1505,
  179.          <2> THEN J20
  180.       DEFAULT     J1502  @ invalid response, reprompt @
  181.  ESAC
  182. >
  183.  
  184.  
  185. *1504      @ invalid SET parameter @
  186.  
  187. <L1>**** <P3> is not a SET parameter. <HALT -1><J1501>
  188.  
  189. *1505      @ SET command menu @
  190.  
  191. <L1>SET command: <HALT -1>
  192. <L1><TAB 15>Syntax: SET parameter value <HALT -1>
  193. <L1>The SET command establishes or modifies various parameters for file
  194. transfer or logging. <HALT -1>
  195. <L1>The following parameters may be set: <L1><HALT -1>
  196. <S3>(1) DEBUG {FILE/PROTOCOL/PACKET/DEVICE/ALL} {ON/OFF} <HALT -1>
  197. <S3>(2) DELAY seconds <HALT -1>
  198. <S3>(3) PAUSE 10th-seconds <HALT -1>
  199. <S3>(4) RETRY maximum-retries <HALT -1>
  200. <S3>(5) FILE parameter value <HALT -1>
  201. <S3>         TYPE {EBCDIC/ASCII/BINARY} <HALT -1>
  202. <S3>         NAMING {UNTRANSLATED/NORMAL-FORM} <HALT -1>
  203. <S3>         OVERWRITE {ON/OFF} <HALT -1>
  204. <S3>         INCOMPLETE {DISCARD/KEEP} <HALT-1>
  205. <S3>(6) SEND parameter value <HALT -1>
  206. <S3>(7) RECEIVE parameter value <HALT -1>
  207. <S3>            START-OF-PACKET ctl-char <HALT -1>
  208. <S3>            PACKET-LENGTH number <HALT -1>
  209. <S3>            TIMEOUT number <HALT -1>
  210. <S3>            END-OF-LINE ctl-char <HALT -1>
  211. <S3>            PADDING number <HALT -1>
  212. <S3>            PAD-CHARACTER ctl-char <HALT -1>
  213. <S3>            QUOTE char <HALT -1>
  214. <S3>            EIGHTH-BIT-PREFIX char <HALT -1>
  215. <J1506>
  216.  
  217.  
  218. *1506      @ select SET parameter @
  219.  
  220. <L1>For further information enter choice (1 to 7) or 0 if no further
  221. information is required: <HALT 1507>
  222.  
  223.  
  224. *1507      @ validate selection @
  225.  
  226. <CASE P2 EQUALS
  227.          <0> THEN <>,
  228.          <1> THEN J1520,
  229.          <2> THEN J1540,
  230.          <3> THEN J1560,
  231.          <4> THEN J1580,
  232.          <5> THEN J1600,
  233.          <6> THEN J1620,
  234.          <7> THEN J1640
  235.       DEFAULT     J1508  @ invalid selection @
  236.  ESAC
  237. >
  238.  
  239.  
  240. *1508      @ invalid selection @
  241.  
  242. <L1>**** Invalid response, please re-select.<HALT -1><J1506>
  243.  
  244.  
  245. *1520      @ SET DEBUG @
  246.  
  247. <CASE P4 STARTS
  248.          <> OR <-1>  THEN J1525,  @ no parameter specified @
  249.          <FILE>      THEN J1530,
  250.          <PROTOCOL>  THEN J1531,
  251.          <PACKET>    THEN J1532,
  252.          <DEVICE>    THEN J1533,
  253.          <ALL>       THEN J1534
  254.       DEFAULT             J1524   @ invalid parameter @
  255.  ESAC
  256. >
  257.  
  258.  
  259. *1521      @ SET DEBUG command help exit @
  260.  
  261. <CASE P1 <>, J1522 ESAC>
  262.  
  263.  
  264. *1522      @ more help prompt @
  265.  
  266. <L1>Any more help required? Select:- <HALT -1>
  267. <S3>(0) No more help <HALT -1>
  268. <S3>(1) More help for this command <HALT -1>
  269. <S3>(2) More help for another command <HALT -1>
  270. <L1>Enter choice (0 to 2): <HALT 1523>
  271.  
  272.  
  273. *1523      @ validate more help response @
  274.  
  275. <CASE P2 EQUALS
  276.          <0>  THEN <>,
  277.          <1>  THEN J1525,
  278.          <2>  THEN J20
  279.       DEFAULT      J1522      @ invalid response, reprompt @
  280.  ESAC
  281. >
  282.  
  283.  
  284. *1524      @ invalid SET DEBUG parameter @
  285.  
  286. <L1>**** <P4> is not a SET DEBUG parameter.<HALT -1><J1521>
  287.  
  288.  
  289. *1525      @ SET DEBUG command menu @
  290.  
  291. <L1>SET DEBUG: <HALT-1>
  292. <L1><TAB 15>Syntax: SET DEBUG parameter option <HALT -1>
  293. <L1>Sets the various debugging facilities on or off.<HALT -1>
  294. <L1>The following parameters may be set:<L1><HALT -1>
  295. <S3>(1) FILE     {ON/OFF} <HALT -1>
  296. <S3>(2) PROTOCOL {ON/OFF} <HALT -1>
  297. <S3>(3) PACKET   {ON/OFF} <HALT -1>
  298. <S3>(4) DEVICE   {ON/OFF} <HALT -1>
  299. <S3>(5) ALL      {ON/OFF} <HALT -1>
  300. <J1526>
  301.  
  302.  
  303. *1526      @ select SET DEBUG parameter @
  304.  
  305. <L1>For further information enter choice (1 to 5) or 0 if no further
  306. information is required: <HALT 1527>
  307.  
  308.  
  309. *1527      @ validate selection @
  310.  
  311. <CASE P2 EQUALS
  312.          <0>  THEN <>,
  313.          <1>  THEN J1530,
  314.          <2>  THEN J1531,
  315.          <3>  THEN J1532,
  316.          <4>  THEN J1533,
  317.          <5>  THEN J1534
  318.       DEFAULT      J1528      @ invalid selection @
  319.  ESAC
  320. >
  321.  
  322.  
  323. *1528      @ invalid selection @
  324.  
  325. <L1>**** Invalid response, please re-select.<HALT -1><J1526>
  326.  
  327.  
  328. *1530      @ SET DEBUG FILE @
  329.  
  330. <L1>SET DEBUG FILE: <HALT -1>
  331. <L1><TAB 15>Syntax: SET DEBUG FILE option <HALT -1>
  332. <L1>Turns file record tracing on or off. If option is ON then the contents of
  333. all file records read or written will be logged (in hex) to the job journal.
  334. The default is OFF. <HALT -1>
  335. <L1>e.g. SET DEBUG FILE ON - turns on file record tracing. <HALT -1>
  336. <J1521>
  337.  
  338.  
  339. *1531      @ SET DEBUG PROTOCOL @
  340.  
  341. <L1>SET DEBUG PROTOCOL: <HALT -1>
  342. <L1><TAB 15>Syntax: SET DEBUG PROTOCOL option <HALT -1>
  343. <L1>Turns protocol state/event tracing on or off. If option is ON then the
  344. internal states and events of the protocol handler will be logged to the job
  345. journal. The default is OFF. <HALT -1>
  346. <L1>e.g. SET DEBUG PROTOCOL ON - turns on protocol state/event tracing.<HALT -1>
  347. <J1521>
  348.  
  349.  
  350. *1532      @ SET DEBUG PACKET @
  351.  
  352. <L1>SET DEBUG PACKET: <HALT -1>
  353. <L1><TAB 15>Syntax: SET DEBUG PACKET option <HALT -1>
  354. <L1>Turns packet tracing on or off. If option is ON then the contents of all
  355. packets sent and received will be logged to the job journal. The
  356. default is OFF. <HALT -1>
  357. <L1>e.g. SET DEBUG PACKET ON - turns on packet tracing. <HALT -1>
  358. <J1521>
  359.  
  360.  
  361. *1533      @ SET DEBUG DEVICE @
  362.  
  363. <L1>SET DEBUG DEVICE: <HALT -1>
  364. <L1><TAB 15>Syntax: SET DEBUG DEVICE option <HALT -1>
  365. <L1>Turns device tracing on or off. If option is ON then all the data sent and
  366. received over the terminal link will be logged (in hex) to the job journal. The
  367. default is OFF. <HALT -1>
  368. <L1>e.g. SET DEBUG DEVICE ON - turns on device tracing. <HALT -1>
  369. <J1521>
  370.  
  371.  
  372. *1534      @ SET DEBUG ALL @
  373.  
  374. <L1>SET DEBUG ALL: <HALT -1>
  375. <L1><TAB 15>Syntax: SET DEBUG ALL option <HALT -1>
  376. <L1>Turns all tracing on or off. If option is ON then the contents of all file
  377. records read or written, the internal states and events of the protocol handler,
  378. the contents of all packets sent and received and all the data sent and
  379. received over the terminal link will be logged to the job journal. The default
  380. is OFF. <HALT -1>
  381. <L1>e.g. SET DEBUG ALL ON - turns on all tracing. <HALT -1>
  382. <J1521>
  383.  
  384.  
  385. *1540      @ SET DELAY @
  386.  
  387. <L1>SET DELAY: <HALT -1>
  388. <L1><TAB 15>Syntax: SET DELAY seconds <HALT -1>
  389. <L1>Sets the length of delay before transmitting the first packet after
  390. a SEND command has been issued. The default delay is 30 seconds. The
  391. minimum delay that can be set is 5 seconds and the maximum is 300
  392. seconds. Seconds may be expressed as a decimal value (e.g. 9) or as a
  393. hexadecimal value (e.g. X09). <HALT -1>
  394. <L1>e.g. SET DELAY 15 - sets the delay period to 15 seconds. <HALT -1>
  395. <J1501>
  396.  
  397.  
  398. *1560      @ SET PAUSE @
  399.  
  400. <L1>SET PAUSE: <HALT -1>
  401. <L1><TAB 15>Syntax: SET PAUSE 10ths-second <HALT -1>
  402. <L1>Sets the length of time to pause between receiving a packet from the remote
  403. system and transmitting the next packet to it. The default pause is 0 tenths
  404. of a second. The maximum pause that can be set is 50 tenths of a second.
  405. 10ths-second may be expressed as a decimal value (e.g. 9) or as a hexadecimal
  406. value (e.g. X09). <HALT -1>
  407. <L1>e.g. SET PAUSE 10 - sets the pause period to 10 tenths of a second.<HALT -1>
  408. <J1501>
  409.  
  410.  
  411. *1580      @ SET RETRY @
  412.  
  413. <L1>SET RETRY: <HALT -1>
  414. <L1><TAB 15>Syntax: SET RETRY number <HALT -1>
  415. <L1>Sets the maximum number of times to attempt to send or receive a packet
  416. before abandoning the transfer. The default retry is 4. The maximum retry that
  417. can be set is 10. Number may be expressed as a decimal value (e.g. 4) or as a
  418. hexadecimal value (e.g. X04). <HALT -1>
  419. <L1>e.g. SET RETRY 8 - sets the retry limit to 8 retries. <HALT -1>
  420. <J1501>
  421.  
  422.  
  423. *1600      @ SET FILE @
  424.  
  425. <CASE P4 STARTS
  426.          <> OR <-1>    THEN J1605,  @ no parameter specified @
  427.          <TYPE>        THEN J1610,
  428.          <NAMING>      THEN J1611,
  429.          <OVERWRITE>   THEN J1612,
  430.          <INCOMPLETE>  THEN J1613
  431.       DEFAULT               J1604   @ invalid parameter @
  432.  ESAC
  433. >
  434.  
  435.  
  436. *1601      @ SET FILE command help exit @
  437.  
  438. <CASE P1 <>, J1602 ESAC>
  439.  
  440.  
  441. *1602      @ more help prompt @
  442.  
  443. <L1>Any more help required? Select:- <HALT -1>
  444. <S3>(0) No more help <HALT -1>
  445. <S3>(1) More help for this command <HALT -1>
  446. <S3>(2) More help for another command <HALT -1>
  447. <L1>Enter choice (0 to 2): <HALT 1603>
  448.  
  449.  
  450. *1603      @ validate more help response @
  451.  
  452. <CASE P2 EQUALS
  453.          <0>  THEN <>,
  454.          <1>  THEN J1605,
  455.          <2>  THEN J20
  456.       DEFAULT      J1602      @ invalid response, reprompt @
  457.  ESAC
  458. >
  459.  
  460.  
  461. *1604      @ invalid SET FILE parameter @
  462.  
  463. <L1>**** <P4> is not a SET FILE parameter.<HALT -1><J1601>
  464.  
  465.  
  466. *1605      @ SET FILE command menu @
  467.  
  468. <L1>SET FILE: <HALT-1>
  469. <L1><TAB 15>Syntax: SET FILE parameter option <HALT -1>
  470. <L1>Sets the various file attributes.<HALT -1>
  471. <L1>The following parameters may be set:<L1><HALT -1>
  472. <S3>(1) TYPE       {EBCDIC/ASCII/BINARY} <HALT -1>
  473. <S3>(2) NAMING     {UNTRANSLATED/NORMAL-FORM} <HALT -1>
  474. <S3>(3) OVERWRITE  {ON/OFF} <HALT -1>
  475. <S3>(4) INCOMPLETE {DISCARD/KEEP} <HALT -1>
  476. <J1606>
  477.  
  478.  
  479. *1606      @ select SET FILE parameter @
  480.  
  481. <L1>For further information enter choice (1 to 4) or 0 if no further
  482. information is required: <HALT 1607>
  483.  
  484.  
  485. *1607      @ validate selection @
  486.  
  487. <CASE P2 EQUALS
  488.          <0>  THEN <>,
  489.          <1>  THEN J1610,
  490.          <2>  THEN J1611,
  491.          <3>  THEN J1612,
  492.          <4>  THEN J1613
  493.       DEFAULT      J1608      @ invalid selection @
  494.  ESAC
  495. >
  496.  
  497.  
  498. *1608      @ invalid selection @
  499.  
  500. <L1>**** Invalid response, please re-select.<HALT -1><J1606>
  501.  
  502.  
  503. *1610      @ SET FILE TYPE @
  504.  
  505. <L1>SET FILE TYPE: <HALT -1>
  506. <L1><TAB 15>Syntax: SET FILE TYPE option <HALT -1>
  507. <L1>Defines the type of file to be sent, or received.
  508. option may be one of: <HALT -1>
  509. <S3>EBCDIC meaning that the VME file contains, or is to contain EBCDIC <HALT -1>
  510. <S3>       text and data conversion between EBCDIC and ASCII is <HALT -1>
  511. <S3>       required. <HALT -1>
  512. <S3>ASCII  meaning that the VME file contains, or is to contain ASCII <HALT -1>
  513. <S3>       text and no data conversion is required. <HALT -1>
  514. <S3>BINARY meaning that the VME file contains, of is to contain binary <HALT -1>
  515. <S3>       data and no data conversion is required. Note in this case <HALT -1>
  516. <S3>       the record boundaries of the VME file are not significant <HALT -1>
  517. <S3>       to KERMIT. <HALT -1>
  518. The default is EBCDIC. <HALT -1>
  519. <L1>e.g. SET FILE TYPE BINARY - sets file transfer is to be binary.<HALT -1>
  520. <J1601>
  521.  
  522.  
  523. *1611      @ SET FILE NAMING @
  524.  
  525. <L1>SET FILE NAMING: <HALT -1>
  526. <L1><TAB 15>Syntax: SET FILE NAMING option <HALT -1>
  527. <L1>Defines how file names are to represented/interpretted. If option is
  528. NORMAL-FORM then the VME and remote file names will be normalised. If option is
  529. UNTRANSLATED then no file name normalisation will take place. The default is
  530. NORMAL-FORM. <HALT -1>
  531. <L1>e.g. SET FILE NAMING UNTRANSLATED - turns off file name normalisation.
  532. <HALT -1>
  533. <J1601>
  534.  
  535.  
  536. *1612      @ SET FILE OVERWRITE @
  537.  
  538. <L1>SET FILE OVERWRITE: <HALT -1>
  539. <L1><TAB 15>Syntax: SET FILE OVERWRITE option <HALT -1>
  540. <L1>Defines the action to be taken when receiving a file and a VME file of the
  541. same name and generation number already exists. If option is ON then the file
  542. will be overwritten. If option is OFF then the file transfer will abandoned.
  543. The default is OFF. <HALT -1>
  544. <L1>e.g. SET FILE OVERWRITE ON - incoming file will be overwritten if it already
  545. exists. <HALT -1>
  546. <J1601>
  547.  
  548.  
  549. *1613      @ SET FILE INCOMPLETE @
  550.  
  551. <L1>SET FILE INCOMPLETE: <HALT -1>
  552. <L1><TAB 15>Syntax: SET FILE INCOMPLETE option <HALT -1>
  553. <L1>Defines the action to be taken when receiving a file and the file transfer
  554. is abandoned. If option is KEEP then the VME file will be saved. If option is
  555. DISCARD then the VME file will not be saved. <HALT -1>
  556. <L1>e.g. SET FILE INCOMPLETE KEEP - file to be saved if transfer abandoned.
  557. <HALT -1>
  558. <J1601>
  559.  
  560.  
  561. *1620      @ SET SEND @
  562.  
  563. <J1650>
  564.  
  565.  
  566. *1640      @ SET RECEIVE @
  567.  
  568. <J1650>
  569.  
  570.  
  571. *1650      @ SET SEND/RECEIVE @
  572.  
  573. <CASE P4 STARTS
  574.          <> OR <-1>          THEN J1655,  @ no parameter specified @
  575.          <START-OF-PACKET>   THEN J1660,
  576.          <PACKET-LENGTH>     THEN J1661,
  577.          <TIMEOUT>           THEN J1662,
  578.          <END-OF-LINE>       THEN J1663,
  579.          <PADDING>           THEN J1664,
  580.          <PAD-CHARACTER>     THEN J1665,
  581.          <QUOTE>             THEN J1666,
  582.          <EIGHTH-BIT-PREFIX>  THEN J1667
  583.       DEFAULT                     J1654   @ invalid parameter @
  584.  ESAC
  585. >
  586.  
  587.  
  588. *1651      @ SET SEND/RECEIVE command help exit @
  589.  
  590. <CASE P1 <>, J1652 ESAC>
  591.  
  592.  
  593. *1652      @ more help prompt @
  594.  
  595. <L1>Any more help required? Select:- <HALT -1>
  596. <S3>(0) No more help <HALT -1>
  597. <S3>(1) More help for this command <HALT -1>
  598. <S3>(2) More help for another command <HALT -1>
  599. <L1>Enter choice (0 to 2): <HALT 1653>
  600.  
  601.  
  602. *1653      @ validate more help response @
  603.  
  604. <CASE P2 EQUALS
  605.          <0>  THEN <>,
  606.          <1>  THEN J1655,
  607.          <2>  THEN J20
  608.       DEFAULT      J1652      @ invalid response, reprompt @
  609.  ESAC
  610. >
  611.  
  612.  
  613. *1654      @ invalid SET SEND/RECEIVE parameter @
  614.  
  615. <L1>**** <P4> is not a SET SEND/RECEIVE parameter.<HALT -1><J1651>
  616.  
  617.  
  618. *1655      @ SET SEND/RECEIVE command menu @
  619.  
  620. <L1>SET SEND/RECEIVE: <HALT-1>
  621. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} parameter option <HALT -1>
  622. <L1>Sets the various configuration parameters to allow the tailoring of
  623. dissimilar systems to accomodate the peculiarities of the communication path.
  624. Note a number of the configuration parameters may be modified during the
  625. exchange of S or I packets and the acknowledgements to those packets. <HALT -1>
  626. <L1>The following parameters may be set:<L1><HALT -1>
  627. <S3>(1) START-OF-PACKET ctl_char <HALT -1>
  628. <S3>(2) PACKET-LENGTH number <HALT -1>
  629. <S3>(3) TIMEOUT seconds <HALT -1>
  630. <S3>(4) END-OF-LINE ctl-char <HALT -1>
  631. <S3>(5) PADDING number <HALT -1>
  632. <S3>(6) PAD-CHARACTER ctl-char <HALT -1>
  633. <S3>(7) QUOTE char <HALT -1>
  634. <S3>(8) EIGHTH-BIT-PREFIX char <HALT -1>
  635. <J1656>
  636.  
  637.  
  638. *1656      @ select SET SEND/RECEIVE parameter @
  639.  
  640. <L1>For further information enter choice (1 to 8) or 0 if no further
  641. information is required: <HALT 1657>
  642.  
  643.  
  644. *1657      @ validate selection @
  645.  
  646. <CASE P2 EQUALS
  647.          <0>  THEN <>,
  648.          <1>  THEN J1660,
  649.          <2>  THEN J1661,
  650.          <3>  THEN J1662,
  651.          <4>  THEN J1663,
  652.          <5>  THEN J1664,
  653.          <6>  THEN J1665,
  654.          <7>  THEN J1666,
  655.          <8>  THEN J1667
  656.       DEFAULT      J1658      @ invalid selection @
  657.  ESAC
  658. >
  659.  
  660.  
  661. *1658      @ invalid selection @
  662.  
  663. <L1>**** Invalid response, please re-select.<HALT -1><J1656>
  664.  
  665.  
  666. *1660      @ SET SEND/RECEIVE START-OF-PACKET @
  667.  
  668. <L1>SET SEND/RECEIVE START-OF-PACKET: <HALT -1>
  669. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} START-OF-PACKET ctl-char <HALT -1>
  670. <L1>Sets the ASCII control character to be used as the start-of-packet marker.
  671. The default is Record Separator (decimal 30, hex 1E). 'Ctl-char' may be
  672. expressed as a decimal value (e.g. 30) or as a hexadecimal value (e.g. X1E).
  673. Note a number of control characters are not accepted by VME as valid
  674. start-of-packet markers. <HALT -1>
  675. <L1>e.g. SET SEND START-OF-PACKET X1F - sets the start-of-packet marker for
  676. output packets to Unit Separator. <HALT -1>
  677. <J1651>
  678.  
  679.  
  680. *1661      @ SET SEND/RECEIVE PACKET-LENGTH @
  681.  
  682. <L1>SET SEND/RECEIVE PACKET-LENGTH: <HALT -1>
  683. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} PACKET-LENGTH number <HALT -1>
  684. <L1>Sets the maximum length for a packet. The maximum packet-length plus the
  685. padding (if any) must not exceed the limits of the VME terminal description
  686. (normally 80 for output and 128 for input). The default packet-length is 80
  687. characters. The minimum packet-length that can be set is 30 characters and the
  688. maximum is defined by the terminal description (normally 80 for output and 94
  689. for input). 'Number' may be expressed as a decimal value (e.g. 80) or as a
  690. hexadecimal value (e.g. X50). <HALT -1>
  691. <L1>e.g. SET RECEIVE PACKET-LENGTH 72 - sets the maximum packet-length of input
  692. packets to 72 characters. <HALT -1>
  693. <J1651>
  694.  
  695.  
  696. *1662      @ SET SEND/RECEIVE TIMEOUT @
  697.  
  698. <L1>SET SEND/RECEIVE TIMEOUT: <HALT -1>
  699. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} TIMEOUT seconds <HALT -1>
  700. <L1>Sets the length of time to wait for a packet to arrive. The default is 0
  701. seconds i.e. indefinite wait. The maximum timeout that can be set is 94 seconds.
  702. 'Seconds' may be expressed as a decimal value (e.g. 20) or as a hexadecimal
  703. value (e.g. X14). <HALT -1>
  704. <L1>e.g. SET RECEIVE TIMEOUT 20 - sets the timeout value for input packets to 20
  705. seconds. <HALT -1>
  706. <J1651>
  707.  
  708.  
  709. *1663      @ SET SEND/RECEIVE END-OF-LINE @
  710.  
  711. <L1>SET SEND/RECEIVE END-OF-LINE: <HALT -1>
  712. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} END-OF-LINE ctl-char <HALT -1>
  713. <L1>Sets the ASCII control character to be used as the end of packet terminator.
  714. The default is Carriage Return (decimal 13, hex 0D). 'Ctl-char' may be expressed
  715. as a decimal value (e.g. 13) or as a hexadecimal value (e.g. X0D). Note a number
  716. of control characters are not accepted by VME as valid end-of-line terminators.
  717. <HALT -1>
  718. <L1>e.g. SET RECEIVE END-OF-LINE X09 - sets the input packet end-of-line
  719. terminator to Tab. <HALT -1>
  720. <J1651>
  721.  
  722.  
  723. *1664      @ SET SEND/RECEIVE PADDING @
  724.  
  725. <L1>SET SEND/RECEIVE PADDING: <HALT -1>
  726. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} PADDING number <HALT -1>
  727. <L1>Sets the number of padding characters to be sent before each packet. The
  728. padding plus the maximum packet length must not exceed the limits of the VME
  729. terminal description (normally 80 for output and 128 for input). The default
  730. padding is 0 characters i.e. no padding. The maximum padding that can be set is
  731. defined by the VME terminal description. <HALT -1>
  732. <L1>e.g. SET SEND PADDING 4 - sets the padding for output packets to 4 pad
  733. characters. <HALT -1>
  734. <J1651>
  735.  
  736.  
  737. *1665      @ SET SEND/RECEIVE PAD-CHARACTER @
  738.  
  739. <L1>SET SEND/RECEIVE PAD-CHARACTER: <HALT -1>
  740. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} PAD-CHARACTER ctl-char <HALT -1>
  741. <L1>Sets the ASCII control character to be used as a pad character to be sent
  742. before each packet. The default is Null (decimal 0, hex 00). 'Ctl-char' may be
  743. expressed as a decimal value (e.g. 0) or as a hexadecimal value (e.g X00).
  744. Note a number of the control characters are not accepted by VME as valid pad
  745. characters. <HALT -1>
  746. <L1>e.g. SET SEND PAD-CHARACTER 7 - sets the output packet pad character to
  747. Bell. <HALT -1>
  748. <J1651>
  749.  
  750.  
  751. *1666      @ SET SEND/RECEIVE QUOTE @
  752.  
  753. <L1>SET SEND/RECEIVE QUOTE: <HALT -1>
  754. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} QUOTE char <HALT -1>
  755. <L1>Sets the printable ASCII character to be used for control character
  756. prefixing. It may be any printable character but it must be different from the
  757. eighth-bit-prefix character. The default value is Hash (#) (decimal 35, hex 23).
  758. 'Char' may be expressed as an ASCII character (e.g. #), as a decimal value
  759. (e.g. 35) or as a hexadecimal value (e.g. X23). <HALT -1>
  760. <L1>e.g. SET SEND QUOTE ? - sets the output packet quote character to question
  761. mark. <HALT -1>
  762. <J1651>
  763.  
  764.  
  765. *1667      @ SET SEND/RECEIVE EIGHTH-BIT-PREFIX @
  766.  
  767. <L1>SET SEND/RECEIVE EIGHTH-BIT-PREFIX: <HALT -1>
  768. <L1><TAB 15>Syntax: SET {SEND/RECEIVE} EIGHTH-BIT-PREFIX char <HALT -1>
  769. <L1>Sets the printable ASCII character to be used for eighth bit prefixing.
  770. It may be any printable character in the range ASCII 32 to 62 or ASCII 96 TO 126
  771. but it must be different from the control character prefix.
  772. The default value is Ampersand (&) (decimal 38, hex 26).
  773. 'Char' may be expressed as an ASCII character (e.g. &), as a decimal value
  774. (e.g. 38) or as a hexadecimal value (e.g. X26). <HALT -1>
  775. <L1>e.g. SET SEND EIGHTH-BIT-PREFIX ! - sets the output packet eighth-bit-prefix
  776. character to exclamation mark. <HALT -1>
  777. <J1651>
  778.  
  779.  
  780. *1750     @ SHOW command help @
  781.  
  782. <L1>SHOW command: <HALT -1>
  783. <L1><TAB 15>Syntax: SHOW <HALT -1>
  784. <L1>Displays the current values of SET parameters, capabilities etc. <HALT -1>
  785. <CASE P1 <>,J60 ESAC>
  786.  
  787. *2000     @ STATISTICS command help @
  788.  
  789. <L1>STATISTICS command: <HALT -1>
  790. <L1><TAB 15>Syntax: STATISTICS <HALT -1>
  791. <L1>Displays statistical information about the most recent file transfer.
  792. <HALT -1>
  793. <CASE P1 <>,J60 ESAC>
  794.  
  795. *9000     @ START-OF-PACKET info @
  796.  
  797. <L>VME I/0 cannot handle the standard Kermit START-OF-PACKET character Hex 01
  798. (decimal 1) so initially the VME Kermit START-OF-PACKET character is set to
  799. Hex 1E (decimal 30). For a Kermit file transfer to work, the START-OF-PACKET
  800. character on the micro Kermit must be set to correspond to the VME Kermit
  801. START-OF-PACKET character. Consult the documentation for the micro Kermit to
  802. find out how to change the START-OF-PACKET character on the micro.<HALT -1>
  803. <L>If the VME Kermit START-OF-PACKET character isn't suitable for the micro
  804. Kermit then the START-OF-PACKET character should be altered on BOTH Kermits.
  805. Appendix 2 of the VME KERMIT User Guide lists the characters that VME I/O
  806. can handle. To change the START-OF-PACKET character on VME Kermit use the
  807. commands SET RECEIVE START-OF-PACKET and SET SEND START-OF-PACKET. HELP is
  808. available for these commands. If you attempt to alter the START-OF-PACKET
  809. character to an unacceptable character you will be notified.
  810.  
  811. *END
  812.