This file contains information to be transmitted to the host, which did not fit into the standard data files. Mainly, this is the PHost command processor commands, but not only those. Commands from this file are packed into the TRN by an appropriate MAKETURN program.
At the time of this writing, this file format is supported by PCC and related programs, and VPA 3.61. It is more or less the result of a discussion on the phostdev mailing list; other program authors are encouraged to use this file format if possible.
CMDx.TXT is a text file. Each line has the following format:
- leading whitespace (ASCII 32) is ignored;
- lines whose first non-blank character is a `#' are ignored (comments);
- other lines contain PHost command processor commands which are sent as command messages verbatim. Unless specified otherwise below, the order of commands does not matter;
- special commands starting with `$' are reserved for programs that read/write this file. Programs should preserve these commands.
Programs should support both the Unix and the DOS linefeed convention (LF or CR+LF). Programs should support lines of at least 255 characters.
The following special commands are defined at the time of this writing:
- `$include FILE': this token is reserved to mean "include specified file here", but as of now it is not implemented;
- `$send-file name.ext': generate a type-34 UTILx.DAT record (file transfer) which contains the specified file, and send it through the Host via TRN command 62 (SendBack). See there for further information;
- `$time MM-DD-YYYYhh:mm:ss': specify the timestamp of the turn to which this file belongs. If present, this must be the first command in the file;
- `$thost-allies ff1ee2FF3': (PCC) alliance settings for THost. The parameter is a sequence of 3-character alliance friendly codes, which are themselves not separated anyhow;
