-? The following HELP topics are available: ? ! DIRECTORY EXIT HELP KERMIT PUSH QUIT RECEIVE SEND SERVER SET SHOW STATUS TAKE WILDCARDS -KERMIT KERMIT Kermit is a file transfer protocol for use over an asynchronous serial telecommunication line. Files are broken up into "packets" with checksums and other control information to ensure (with high probability) error-free and complete transmission. Kermit-170 is the implementation for the Control Data Cyber and is run "remotely" from another computer (e.g. a microcomputer). You can run Kermit interactively by typing repeated commands in response to its "Kermit-170>" prompt, or you can run it as a remote server. Kermit-170 command summary -- optional parts are in [brackets]: * For exchanging files: SEND file RECEIVE * For acting as a server: SERVER * Setting nonstandard transmission and file parameters: SET DEBUG, DELAY, DUPLEX, INIT-RETRY, RETRY, TEXT-MODE SET BIN-MODE, EOR-EOF-MODE SET SEND (or RECEIVE) End-of-Line, Packet-length, Pad-Character, Pad-Length, Quote-Character, Sync-Character, Time-Out * Getting information: DIR [filenam], HELP [topic], STATUS, SHOW * Leaving the program: EXIT, QUIT For further information, type HELP for any of the above, e.g. HELP SET, or see the "Kermit Users Guide" and the "Kermit Protocol Manual" for complete details. -WILDCARDS Cyber Kermit allows a group of files to be specified in a single file specification by including the special "wildcard" characters, "*" and "?". A "*" matches any string of characters, including no characters at all; a "?" matches any single character. Any number of "*" and "?" may appear in a wildcard specification. To complement the selection criteria, suffix a "-" to the wildcard specification. Here are some examples: *BUG All files ending in BUG. *DOG* All file names containing DOG. F* All files whose names start with F. F?X* All files whose names start with F and contain X in the third posi- tion, followed by zero or more characters. FRED- All files except FRED. Wildcard notation is most commonly used to instruct Kermit to send, or display a directory of, a group of files. Its usage is similar to capabilities on many other computer systems. -! ! command Execute a NOS command and then return to Kermit. Note that a single space must follow the ! character. Cyber Kermit supplies a control statement terminator if needed. -DIRECTORY DIRECTORY [filename] Displays the names of the files local to the user's job, or the names of files in the user's permanent file catalog; filename may be a wildcard filename. If the command is specified with no parameters or the L: parameter, all local files are listed. If the P: parameter is used, all per- manent files are listed. To list a single local file or subset of local files, the user may specify a file name or wildcard file name. To list a single or sub- set of permanent files, the user may precede the file name or wildcard file name by P: [The above syntax is also applicable to the REMOTE DIRECTORY server command.] -EXIT EXIT Exit from Kermit-170. You may also stop Kermit-170 in the midst of a transfer or during server operations by aborting your local Kermit with a CTRL-C. Connect to the Cyber Kermit (don't forget to first FINISH if you were using the Cyber Kermit in server mode) and then EXIT. -QUIT QUIT Exit from Kermit-170. You may also stop Kermit-170 in the midst of a transfer or during server operations by aborting your local Kermit with a CTRL-C. Connect to the Cyber Kermit (don't forget to first FINISH if you were using the Cyber Kermit in server mode) and then EXIT. -HELP HELP [topic] Give Help. A general help text, and separate help texts for each Kermit-170 command, are available. HELP ? lists the available topics. -PUSH PUSH Exit to NOS command level, saving the current Kermit environment. The environment is restored when Kermit is reentered later. -RECEIVE RECEIVE Receive a file or group of files from the other host. If the name in the header packet is not a legal Cyber file name, the first 7 legal characters are used. If the file already exits as a local file, Kermit aborts the trans- fer. If an error occurs during transfer, the local file being received is deleted to allow the transfer to be retried. After entering the RECEIVE command, you should escape back to your local Kermit and enter the SEND command. -SEND SEND filename or L:filename or P:filename Send one or more files to the local (micro) Kermit; filename may be a wildcard filename. The name of each file is passed to the other Kermit in a file header packet, so that the file can be stored there with the same name. You should escape back to your local Kermit and enter the RECEIVE command. If you don't do this fast enough the "send-init" packet may arrive prematurely. To prevent this, use SET DELAY or hit the RETURN key on your microcomputer if it does not timeout. If you use the first form of this command and no local file(s) match your request, your permanent file catalog is searched for matching file(s). If you prefix the filename with L:, only your local files are searched; if P:, only your permanent file catalog is searched. (Note that for a permanent file transfer, any local file which has the same name as a permanent file being sent, is deleted.) -SERVER SERVER Act as a server for another Kermit. Whatever options were previously SET are used. The server may be shut down from the local Kermit by using the BYE, LOGOUT or FINISH commands. FINISH ter- minates the Cyber Kermit program, but does not log out. Most often, you should use the FINISH command if you are transferring a file to the Cyber so that you may then connect and make the file permanent. The BYE or LOGOUT command causes Cyber Kermit to terminate and logout; it may be used, for example, when a file is to be received from the Cyber and no other work is to be done on the Cyber. The following server features are currently supported in Kermit-170: GET, SEND, FINISH, BYE, REM DIR -SET SET keyword value Establish system-dependent parameters. You can examine their values with the SHOW command. Numeric values may be decimal, octal (postfixed with a B), or hexadecimal (postfixed by an H). The fol- lowing may be SET: BIN-MODE btype Indicates how binary files are stored. Allowable values for btype are: 8/12 and PACKED. The setting of BIN-MODE is used when FILE-MODE is BINARY. TEXT-MODE ctype Sets the character set of TEXT files. Allowable values for ctype are: AUTO, DISPLAY, 6/12, and 8/12. The setting of TEXT-MODE is used when FILE-MODE is TEXT. DEBUG option Show packet traffic explicitly. Options are: ALL Set all debug options (PACKETS and STATES). LOG-FILE filename Log states and packets to the specified file. The default log-file is named KERMLOG. OFF Don't log debugging information (this is the default). If debugging was in effect, turn it off and close the log file. PACKETS Log each incoming and outgoing packet (lengthy). STATES Log Kermit state transitions and packet numbers (brief). DELAY decimal-number Sets the number of seconds to wait before sending the first packet. This gives you time to "escape" back and issue a RECEIVE command. The default is 2 seconds. DUPLEX keyword Changes the method of echoing characters when being prompted for commands. The choices are FULL and HALF. FULL means the Cyber will echo the characters you type. HALF means the local system echoes them. FULL is the default, and is used by most hosts. EOR-EOF-MODE option Indicates how end-of-record/end-of-file marks in Cyber text files are to be handled. If option is ON, they are converted to #EOR/#EOF lines in the destination file when a text file is received from the Cyber, and #EOR/#EOF lines in a source file are converted to end-of-record/end-of-file marks in the destina- tion file when sending to the Cyber. If option is OFF, end-of-record/end-of-file marks are ignored, and #EOR/#EOF lines are treated as ordinary text lines. EOR-EOF-MODE ON is only ef- fective when FILE-MODE is TEXT; otherwise action is as if it were OFF. FILE-MODE ftype Declares the file mode to be used while processing Cyber disk files. Allowable values for ftype are TEXT and BINARY. TEXT means that the file contains text in either 8/12 ASCII, 6/12 AS- CII, or Display Code (See the SET TEXT-MODE command). BINARY means that the file contains binary data in either 8/12 or PACKED form (see the SET BIN-MODE command). The default is TEXT. INIT-RETRY decimal-number Set the maximum number of retries allowed for the initial con- nection before giving up. Default is 15. RECEIVE parameter value These commands allow you to specify to the other Kermit what the packets it sends should look like, or to inform this Kermit what to expect. Value may be specified as a decimal number, an octal number (B suffix), or a hexadecimal number (H suffix). Charac- ter values are specified as the numeric equivalent of the ASCII character. END-OF-LINE value The octal value of the ASCII character which will be used as a line terminator for packets by the other system. Carriage return (15B) is the default. PACKET-LENGTH value Maximum packet length the other system may send, a decimal number, between 20 and 1000, 94 by default. Size used is the minimum of this parameter and the SEND PACKET-LENGTH of the other Kermit. PAD-CHARACTER value Character to use for padding. Default is NUL. PAD-LENGTH value Set the number of padding characters to send before a packet. Default is no padding. QUOTE-CHARACTER value The printable character to use for quoting of control characters. Default is # (43B). There should be no reason to change this. SYNC-CHARACTER value The control character that marks the beginning of the packet. Normally SOH (Control-A, ASCII 1). There should be no reason to change this. TIME-OUT value The number of seconds the other Kermit should wait for a packet before asking for retransmission. Default is 10 seconds. RETRY decimal-number Sets the maximum number of retries allowed for a particular packet before giving up. Default is 10. SEND parameter value These commands allow you to specify how outgoing packets should look, in case the other Kermit has non-standard requirements. END-OF-LINE value The octal value of the ASCII character to be used as a line terminator for packets, if one is required by the other sys- tem. Carriage return (15B) by default. PACKET-LENGTH value Maximum packet length to send, decimal number, between 20 and 1000, 94 by default. Size used is the minimum of this parameter and the RECEIVE PACKET-LENGTH of the other Kermit. PAD-CHARACTER value Character to use for padding. Default is NUL. PAD-LENGTH value Set the number of padding characters to send before a packet. Default is no padding. QUOTE-CHARACTER value The printable character to use for quoting of control characters. The default is # (43B). There should be no reason to change this. SYNC-CHARACTER value The control character that marks the beginning of the packet. Normally SOH (Control-A, ASCII 1). There should be no reason to change this. TIME-OUT value How many seconds to wait for a packet before trying again. Default is 10 seconds. -SHOW SHOW Display current SET parameters, version of Kermit-170, and other information. -STATUS STATUS Give statistics about the most recent file transfer. -TAKE TAKE filename or L:filename or P:filename Take Kermit commands from a file. Kermit looks first in the user's local files; if not found it then looks in the permanent file catalog. You may restrict the search by prefixing the filename with "P:" or "L:". (See the SEND command above.) When an logical end-of-record is encountered on the TAKE file, Kermit reverts to accepting commands from the terminal. TAKE commands cannot be nested; a TAKE command read from a file causes Kermit to begin reading commands from the new file, but when the end of the new file is reached Kermit does not revert to the first file.