The available Kermit-Bur commands are: SET - SHOW(STAtus)- RECEIVE - SEND - SERVER - EXIT. Some commands may be abbreviated. All necessary characters of a command are printed in capitals. For more information type HELP . The SET-command. --- ------------ The SET-command is necessary to set the FILEKIND of the file to be received from the PC and because some Kermits need other settings than the default values of Kermit-Bur. The default setting is: FILE TYPE DATA RECORDLENGTH 80 CHARACTERS RECEIVE DIRECTORY: not specified SEND DIRECTORY: not specified DELAY: 5 seconds DEBUG: OFF EXTENSION: OFF SEND EOL: CR (carriage return) SEND PAKLEN: 94 SEND QUOTE: # SEND SOP: SOH (Start Of Header) SEND TIMEOUT: 15 No SEND PADDING Syntax : --SET--+--FILE--TYPE--+--BINary--+--RECordlength---< integer >-+--- | | | | | +---DATa---+-----------------------------+ | | | | +------------------------------+ | | +--RECeive--DIRectory---+-----------------+-------------+ | | | | | +--< directory >--+ | | | +--DELAY----------< integer >---------------------------+ | | +--DEBUG--------+--ON--+--------------------------------+ | | | | | +--OFF-+ | | | +--EXTension----+--ON--+--------------------------------+ | | | | | +--OFF-+ | | | +--SEND--+----DIRectory--+-----------------+------------+ | | | | | +--< directory >--+ | | | +----EOL---------< integer >-------------------+ | | +----PAKLEN------< integer >-------------------+ | | +----QUOTE--------------------------+ | | +----SOP---------< integer >-------------------+ | | +----TIMEOUT-----< integer >-------------------+ | | +--PADDING----PADCHAR--------+ SET FILE TYPE BINary : Kermit-Bur will do binary transport if the local Kermit agrees. When sending a file to the PC, the FILEKIND of that file must be DATA. When receiving a file from the PC, the FILEKIND of that file will be DATA. If no recordlength is specified, the MAXRECSIZE of the file to be received from the PC will be 128 bytes, otherwise the specified length in bytes. There will be no translation from ASCII-code to EBCDIC- code. When receiving code-files from the PC, one is advised to choose a wise recordlength. The last record is filled up with NUL's (48"00"); so to avoid trailing NUL's, your code file should be a multiple of the choosen recordlength. SET FILE TYPE DATa : When receiving a file from the PC, the FILEKIND of that file will be DATA. If no recordlength is specified, the MAXRECSIZE of the file to be received from the PC will be 80 characters, otherwise the specified length in characters. When the SET-command isn't used , this is the default situation. SET FILE TYPE : When receiving a file from the PC, the FILEKIND of that file will be the specified filekind. The file-attributes are set according to the CANDE- requirements. ::= ALGol | PL/i | COBol | FORtran | BASic | JOB | PAScal | SEQ | CSEq | CDAta SET RECeive DIRectory : When a directory is specified, the files, received by Kermit-Bur, are stored in that directory. When no directory is mentioned, Kermit-Bur stores received files as explained in the RECEIVE-command. This is the default situation. e.g. SET REC DIR KERMIT The file with filename TEST, received by Kermit-Bur is stored with TITLE KERMIT/TEST. SET DELAY : is an integer value in the range 0 through 30. It represents the time (in seconds) that Kermit-Bur will wait before sending the first packet. The defaultvalue is 5. SET DEBUG ON : a printerfile is created for logging/statistics. The defaultvalue is OFF (no printerfile). SET EXTension ON : When receiving a file on your PC, Kermit-Bur creates a filename that consists of the last identifier of the TITLE of the Burroughs-file, followed by a period, followed by the first three letters of the FILEKIND of the Burroughs-file. e.g. When your PC receives the Burroughs-file with TITLE KERMIT/RECORDS/NEW and FILEKIND DATA, the filename will be NEW.DAT. When EXTENSION is OFF (default), the filename of the file to be received on your PC will be: if the TITLE of the Burroughs-file consists of only one identifier, that identifier. if the TITLE of the Burroughs-file consists of two ore more identifiers, the last identifier but one of the Burroughs-file, followed by a period, followed by the first three letters/digits of the last identifier of the Burroughs-file. e.g. When your PC receives the Burroughs-file with TITLE KERMIT/RECORDS, the filename will be KERMIT.REC. Naturally the actual filename on your PC depends upon the filename-conventions on your local machine. SET SEND : are the following parameters, which are described below. DIRectory : When a directory is specified, files send by Kermit-Bur are retrieved in that directory. e.g. SET SEND DIR KERMIT SEND TEST Kermit-Bur looks for a file with TITLE KERMIT/TEST. When no directory is specified, Kermit-Bur looks for the actual TITLE given in the SEND- command. This is the default situation. EOL : is an integer value (decimal value of the ASCII-code). It represents the end of line character to be used as a line terminator for packets, if one is required by the local Kermit, carriage return (CR) by default. Only LF (10) or CR (13) is accepted. e.g. SET SEND EOL 13 PAKLEN : is an integer value in the range 10 through 94. It represents the maximum packetlength to send. The defaultvalue is 94. e.g. SET SEND PAKLEN 90 QUOTE : is a printable character (decimal value in the ASCII-range: 33 through 61, except 38 (&)). It represents the quoting-character the local Kermit requires for control-characters. A control-character is considered to be any byte whose value is in the range 0 through 31, or equal to 127 (decimal value off the ASCII- code). When a control-character appears in a file to send, it is changed in a printable representation (increased by 64 mod 128) and preceeded by the QUOTE-character. The defaultvalue is an # and there should be no reason to change this. e.g. SET SEND QUOTE # SOP : is an integer value (decimal value off the ASCII- code). It represents the Start-Of-Packet character the local Kermit requires. The defaultvalue is SOH (Start-Of-Header, decimal value 1). If this character causes problems, you can use this command to select a different control-character to mark the start of a packet. You must also issue the reciprocal command (SET RECEIVE SOP) to the Kermit on the other system (providing it has such a command). e.g. SET SEND SOP 1 TIMEOUT : is a positive integer value (maximum 90). It tells how many seconds the local Kermit will wait for a packet before trying again. The default value is 15. e.g. SET SEND TIMEOUT 10 PADDING PADCHAR : Two integer values. repre- sents the number of padding-characters (maximum 20) and represents the padding-character (decimal value off the ASCII-code). must be a control-character. They should be send before sending each packet to the other Kermit. The default values are 0 (no padding) and NUL (0) for the padding-character. e.g. SET SEND PADDING 0 PADCHAR 0 Caution: The values of EOL, QUOTE, SOP and PADCHAR must be distinct. The SHOW-command. --- ------------- Syntax: SHOW STAtus The SHOW-command will display the values of the settings mentioned in the SET-command. The RECEIVE-command. --- ---------------- Syntax : RECEIVE Receives a file or filegroup from the other Kermit. In the filename a period is replaced by a slash and special characters, which are prohibit in Burroughs-files, are replaced by "X". If an incoming filename already exists, then the filename is extended with (the integer is in the range 01 through 99) and Kermit-Bur writes a warning to a permanent disk file (TITLE : KERMIT/WARNINGS). With the SET-command you can specify the FILEKIND of the file(s) to be received. The SEND-command. --- ------------- Syntax : ---SEND---|---< filename >----------------------|---- | | |---< directory >----- < /=> ---------| Send a file or filegroup to the other Kermit. To transfer more files within one SEND-command you must use a directory. In Kermit-Bur multiple file transfer is implemented as the transfer of all the files in one directory. e.g. SEND KERMIT/TEXT , SEND KERMIT/= The SERVER-command. --- --------------- Syntax: SERVER When giving the SERVER-command you set Kermit-Bur in a special mode the so called SERVER-mode. You must still connect to the B7900 to log-in and start the SERVER with the SERVER-command, but you no longer have to tell one side to SEND and the other to RECEIVE. After giving the SERVER-command you escape back to the local Kermit and do as many SEND- and RECEIVE-operations as you like. For receiving files you use the local GET-command (if implemented). To shut down the SERVER you have to give a local FINISH-command (a so called generic command), after which Kermit-Bur waits for your next command. If you want to finish the Kermit-session, you have to CONNECT again, issue the EXIT-command to Kermit-Bur and log-out from the Burroughs host. At the moment the FINISH-command is the only implemented generic command. The available local commands can be found in your local Kermit User Guide. The EXIT-command. --- ------------- Syntax: EXIT To terminate Kermit (i.e. to halt & close). The HELP-command. --- ------------- Syntax : ---- HELP----|----------------------------|------- | | |---< Kermit-Bur command >---| HELP gives a survey of the possible commands. HELP gives the information of the specified command. e.g. HELP, HELP RECEIVE