Standalone Logtool for MPE/iX

RECORD`ID 1
RECORD`ID 123
TAG`ID
This command defines the variant tag portion of a previously defined RECORD`ID or TAG`ID. For example, refer to
the following PASCAL record definition:
TYPE my_record = RECORD
field1 : integer;
CASE select : boolean OF
true : (true_case : some_other_type);
false : (false_case : yet_another_type);
END;
It has a tag field called "select" and two possible variant parts. Each of the two variant parts would need a TAG`ID
entry (with additional record definition commands) to define the variant part. The specifications field indicates which
RECORD`ID this TAG`ID is to be used with. For more details, see the section called Tag Usage Example.
Syntax:
TAG`ID <record id # this definition is used with>
Examples:
TAG`ID 100
Record Description Commands
The following set of commands are used to define the attributes of an individual log record (RECORD`ID) or tag
variant of some record (TAG`ID). (From here on RECORD and TAG`IDs will not be differentiated unless required). If
the LOGTOOL LAYOUT command sees any of the commands without a RECORD or TAG`ID command, it will generate an
error. Additionally, only one of the possible definition commands may be provided for any one record. The following
commands must be provided when defining a RECORD or TAG`ID:
RECORD`LENGTH
N`FIELDS
RECORD`LABEL
FIELD`FORMATS
The RECORD`LENGTH and N`FIELDS commands must be provided before any of the other commands. For a TAG`ID
definition, the VARIANT command is required.
RECORD`LENGTH
This command specifies the total length in bits for the maximum size of the current RECORD`ID. This value should
not include the size of any data added by the system (i.e., the actual RECORD`ID, time stamp, etc.). This value and
the number of bits specified in the FIELD`FORMAT must agree.
Syntax:
RECORD`LENGTH <# of bits>
Notes: The maximum number of bytes is 2028.
Example: