DEBUG 17 Main Menu Kermit-Perq Kermit-Perq Main Commands. This is the main command level of Kermit-Perq. A command can be invoked by typing its (abbreviated) name, or by pressing tabswitch and selecting it on the PopUp menu. If a command requires further keywords or parameters, you will be prompted for them. When prompted for a keyword, you may always press tabswitch to get a PopUp menu, and also always press HELP to get an explanation. A prompt for a keyword may be cancelled by entering a blank line, and you will be returned to the previous command level. Repeated RETURN's will eventually return you to the main command level. To speed up typing, you may always enter the rest of the command line on one line, e.g. SET PARITY EVEN may be issued as : Kermit-Perq>SET SET>PARITY SET PARITY>EVEN Kermit-Perq> or simply as: Kermit-Perq>SET PARITY EVEN Kermit-Perq> Note that the commands, except for SHOW, STATUS and progress reporting from lengthy commands, are 'silent', i.e. successful execution is not accompanied by any output. Ctrl-C will return you to the main command level of Kermit-Perq, after doing any necessary cleanup, such as aborting a file transfer in progress. Ctrl-Shift-C will return to the main command level immediately. > SEND -1 SEND Filename Send specified file(s) to remote Kermit. File may be text or binary, but binary file transfer will only be successful if 8-bit quoting is supported or PARITY NONE is specified. Format: SEND [] may contain wildcards. When is specified, this is the name for the file under which it will be stored on the other machine. If any filename contains wildcards, the other must contain the same wildcards, in the same order. The effect will be as with the Shell COPY command. > RECEIVE -1 RECEIVE Filename Receive file(s) from remote Kermit. Use when the remote Kermit not has the SERVER facility. A SEND command will have to be issued at the remote Kermit. File may be text or binary, but binary file transfer will only be successful if 8-bit quoting is supported or PARITY NONE is specified. Format: RECEIVE [ [] ] When no filename is specified, just take what the other Kermit may send, and store files under the same names they are sent. With only local filename specified, the file received will be stored under this name. Optionally a '*' may be contained in the filename, and will be replaced by the received filename. When both filenames are specified, the filenames received will be matched with the and stored as . This is primarily intended to be used with wildcards. If any filename contains wildcards, the other must contain the same wildcards, in the same order. The effect will be as with the Shell COPY command. When filenames are specified, but no wildcards, only one file may be sent from the remote Kermit. > GET -1 GET Filename Receive specified file(s) from remote Kermit SERVER. File may be text or binary, but binary file transfer will only be successful if 8-bit quoting is supported or PARITY NONE is specified. Format: GET [ ] may contain wildcards. When is specified, this is the name for the file under which it will be stored on the Perq. If any filename contains wildcards, the other must contain the same wildcards, in the same order. The effect will be as with the Shell COPY command. > EXIT 0 - Leave Kermit-Perq immediately. Reset devices etc. to the state they had before entering Kermit. NOTE: An active remote server is not logged out. > QUIT 0 - Leave Kermit-Perq immediately. Keep the state of Kermit, so when Kermit is re-entered all SET parameters etc. are in the same state. NOTE: An active remote server is not logged out. > PUSH 0 - Not implemented. > TAKE -1 TAKE filename Read Kermit-Perq commands from the file specified. Return at end of file. Command files may be nested. Default file extension is .CMD . Equivalent to @. > CONNECT 0 - Connect as a terminal to the remote machine. (This Kermit will function as a dumb terminal.) CONNECT may be aborted, and you will be returned to the main command level by pressing any tabswitch. > BYE 0 - Leave Kermit-Perq as with EXIT, but Logout remote server first. > FINISH 0 - Terminate server mode and return to normal command mode on remote Kermit. > REMOTE 0 - Perform command at remote server Kermit. Not implemented. > LOCAL 0 - Perform command at Perq. Not implemented. > SERVER 0 Enter server modus on this Kermit. The Kermit will then receive all its commands from the other Kermit, and be fully controlled by it. (That means there is no exit from server modus until the other Kermit relinquishes its control.) Server modus is not yet implemented. > SET 17 Set parameter SET Alter parameters governing the way Kermit-Perq works. Format: SET > BAUD 8 Set baudrate BAUDRATE Defines the transmission and reception speed of the RS232 line. Default setting is 4800 baud, which should be used in the RUNIT environment to be able to talk with most other computers. > 110 0 - Sets 110 bps transmission/reception speed. > 150 0 - Sets 150 bps transmission/reception speed. > 300 0 - Sets 300 bps transmission/reception speed. > 600 0 - Sets 600 bps transmission/reception speed. > 1200 0 - Sets 1200 bps transmission/reception speed. > 2400 0 - Sets 2400 bps transmission/reception speed. > 4800 0 - Sets 4800 bps transmission/reception speed. > 9600 0 - Sets 9600 bps transmission/reception speed. > PARITY 5 Set parity PARITY Defines the parity setting of the RS232 line. Default setting is EVEN, which should be used in the RUNIT environment to be able to talk with most other computers. > NONE 0 - Sets 8 bits receive/transmit, no parity generation or check. Binary file transmission will be possible with all Kermit's. > EVEN 0 - Sets 7 bits receive/transmit, even parity generation and check. Note: Binary file transmission will be impossible without 8-bit quote capability of the remote Kermit. > ODD 0 - Sets 7 bits receive/transmit, odd parity generation and check. Note: Binary file transmission will be impossible without 8-bit quote capability of the remote Kermit. > MARK 0 - Sets 7 bits receive/transmit, with parity bit set to mark (1). Note: Binary file transmission will be impossible without 8-bit quote capability of the remote Kermit. > SPACE 0 - Sets 7 bits receive/transmit, with parity bit set to space (0). Note: Binary file transmission will be impossible without 8-bit quote capability of the remote Kermit. > STOP-BITS 4 Set stop bits STOP-BITS Set number of stop bits to use for the serial input/output (SIO). > SYNCHRONOUS 0 - The SIO is set into synchronous mode. (The command SET STOP-BITS SYNCHRONUS is somewhat misleading.) > 1BIT 0 - Use 1 stop bit, asyncronous mode for the SIO. > 1.5BIT 0 - Use 1.5 stop bits, asynchronous mode for the SIO. > 2BIT 0 - Use 2 stop bits, asyncronous mode for the SIO. > SEND 7 Set send SEND Alter parameters concerning sending of packets. These parameters may also be changed by the initial connection protocol during SEND or RECEIVE. They may have to be adjusted to get the first packet through to the other side. > PACKET-LENGTH -1 SEND PACKET-LENGTH Maximum length of packet to send. To prevent buffer overrun, it should not be set very much greater than the buffer size of the receiving computer. Long packets will improve performance, unless buffer overrun occurs and garbles packets (requiring retransmission, wasting bandwidth). > QUOTE -1 SEND QUOTE Which character to use as a control quote when sending data. Default and recommended is '#'. > START-OF-PACKET -1 SEND START-OF-PACKET Which character to use to mark the beginning of an outgoing packet. This character defaults to ASCII SOH ( chr(1) ) and should not be changed unless it is positively known that the other Kermit expects something else. It may be entered as ordinal number preceeded by '#', or as a printable character (which is transformed by CTL) preceeded by '^', i.e. control-B is entered as '#2' or '^B'. > TIMEOUT -1 SEND TIMEOUT The minimum number of seconds to wait for a reply before retrying, when a packet has been sent. Legal values are 1 to 94 (seconds). > END-OF-LINE -1 SEND END-OF-LINE Packet terminator character to use when sending. Defaults to CR (chr(13)). May be entered as ordinal number preceeded by '#' or one of the characters '@', 'A' to ']' or '^', preceeded by '^', which will be transformed to the corresponding control character by CTL. I.e. enter '^J' or '#10' to get LF (ctrl-J, chr(10)) as end-of-line. > PADDING -1 SEND PADDING Number of padchars to output before outputting the packet. Defaults to zero. > PADCHAR -1 SEND PADCHAR Which padchar to use. May be entered as ordinal number. Defaults to ASCII NUL ( chr(0) ). > RECEIVE 4 Set receive RECEIVE Alter parameters concerning how a received packet is expected to look. These parameters may also be adjusted by the initial connection protocol during RECEIVE/SEND. > PACKET-LENGTH -1 RECEIVE PACKET-LENGTH Maximum length of packet to expect. To prevent buffer overrun, it should not be set very much greater than the ring buffer size of the Perq. To be absolutely sure, use a value of 59, which will prevent any loss of data if Kermit-Perq for some reason does not start taking the packet out of the ring buffer before the other Kermit has finished sending. (But long packets will improve performance of the protocol, as long as overrun does not garble any packets.) > QUOTE -1 RECEIVE QUOTE Which character the other Kermit should use as a control quote when sending data, and Kermit-Perq should interpret as control quote when receiving data. Default and recommended is '#'. > START-OF-PACKET -1 RECEIVE START-OF-PACKET Which character to look for to detect the start of an incoming packet. This character defaults to ASCII SOH ( chr(1) ) and should not be changed unless it is positively known that the other Kermit sends something else. It may be entered as '#' and a ordinal number, or as '^' and a printable character which is transformed by CTL, as for end-of-line, i.e. control-B is entered as '#2' or '^B'. > TIMEOUT -1 RECEIVE TIMEOUT The minimum number of seconds the other Kermit should wait for a reply before retrying when it has sent a packet. Legal values are 1 to 94 (seconds). > FILE-HEADER 4 File header FILE-HEADER Set mode of transformation to be applied to the file names of transmitted files. Except for the NORD transformation, the transformations will only be applied to the names of files sent from Kermit-Perq. If specified, the transformation will apply to the second file name in the SEND command or the first file name of the RECEIVE. > NORD 2 Nord NORD When ON, transform file names into a form suitable for the SINTRAN-III file system of ND computer series. When NORD transformation is ON, none of the other transformations apply. (That is: Kermit acts as if NO-TRUNCATE and CONVERT UPPER has been set, but when NORD is turned off, these transforms will be returned to their previous settings.) This transformation affects both SEND and RECEIVE files. > ON 0 - SEND file names are transformed by changing all dots ('.') but the last one into hyphens ('-'). Kermit-ND will change the last dot into a colon and make the last part of the Perq filename the file type of the SINTRAN file name. The inverse transformation will be applied to the file names of RECEIVE'd files. > OFF 0 - NORD transformation is turned off. The other transformations will be put into effect. > NO-TRUNCATE 0 - No truncation is applied to the Perq file name of a SEND file. The entire name (excluding path) is put into the file header packet. This option typically will require the receiving Kermit to be running on another Perq. The settings of the other options are not influenced. > TRUNCATE -1 TRUNCATE The filename is considered partitioned into parts delimited by dots ('.'). The argument of this command is a list of numbers, where each number gives the maximum length of the matching part of a partitioned file name. Every part is truncated to the length given by the mathcing number. A part with no matching number will simply be omitted. The matching rules are as follows 1) The first number always match the first (possibly only) part. 2) The last number match the last part whenever there is more than one part. (This is to avoid discarding the file extension.) 3) The remaining, unmatched items (if any) will be matched starting with the second number and the second part. TRUNCATE with no argument will reactivate truncation with the same values as before NO-TRUNCATE was issued. To clarify: Assume TRUNCATE 8,3 The name 'Firstpart.Secondpart.PAS' will be transformed into 'Firstpar.PAS'. 'Firstpart' will be transformed into 'Firstpar'. If TRUNCATE 8,3,3 both the first name and 'Firstpart.Secondpart.Thirdpart.PAS' would have become 'Firstpar.Sec.PAS'. This transformation does not apply to RECEIVE'd file names. The default setting is TRUNCATE 8,3 which is suitable for communication with Kermit-32 under VAX/VMS, Kermit-80 under CP/M-80 and Kermit-86 under DOS. > CONVERT 3 Convert CONVERT The file name may be converted into all upper or lower case letters, or left as it is, according to the setting of this option. The default setting is UPPER-CASE, making Kermit-Perq transform all SEND file names into uppercase. This transformation does not apply to RECEIVE file names. > LOWER 0 - The file name will be translated into all lower case letters. > UPPER 0 - The file name will be translated into all upper case letters. > OFF 0 - The file name will not be translated. (But possibly one of the other transformations will apply.) > 8-BIT-QUOTE -1 8-BIT-QUOTE Determine which character will be used as 8-bit quote. Legal quote characters are all printable characters except '@', 'A'-'Z', '[', '\', ']', '^' and any character which is defined as another quote (usually '#' and '~'). Default and recommended 8-bit quote is '&'. As a special case, 'Y' is allowed, and means that 8-bit-quoting will be done with whatever character the other Kermit wants to use. The same effect is achieved with a blank entry. > USE-8-BIT-QUOTE 2 use 8-bit quote USE-8-BIT-QUOTE Specify whether 8-bit quoting is to be used or not. Independent of setting of 8-bit quote character. > AUTO 0 - 8-bit quoting will be done if PARITY NONE is not set (then it is not necessary) and the other Kermit agrees. > OFF 0 - 8-bit quoting will not be done in any case. Most useful in connection with old Kermit's which do not support 8-bit quoting. NB! Binary file transfer will generally not be possible if PARITY NONE can't be set. > REPEAT-PREFIX -1 REPEAT-PREFIX Determine which character will be used as repeat prefix. Legal prefix characters are all printable characters except '@', 'A'-'Z', '[', '\', ']', '^' and any character which is defined as another quote (usually '#' and '&'). > USE-REPEAT-PREFIX 2 use repeat prefix USE-REPEAT-PREFIX Specify whether repeat prefixing is to be used or not. Independent of setting of repeat prefix. > AUTO 0 - Repeat prefixing will be performed if the other Kermit agrees. > OFF 0 - Repeat prefixing will not be done in any case. Most useful in connection wit old Kermit's which do not support repeat prefixing. > FILE-WARNING 2 File warning FILE-WARNING Determine what Kermit-Perq will do when receiving a file with the same name as an existing file. > ON 0 - If a file-name clash occurs, to avoid overwriting the existing file, Kermit-Perq will modify the received file name by appending $'s until the received file name is unique. > OFF 0 - If a file-name clash occurs, Kermit-Perq will just go ahead and write over the existing file. > RETRY 3 Set retry RETRY Sets the maximum number of retries before Kermit-Perq gives up an operation, and aborts transfer. > INITIAL-CONNECTION -1 RETRY INITIAL-CONNECTION Sets the number of retries before Kermit-Perq gives up an attempt to initiate a transfer. The default value is 8. > PACKETS -1 RETRY PACKETS Sets the number of retries before Kermit-Perq gives up an attempt to receive a good data- or acknowledge packet. The default value is 5. > COMMANDS -1 RETRY COMMANDS Sets the number of retries before Kermit-Perq gives up an attempt to send a command (such as LOGOUT or FINISH) to a remote server. The default value is 3. > LOG-FILE -1 LOG-FILE Open file to log the terminal session to. Logging is only active during CONNECT modus, and is switched on or off by the SET LOG ON/OFF command. If a log file is already open when the SET LOG-FILE command is issued, this log-file is closed before the new one is opened. If a blank file name is entered, no new log-file is opened and logging is turned off. Specifying the same file as already is active will rewind this file and discard the previous log. > LOGGING 2 Set logging LOGGING Switch logging on or off. The log-file must previously have been opened by the SET LOG-FILE command. Logging may be turned off and then on again, and with no intervening SET LOG-FILE, the result will be that the new log output will be appended to the same log-file. > ON 0 - Turn logging on. If no SET LOG-FILE has been issued since logging was turned off, the log output will be appended to the active log-file. SET LOG ON will be allowed when no log-file is open, but logging will not commence until a SET LOG-FILE has been successfully executed. > OFF 0 - Turn logging off. Does NOT close log-file. Turning logging back on again will append to the end of the same log-file. > DEBUGGING 2 Debugging DEBUGGING Controls whether debug output is generated during file transfer. > ON 0 - Debug output is generated: Received and sent packets are dumped, state transitions are monitored and more extensive error messages are generated. Interpretation of output will typically require a quite intimate knowledge of the Kermit protocol. Also: The process of generating output will considerably slow down the transfer. > OFF 0 - Debug output is not generated. > BREAK-TIME -1 BREAK-TIME Set number of milliseconds duration of a 'break'. (Note: Break is not implemented, due to hardware limitations of the Perq .) > ESCAPE-CHARACTER -1 ESCAPE-CHARACTER Set the key which will be used to escape terminal mode and return to Kermit-Perq after CONNECT. It may be entered as a usual control character, that is as a letter prefixed by '^', or as an ordinal number prefixed by '#'. To utilize the special keys on the Perq keyboard, you may alternatively enter the escape character by answering the 'ESCAPE-CHARACTER' prompt with RETURN only. You will then be asked to press the key which you want to be used as escape key. All combinations of CTRL and SHIFT is possible. The only keys which are not possible, are CTRL-SHIFT-C and HELP. The default is CTRL-] as for most other Kermit's. > SHOW 18 - SHOW Show current setting of the SET parameters. Refer to SET help menues for more explanations of the parameter values. > BAUD 0 - Show speed of the serial communications line. > PARITY 0 - Show parity generation/check on the serial communications line. > STOP 0 - Show mode/number of stop bits to use on the serial communications line. > SEND 0 - Show SEND parameters. (What this Kermit will use when sending packets to the other one.) > RECEIVE 0 - Show RECEIVE parameters. (What this Kermit will tell the other one to use when sending our way.) > FILE-HEADER 0 - Show transformations to be applied to file name when transmitted. > 8-BIT-QUOTE 0 - Show the current 8-bit quote character. > USE-8-BIT-QUOTE 0 - Show whether 8-bit quoting will be used. (Will be used if necessary when AUTO.) > REPEAT-PREFIX 0 - Show the current repeat prefix character. > USE-REPEAT-PREFIX 0 - Show whether repeat prefixing will be used. (Will be used if necessary when AUTO.) > FILE-WARNING 0 - Show whether overwrite of existing file will be permitted. (Will not if ON.) > RETRY 0 - Show retry limits before giving up transfer. > LOG-FILE 0 - Show name of current opened log file. > LOGGING 0 - Show whether terminal session is beeing logged to the log file. > DEBUGGING 0 - Show whether debug output is generated. > BREAK-TIME 0 - Show number of milliseconds duration of a line 'break'. > ESCAPE-CHARACTER 0 - Show which key currently is in function as escape key. > ALL 0 - Show status of all SET parameters. > STATUS 0 - Show current status of Kermit. > STATISTICS 0 - Show statistics from last transfer. Not implemented. >