.cs 1 on KERMIT .sp 2 Kermit-CMS is a program that implements the KERMIT file transfer protocol for IBM 370-series mainframes running the VM/CMS operating system. It allows for the transfer of files between computers over normal terminal communication lines (asynchronous ASCII lines attached to a 3705-style front end, such as the COMTEN) or a Series/1 running the Yale ASCII Terminal Communication System. The program should also work on the IBM 7171 ASCII Device Control Unit and the 4994, although this has not been verified as of this writing. For more details on this, see the section SET SERIES1. The calling format for Kermit-CMS is: .sp 1 .cs 1 off .cs 2 on +----------------------------------+ | | | | KERMIT | [kercmd ... kercmd] | | | | +----------------------------------+ where kercmd is a valid Kermit-CMS command. If no Kermit commands are supplied, Kermit-CMS will issue a prompt and wait for instructions. Kermit may also be invoked with optional command line arguments. In this case, Kermit will exit and return to CMS after completing the specified command or commands. Several commands may be given on the command line as long as they are separated by the linend character. The command line may contain up to 130 characters. .sp 1 .cs 2 off .cs 3 on Commands: .sp 2 .of 8 SEND [] .sp 1 Send a file or file group from the CMS system to the Kermit on the remote system. The wildcard characters "*" or "%" may be used. A "*" matches any string of characters from the current position to the end of the field, including no characters at all; a "%" matches any single character. If the input contains wildcard characters then all matching files will be sent. If the optional filemode is omitted, a filemode of "*" is used. In this case, the users disks are scanned according to the search order and the first occurrence of the file is the one that is sent. If a file exists by the same name on more than one disk, only the first one encountered is sent. The user may override the search order by specifying a filemode. .sp 1 .of 8 RECEIVE [ []] .sp 1 Receive a file or file group from the other system. If the optional filename is not included, Kermit-CMS will use the name(s) provided by the other Kermit. If that name is not a legal CMS file name, Kermit-CMS will delete excessive characters from it, and will change illegal characters to the letter "X". Kermit-CMS supplies a default type of "X" if one is not provided by the remote system. Use the file specification to indicate that the incoming file should be stored under a different name. The filespec may include a filemode to designate the destination disk. If none is provided, the file will be saved with filemode A1. If you want to use the same name but a different filemode, specify "= = FM", where FM is the access mode of the destination disk. Wildcards may not be used in any field. If the optional filespec is provided, but more than one file arrives, the first file will be stored under the given filespec, and the remainder will be stored under their own names on the A disk. If, however, "= = FM" is used, all files will be placed onto the specified disk. .sp 1 .of 8 TAKE [] .sp 1 Execute Kermit commands from the specified file. The command file may include TAKE commands. .sp 1 .of 8 SERVER .sp 1 Kermit-CMS is capable of acting as a server. The user connects to the CMS system once to set various options and to start the server. From then on, he need not connect to the CMS system again. The current version of Kermit-CMS can send files (the user on the other end types the GET command, using either a space or a period as the delimiter between filename, filetype, and filemode), receive files (the user types SEND), and terminate by either returning to CMS (user types FINISH) or logging the user out (user types BYE). To put Kermit-CMS into server mode, first issue any desired SET commands to select various options and then issue the SERVER command. Kermit-CMS will await all further instructions from the Kermit on the other end of the connection. .sp 1 .of 8 SET .sp 1 Establish or modify various parameters for file transfer. You can examine their values with the SHOW command. Valid options are: .sp 1 .in 8 .of 8 ATOE .sp 0 Modify the ASCII-to-EBCDIC translate table used by Kermit-CMS to conform to your system. Specify the offset of the ASCII value within the table and the new value for that location. Both "num1" and "num2" should be between 0 and 255 (decimal). Note that the table is twice as long as necessary because the translate instruction expects a table that contains 256 characters. .sp 1 .of 8 BLOCK .sp 0 Determine the type of block check used during file transfer. Valid options for "num" are: 1 (for a one character checksum), 2 (for a two character checksum) and 3 (for a three character CRC). .sp 1 .of 8 DEBUG .sp 0 If ON, keep a journal of all packets sent and received in the file KER LOG A1. If the file already exists, it is overwritten. If OFF, stop logging the packets. .sp 1 .of 8 END-OF-LINE .sp 0 If the remote system needs packets to be terminated by anything other than carriage return, specify the decimal value of the desired ASCII character. "num" must be between 0 and 31 (decimal). .sp 1 .of 8 ETOA .sp 0 This command allows you to modify the EBCDIC-to-ASCII translate table used by Kermit-CMS to conform to your system. Specify the offset of the EBCDIC value within the table and the new ASCII value for that location. Both "num1" and "num2" should be between 0 and 255 (decimal). .sp 1 .of 8 FILE .sp 0 If BINARY, CMS Kermit treats each character as a string of bits and does not perform translation on the data. Also, carriage returns are not added to the end of outgoing records. Incoming bytes are added to the end of the current record which is written out when the specified LRECL is reached. If TEXT, CMS Kermit treats the file as plain text. ASCII-to-EBCDIC and EBCDIC-to-ASCII translation is performed on the data. A carriage return-linefeed is appended to each outgoing record and is used to determine the end of each incoming record. .sp 1 .of 8 LRECL .sp 0 Set the logical record length for incoming files to a "num" from 1 to 65536 (64K). This variable is used only for fixed format files. The default is 80. .sp 1 .of 8 PACKET-SIZE .sp 0 Use the specified "num" as the maximum length for incoming packets. The valid range is 26-94, where 94 is the default. .sp 1 .of 8 QUOTE .sp 0 Use the indicated printable character for prefixing (quoting) control characters and other prefix characters. The only reason to change this would be for sending a very long file that contains very many "#" characters (the normal control prefix) as data. It must be a single character in the range: 33-62, 96, or 123-126 (decimal). .sp 1 .of 8 RECFM .sp 0 Set the record format to use for incoming files, using "F" for fixed format and "V" for variable format. The default is variable. .sp 1 .of 8 SERIES1 .sp 0 Kermit-CMS automatically determines whether you are connected via a Series/1 emulation controller or a TTY line. This command is provided though so you can override Kermit-CMS. If SERIES1 is ON, Kermit disables the 3270 protocol conversion function by putting the Series/1 into "transparent mode"; this allows Kermit packets to pass through the Series/1 intact. .sp 1 .of 8 WARNING .sp 0 If the incoming file has the same name as a file that already exists, and WARNING is OFF, the original file will be overwritten. If WARNING is set ON, Kermit-CMS will change the incoming name so as not to obliterate the pre-@|existing file. It attempts to rename the file by replacing the first character with a dollar sign ("$"). If a file by that name exists, it also replaces the second character with a dollar sign. It continues in this manner for all characters of the filename and filetype. .in 0 .of 8 SHOW