)F FUNCTION - HELP revision: Version 4.3.1 (94/11/30) The KERMIT command invokes Kermit-TSO, an assembly language program which implements the Kermit file transfer protocol on IBM System/370 and XA mainframe computers and compatibles running the MVS (Multiple Virtual Storage) operating system with the TSO (Time Sharing Option) subsystem. Kermit-TSO supports file transfer in both line-mode and full-screen operation. Line-mode supports asynchronous half-duplex ASCII communications through 3705/3725 or equivalent front ends, while full-screen supports asynchronous full-duplex ASCII communications through the IBM Series/1 running the Yale ASCII Communications System (or equivalent) or various other converters with graphics throughput option. See the SET CONTROLLER subcommand for further details. )X SYNTAX - KERMIT Required - None Defaults - None Note - The Kermit "?" help feature is available when entering Kermit-TSO subcommands. A subcommand followed by a space and a question mark and entered with a carriage return will display a brief description of what is expected or possible at that point. - When connecting in line-mode, several flags must first be set on the local Kermit. The following are the defaults and other possibilities for those values: Baud whatever the site supports Data bits 7 Flow-control None Handshake XON | None Local-echo on (half-duplex) Parity even | mark | odd - When connecting in full-screen, several flags must first be set on the local Kermit. The following are the defaults and other possibilities for those values: Baud whatever the site supports Data bits 7 | 8 Flow-control XON/XOFF | None Handshake None Local-echo off (full-duplex) Parity even | mark | odd | none - When sending files to Kermit-TSO, any record longer than the logical record length (LRECL) will be truncated or folded to the length at the user's discretion. If the record format is fixed (RECFM=F), any shorter records will be padded to LRECL. If the record format is variable or undefined (RECFM=V or RECFM=U), the block length can be as high as 32760, provided the disk device tracksize is not exceeded. - When sending files to Kermit-TSO, the local Kermit must use a carriage return as the end-of-line (EOL) character. - This version of Kermit-TSO does not support timeouts for other than line-mode terminals. Therefore, the user should press the carriage return key on the microcomputer after long periods of update inactivity during file transfer, or rely on the timeout facility of the local Kermit, if supported, to avoid indefinite delays. )O OPERANDS - None )S SUBCOMMANDS - BYE - logs out other Kermit server. CWd - establishes a new working directory. DIRectory - displays all or part of the disk directory. ECho - a line back to the user. END - a Kermit-TSO session EXit - from Kermit-370. FINish - other Kermit server. Get - file(s) from a Kermit server. GIve - saves changes to a translate table. Help - about Kermit-370. HInts - about getting started. HOst - executes a system command. Kermit - executes a Kermit-TSO subcommand. LOCal - executes a Kermit-TSO subcommand. Quit - from Kermit-370. RECeive - file(s) from other Kermit. REMote - send a command to the other Kermit. RESend - file(s) to other Kermit. SENd - file(s) to other Kermit. SERver - mode of remote operation. SET - various parameters. SHow - various parameters. SImulate - replay a file transfer. STatus - inquiry. STOP - exit protocol mode. TAke - subcommands from a file. TDump - the contents of a chosen table. TSo - executes a system command. TYPE - a file. VErsion - displays Kermit's version number and date. XECHO - echoes a line (transparently). XTYPE - displays a file (transparently). =BYE )F FUNCTION - Log out a Kermit server on another system. )X SYNTAX - BYE Required - None Defaults - None )O OPERANDS - None =CWD=CW )F FUNCTION - Set a new prefix for dataset names used by Kermit. )X SYNTAX - CWD 'string' or CWD 'pds-name()' Required - None Defaults - None Alias - SET PREFIX )O OPERANDS - ))STRING - Partially qualified DSN. ))PDS-NAME - Fully qualified DSN of a PDS. File names are assumed to be member names. =DIRECTOR=DIRECTO=DIRECT=DIREC=DIRE=DIR )F FUNCTION - Display dataset names from the catalog. )X SYNTAX - DIRECTORY 'string' Required - None Defaults - All datasets belonging to the user. )O OPERANDS - ))STRING - Partially qualified DSN. =ECHO=ECH=EC )F FUNCTION - Display a string of text at the terminal. See also XECHO. )X SYNTAX - ECHO 'string' Required - 'string' Defaults - None )O OPERANDS - ))STRING - Text to be displayed. May be mixed case. =END )F FUNCTION - Terminate Kermit-TSO and return to TSO prompt. )X SYNTAX - END Required - None Defaults - None Alias - EXIT, QUIT )O OPERANDS - None =EXIT=EXI=EX )F FUNCTION - Terminate Kermit-TSO and return to TSO prompt. )X SYNTAX - EXIT Required - None Defaults - None Alias - END, QUIT )O OPERANDS - None =FINISH=FINIS=FINI=FIN )F FUNCTION - Terminate server mode in another Kermit. )X SYNTAX - FINISH Required - None Defaults - None )O OPERANDS - None =GET=GE=G )F FUNCTION - Request a file from another Kermit running in server mode. )X SYNTAX - GET 'foreign-filespec' 'dataset-name' Required - 'foreign-filespec' Defaults - 'dataset-name' will match the 'foreign-filespec' )O OPERANDS - ))FOREIGN-FILESPEC - The name of a file on the other system. ))DATASET-NAME - The name the file is to have on TSO. =GIVE=GIV=GI )F FUNCTION - Save the current contents of a translation table in the form of a TAKE file containing SET commands to change the default into the current arrangement. )X SYNTAX - GIVE 'table-name' 'take-dataset-name' Required - 'table-name' 'take-dataset-name' Defaults - file extension 'TAKE' for the 'take-dataset-name' )O OPERANDS - ))TABLE-NAME - Specifies the name of the table to save. ))TAKE-DATASET-NAME - Specifies the dataset in which to save the SET subcommands. The file extension is automatically supplied as TAKE unless the last qualifier is KERMINI (or the name is fully qualified and quoted). =HELP=HEL=HE=H )F FUNCTION - Display help information about Kermit-TSO subcommands. This is the standard TSO help facility and follows the same rules and has the same operands. )X SYNTAX - HELP 'subcommand-name' 'operands' Required - None Defaults - None )O OPERANDS - ))SUBCOMMAND-NAME - Specifies the subcommand name to explain. ))FUNCTION - display the function of the subcommand ))SYNTAX - display the syntax of the subcommand ))OPERANDS(LIST) - display the list of operands ))ALL - display all operands =HINTS=HINT=HIN=HI )F FUNCTION - Displays a set of messages to get you started and to offer suggestions on improving the parameter settings. )X SYNTAX - HINTS Required - None Defaults - None )O OPERANDS - None =HOST=HOS=HO )F FUNCTION - Execute a TSO command. )X SYNTAX - HOST 'command' Required - 'command' Defaults - None Alias - TSO )O OPERANDS - ))COMMAND - The text to be executed as a command. =KERMIT=KERMI=KERM=KER=KE=K )F FUNCTION - Execute a Kermit subcommand. This is useful particularly for distinguishing Kermit subcommands from TSO commands. )X SYNTAX - KERMIT 'subcommand' Required - 'subcommand' Defaults - None )O OPERANDS - ))SUBCOMMAND - The text to be executed as a Kermit subcommand. =LOCAL=LOCA=LOC )F FUNCTION - Execute a Kermit subcommand. LOCAL is really a prefix, rather than a subcommand, but the effect is the same. This function applies whether Kermit-TSO is operating as a 'local' Kermit or not. )X SYNTAX - LOCAL 'subcommand' Required - 'subcommand' Defaults - None )O OPERANDS - ))SUBCOMMAND - The text to be executed as a Kermit subcommand. =QUIT=QUI=QU=Q )F FUNCTION - Terminate Kermit-TSO and return to TSO prompt. )X SYNTAX - QUIT Required - None Defaults - None Alias - END, EXIT )O OPERANDS - None =RECEIVE=RECEIV=RECEI=RECE=REC )F FUNCTION - Initiates file transfer to Kermit-TSO from the other Kermit. - If the optional 'dataset-name' is not specified, Kermit-TSO will use the name(s) provided by the other Kermit. If no dataset exists with this name, one will be created using the file attribute and space values in effect when the RECEIVE subcommand was entered. - If the 'dataset-name' specified is the same as an existing dataset, Kermit-TSO will prompt the user for the option to overwrite the dataset. - If the 'dataset-name' was not specified, but is the same as an existing dataset, Kermit-TSO will overwrite the dataset if FILE COLLISION has been set to OVERWRITE, but will attempt to create a new, unique name otherwise. )X SYNTAX - RECEIVE 'dataset-name' Required - None Defaults - None )O OPERANDS - ))DATASET-NAME - Specifies the dataset where the file being received will be written. =REMOTE=REMOT=REMO=REM )F FUNCTION - Send a subcommand for execution to the other Kermit, operating in server mode. See under SERVER for a list of the allowed subcommands. REMOTE is really a prefix, rather than a subcommand, but the effect is the same. Note that REMOTE PRINT supports the same options as SEND in connection with the filespec. )X SYNTAX - REMOTE 'subcommand' Required - 'subcommand' Defaults - None )O OPERANDS - ))SUBCOMMAND - The text to be executed by the Kermit server. =RESEND=RESEN=RESE=RES )F FUNCTION - Restarts file transfer from Kermit-TSO to the other Kermit. This is the same as SEND (q.v.), except that any file already received by the other Kermit will be skipped regardless of the FILE COLLISION setting, and any file partly received will be restarted at the point where it breaks off. The final result should be exactly the same as if each file were freshly sent. There is no analogous REGET command for use with Kermit servers. This facility works only if both Kermits support it; if the receiver does not, it may refuse the transmission, or it may simply accept each file without any restarts. The only other restriction is that the FILE TYPE must be BINARY (or V-BINARY or D-BINARY). )X SYNTAX - RESEND 'dataset-name' 'foreign-filespec', ... --- Same as SEND. Required - 'dataset-name' Defaults - Will prompt for both if neither is supplied. )O OPERANDS - ))DATASET-NAME - The name of the dataset(s) to be sent. ))FOREIGN-FILESPEC - The name the file is to have on the other system. =SEND=SEN )F FUNCTION - Initiates file transfer from Kermit-TSO to the other Kermit. - One wildcard '*' may be used anywhere in the 'dataset-name' or in the PDS member name, if any, to stand for a string of zero or more characters. - The 'dataset-name' must be cataloged. )X SYNTAX - SEND 'dataset-name' 'foreign-filespec', ... Required - 'dataset-name' Defaults - Will prompt for both if neither is supplied. )O OPERANDS - ))DATASET-NAME - The name of the dataset(s) to be sent. You may append a range of line numbers within angle brackets. Only those lines, inclusive, will be sent. Also, optionally, column-one ASA carriage control may be converted to formatting control characters via the CC option. E.g., SEND FOO.BAR<9-15> will send only lines nine through fifteen of the dataset; SEND FOO.BAR<9-15_CC> will also convert the carriage control. Note that the underscore marks the end of the optional line range and may not be omitted if an option (such as CC) is to be specified. ))FOREIGN-FILESPEC - The name the file is to have on the other system. =SERVER=SERVE=SERV=SER )F FUNCTION - Invokes Kermit-TSO server mode. - Once Kermit-TSO enters server mode, it only accepts subcommands entered at the local Kermit until a FINISH command is executed. Any non-default parameters must be SET before invoking this mode if the local Kermit does not offer the REMOTE KERMIT function. - The local Kermit must support server subcommands to communicate with Kermit-TSO in this mode. The basic server subcommands are GET, SEND, BYE, and FINISH, but Kermit-TSO supports others as well: BYE - End server mode, end Kermit-TSO, and logoff; FINISH - End server mode and return to the Kermit-TSO prompt; GET - Get a file from Kermit-TSO; REMOTE COPY - Copy a file or files under TSO; REMOTE CWD - Set new Kermit DSN prefix; REMOTE DIR - Display list of datasets; REMOTE ERASE - Delete a dataset; REMOTE HELP - Display this command summary; REMOTE HOST - Execute a TSO command; REMOTE KERMIT- Execute a Kermit-TSO subcommand; REMOTE PRINT - Send a file to be printed from TSO; REMOTE RENAME- Rename a dataset; REMOTE TYPE - Display a dataset; SEND - Send a file to Kermit-TSO. - Kermit-TSO can execute these subcommands when dealing with a remote (server) Kermit. )X SYNTAX - SERVER Required - None Defaults - None )O OPERANDS - None =SET )F FUNCTION - Modify parameters for file transfer. The SHOW subcommand may be used to examine these values. )X SYNTAX - SET 'parameter' 'sub-parameter' 'value' Note: Many of the parameters are multi-level, as in SET FILE RECFM F. The following list of operands includes all levels. Required - 'parameter' Defaults - None )O OPERANDS - ))ATOE 'num1' 'num2' - Modifies the ASCII-to-EBCDIC translate table used by Kermit-TSO. The table begins as the Kermit standard translate table (defined in the Kermit protocol specifications). If the numeric values are omitted, the whole table is restored to its initial contents. Tables ETOA, TATOE, and TETOA may be modified in the same way. 'num1' - A decimal number 0-255 for the value of the ASCII character, i.e., the table offset. 'num2' - A decimal number 0-255 for the corresponding EBCDIC character. ))ATTRIBUTE 'attrib' 'ON | OFF' - Allows suppressing the exchange of attribute packets or individual attributes. 'attrib' - Optional name of specific attribute to suppress or enable. Enter "SET ATT ? ?" for a list of them. ))BLKSIZE 'number' - With FILE: specifies the block size for datasets created by Kermit-TSO. Maximum is 32760. The default is 6233. ))BLOCK '1 | 2 | 3 | B' - Specifies the type of block check used during file transfer. The default is 1. '1' - A one-character (6-bit) checksum. '2' - A two-character (12-bit) checksum. '3' - A three-character (16-bit) CRC. 'B' - Like '2', but it avoids the use of blanks. ))CHARACTER-SET 'name' - With FILE: specifies set to use for storing TEXT datasets; with TRANSFER: specifies set to use for transfers. ))COLLISION 'APPEND | BACKUP | DISCARD | OVERWRITE | RENAME' -with FILE: Tells what to do with an incoming file with the same name as an existing dataset. BACKUP and RENAME are the same except that the first renames the existing dataset instead of the new one. In renaming, Kermit-TSO attempts to find a unique name by appending a digit to the second qualifier of the dataset name. The default is OVERWRITE. ))CONTROLLER 'TTY | SERIES1 | GRAPHICS | VTAMTTY | AEA | FULLSCREEN' - Kermit-TSO automatically determines whether you are connected via a Series/1-style emulation controller or a TTY line. This command is provided, though, so you can change connections and because Kermit may not be able to distinguish between Series/1 and graphics throughput devices. For both those and the 3174 AEA, Kermit attempts to disable the 3270 protocol conversion function by putting the controller into "transparent mode"; this allows Kermit packets to pass through intact. The value VTAMTTY would be specified (and is the default) for any TTY device connected through VTAM/TSO. FULLSCREEN mode is a last resort for protocol converters that do not have a transparent mode. ))CONTROL-CHARACTER 'PREFIXED | UNPREFIXED' 'code' - If PREFIXED, use control prefixing for the specified control character (or all control characters if no code is given). If UNPREFIXED, send the control character(s) "as is". If the transmission channel can safely carry such characters "as is", the transfer can be speeded up. Controls used in Kermit protocol are prefixed anyway. ))DEBUG 'ON | OFF | RAW | I/O | LONG | TIME' - If ON, keep a journal of all packets sent and received in the file KER.LOG. If OFF, stop logging the packets and close the file. Default is OFF. ON may be modified by RAW, I/O, and/or LONG. If RAW, record packets exactly as sent and received, rather than in EBCDIC. If I/O, record supplemental info about transfer I/O (for fullscreen devices). LONG is the same as I/O, except that I/O records are not truncated at 36 bytes. If TIME and I/O, the extra log records are given time tags. Note: KER.LOG is prefixed with the Kermit, not the TSO, prefix when debug mode is entered. The log dataset thus begun continues in use no matter what happens to the Kermit prefix. Note: Packets sent by Kermit-TSO are distinguished by a carriage return (X'0D') at the end; packets received have had it stripped by the front end (TTY) processor. ))DELAY 'number' - Specifies the number of seconds Kermit-TSO will delay before beginning to send packets after the SEND subcommand has been entered. Default is 10. Use a DELAY of 1 to abbreviate the usual greetings written on the screen at the start of protocol mode or a DELAY of 0 to suppress the greetings entirely (along with the attendant one-second pause). ))DELIM 'char' - Specifies a character to be interpreted by Kermit as a line delimiter in subsequent subcommands entered from the terminal. The default is none. ))ECHO 'ON | OFF' - With TAKE: Controls whether the contents of TAKE command files are echoed during execution. ))END-OF-LINE 'number' - With SEND or RECEIVE: Specifies the decimal value of the ASCII character used for the packet-terminator or end-of-line. The 'number' must be 0-31. The default is carriage return (13). ))EOF 'ON | OFF' - ON means incoming text files are to be cut off at the first Ctrl-Z character within the data; OFF means accept incoming text files in their entirety. ))ERROR-ACTION 'CONTINUE | HALT' - With TAKE: Controls whether an error occuring during execution of a TAKE command file is fatal to the execution of that file. ))ETOA 'num1' 'num2' - Modifies the EBCDIC-to-ASCII translate table used by Kermit-TSO. See the description under ATOE. ))FILE - Takes subparameters BLKSIZE, CHARACTER-SET, COLLISION, LRECL, OVERWRITE, RECFM, SPACE, TYPE, UNIT, and VOLUME. ))FOREIGN - Takes subparameters PREFIX and SUFFIX. ))HANDSHAKE 'number' - Specifies an ASCII code for a handshake character to be appended to each outgoing packet. Zero means no handshake at all. ))INCOMPLETE 'KEEP | DISCARD' - Specifies the action to take when a file transfer is cancelled. ))INITIAL 'num' - With RETRY: Establishes the limit for retrying the first packet in a transfer. The default is 16. ))LEFT 'column' - With MARGIN: sets the left margin for restricting the width of files to be sent. A value of zero disables the left margin. ))LOCKING-SHIFT 'OFF | ON | FORCE' - With TRANSFER: Specifies whether to use the protocol extension for shifting the 8th-bit state and whether to negotiate or use it unconditionally. ))LONGLINE 'TRUNC | FOLD | HALT' - With FILE: Specifies the action to take when a record is received that is too long. The default is TRUNC. ))LRECL 'number' - With FILE: Specifies the logical record length for incoming datasets. The 'number' must be from 1 to 32760 decimal (32K-8). The default is 80. ))MARGIN - Takes subparameters LEFT and RIGHT. ))OVERWRITE 'DEFAULT | PRESERVE' - With FILE: Specifies whether to retain the original DCB attributes or to use the current Kermit defaults when overwriting an existing dataset. ))PACKET 'num' - With RETRY: Establishes the limit for retrying a packet in a transfer. The default is 5. ))PACKET-SIZE 'num' - With RECEIVE: Use the specified 'num' as the maximum length for incoming packets. The valid range is 26-9024, and 80 is the default. SET RECEIVE PACKET-SIZE 95 or greater causes Kermit-TSO to negotiate reception of extended length packets with other Kermit programs that support this option. ))PAD-CHAR 'num' - With SEND or RECEIVE: Padding character to use between packets, NUL (ASCII 0) by default. ))PADDING 'num' - With SEND or RECEIVE: Number of copies of the interpacket padding character, zero by default. ))PARITY 'MARK | NONE' - With SEND or RECEIVE: Transparent-mode ASCII data from a SERIES1 or GRAPHICS device will typically have either all Mark parity (seven data bits with the eighth bit set) or no parity (eight data bits). Kermit-TSO must know which kind of parity to expect in order to calculate checksums properly. ))PREFIX 'string' - The specified string is used as the DSN prefix for Kermit. See the CWD subcommand. ))PREFIX 'string' - With FOREIGN: The specified string is added to the beginning of outbound filespecs. ))PROMPT 'string' - Defines the character string that Kermit-TSO displays when asking for a command. The prompt may be any string of up to 20 characters. The default is "Kermit-TSO>". ))QUOTE 'char' - With SEND or RECEIVE: Control character quoting prefix, normally #. This character must have an ASCII value in the range 33-62 or 96-126. Note: Do not change this parameter unless transferring a long file which contains many '#' characters. ))RECFM 'F | V | U' - With FILE: Specifies the record format for new files. Default is V. F - Fixed (MVS RECFM=FB) V - Variable (MVS RECFM=VB) U - Undefined (MVS RECFM=U) ))RETRY - Takes subparameters INITIAL and PACKET. ))RIGHT 'column' - With MARGIN: sets the right margin for restricting the width of files to be sent. A value of zero disables the right margin. ))SERVER-TIMEOUT 'num' - Number of seconds to wait for a packet in the server loop before sending a NAK. Default is 120. ))SPACE 'number' - With FILE: Specifies the number of tracks for the space allocation for new files being received from the local Kermit. Default is 5. ))SPEED 'number' - Specifies the line speed assumed in the packet-size optimization algorithm. ))START-OF-PACKET 'num' - With SEND or RECEIVE: Control character to mark start of packet, normally Ctrl-A (ASCII 1). May be 0-31. ))SUFFIX 'string' - With FOREIGN: The specified string is added to the end of outbound filespecs. ))SYSCMD 'ON | OFF' - Determine whether non-Kermit commands are assumed to be TSO commands and passed to TSO for execution. ))TABS 'OFF | ON | ON,tab-list' - Enables or disables tab expansion for files being received. Default is OFF. OFF - Disables expansion. ON - Enables expansion and specifies tabs at columns 9, 17, 25, etc. ON,tab-list - Enables expansion and specifies use of tab stops listed in 'tab-list'. ))TAKE - Takes subparameters ECHO and ERROR-ACTION. ))TATOE 'num1' 'num2' - Modifies the ASCII-to-EBCDIC translate table used by Kermit-TSO. See the description under ATOE. ))TEST 'ON | OFF' - Used for testing new versions, suppresses block check verification, allows start-of-packet to be set to anything at all. The default if OFF. ))TETOA 'num1' 'num2' - Modifies the EBCDIC-to-ASCII translate table used by Kermit-TSO. See the description under ATOE. ))TIMEOUT 'num' - With SEND or RECEIVE: Number of seconds to wait for a packet before retransmitting. ))TRANSFER - Takes subparameters CHARACTER-SET and LOCKING-SHIFT. ))TTABLE 'ON | OFF | KP' - Controls whether ATOE/ETOA or TATOE/TETOA are used for counteracting the system translations on TTY lines. The default is OFF (use ATOE/ETOA). KP is like ON, but also sets the TATOE/TETOA tables to values based on Hollerith codes. ))TYPE 'Binary | Text | V-binary | D-binary' - With FILE: Specifies the file type of the data and determines the type of translation, if any, to use. Binary - Specifies non-delimited, bit-stream data. No trans- lation is performed, and no carriage return/linefeed pairs are added to outgoing records. Incoming bytes are added successively to the current record, which is written out when the specified logical record length (LRECL) is reached. Text - Specifies textual data. ASCII-to-EBCDIC and EBCDIC-to-ASCII translation is performed on the data using the defined translate tables. Carriage return/linefeed pairs are used to delimit the records. This is the default. V-binary - Specifies variable-length binary records. Like BINARY, except that a 2-byte length field precedes each outbound record and is assumed for incoming records. Incoming records are stripped of their prefixes and written out when the prefix value is reached. This is useful when the record format is unformatted (RECFM=U) or variable (RECFM=V). D-binary - Specifies variable-length binary records. Like V-BINARY, except that the prefix field is a 5-byte ASCII decimal string. ))UNIT 'name' - With FILE: Specifies the name of the device type or class for storing new files (e.g., received from the local Kermit). The default is SYSDA. ))VOLUME 'name' - With FILE: Specifies the name of the particular storage volume for storing new files (e.g., received from the local Kermit). The default is blank (the system will choose any volume of the specified UNIT class). ))8-BIT-QUOTE 'ON | OFF | char' - Controls whether eighth-bit prefixing is done and specifies the character to be used. =SHOW=SHO=SH )F FUNCTION - Displays the values of all parameters which can be changed with the SET subcommand, except the translation tables. See also the TDUMP subcommand. )X SYNTAX - SHOW 'parameter' Required - none Defaults - all )O OPERANDS - ))PARAMETER - The parameter whose value is to be displayed. If the value is 'ALL' or is omitted, the values of all parameters except the Attribute flags are displayed. If only one level of a multi-level parameter family is given, then all sub- parameters will be displayed. =SIMULATE=SIMULAT=SIMULA=SIMUL=SIMU=SIM=SI )F FUNCTION - Specifies a dataset to be used as input instead of the communication line for a subsequent transaction. Kermit will read lines from the file one at a time as needed until the file is exhausted and will then revert to normal operation. Lines beginning "S:" are ignored; lines beginning "R:" are first translated to ASCII and then used; other lines are used "as is." Entering this subcommand with no argument will suppress the simulation function. )X SYNTAX - SIMULATE 'dataset' Required - none Defaults - none )O OPERANDS - ))DATASET - The dataset to be used as input. If none is specified, simulation is turned off. =STATUS=STATU=STAT=STA=ST )F FUNCTION - Returns the status of the previous subcommand. The response will display the statistics of the last transfer plus the message 'No Errors' or the last error encountered. )X SYNTAX - STATUS Required - None Defaults - None )O OPERANDS - None =STOP )F FUNCTION - Returns immediately from protocol mode, thereby canceling any active transfer and ending server mode if necessary. )X SYNTAX - STOP Required - None Defaults - None )O OPERANDS - None =TAKE=TAK=TA )F FUNCTION - Executes Kermit-TSO subcommands from the specified file. )X SYNTAX - TAKE 'take-dataset-name' Required - 'take-dataset-name' Defaults - None )O OPERANDS - ))TAKE-DATASET-NAME - Specifies the dataset from which to get the sequence of Kermit-TSO subcommands to execute. The file extension is automatically supplied as TAKE unless the last qualifier is KERMINI (or the name is fully qualified and quoted). =TDUMP=TDUM=TDU=TD )F FUNCTION - Display the contents of the specified table. )X SYNTAX - TDUMP 'table-name' Required - 'table-name' Defaults - None )O OPERANDS - ))TABLE-NAME - Specifies the name of the table to display. CONTROL - The table of prefix/unprefix settings. ATOE - The ASCII-to-EBCDIC translate table. ETOA - The EBCDIC-to-ASCII translate table. NAMES - The list of datasets from the last transfer, i.e., the transaction log. TATOE - The ASCII-to-EBCDIC table (for undoing the front end). TETOA - The EBCDIC-to-ASCII table (for undoing the front end). =TSO=TS )F FUNCTION - Execute a TSO command. )X SYNTAX - TSO 'command' Required - 'command' Defaults - None Alias - HOST )O OPERANDS - ))COMMAND - The text to be executed as a command. =TYPE )F FUNCTION - Display the specified file at your terminal. Requires the existence of a TSO LIST command. )X SYNTAX - TYPE 'dataset-name' Required - 'dataset-name' Defaults - None )O OPERANDS - ))DATASET-NAME - Specifies the file to be displayed. =VERSION=VERSIO=VERSI=VERS=VER=VE )F FUNCTION - Displays the version number and date of Kermit-TSO. )X SYNTAX - VERSION Required - None Defaults - None )O OPERANDS - None =XECHO=XECH=XEC=XE )F FUNCTION - Display a string of text as a raw text transfer according to the current CONTROLLER setting (similar to ECHO). )X SYNTAX - XECHO 'string' Required - 'string' Defaults - None )O OPERANDS - ))STRING - Text to be displayed. May be mixed case. May contain ASCII control characters using the '^' notation. =XTYPE=XTYP=XTY=XT )F FUNCTION - Display the specified file at your terminal as a raw download according to the current CONTROLLER setting. See also TYPE. )X SYNTAX - XTYPE 'dataset-name' Required - 'dataset-name' Defaults - None Options may be given in angle brackets <> the same as for SEND. )O OPERANDS - ))DATASET-NAME - Specifies the file to be displayed.