OpenTP1 Version 7 Tester and UAP Trace User's Guide
A logical message can contain one or more segments. A segment consists of a header part containing the segment information and a data part which is the message text.
There are five types of segments:
Specify the segment type in the header part.
An MCF receive message file stores the messages received by the UAP in an MCF function (dc_mcf_receive, dc_mcf_recvsync, or dc_mcf_sendrecv). Create one logical message per file. Two messages can be concatenated if a header segment is used.
Item | Position | Length (bytes) | Contents | |
---|---|---|---|---|
Header | Input/output logical terminal name | 0 | 9 | Logical terminal name (including final null character) to be passed in MCF functions. Specify the same name for each segment of a multiple-segment message. |
Map name | 9 | 9 | Map name (including final null character). Specify the same name for each segment of a multiple-segment message. This specification is valid only for functions that return a map name. |
|
Reserved | 18 | 9 | Null character | |
Segment type | 27 | 1 | One of the following characters:
|
|
Message length | 28 | 4 | Message length (0-2147483647) | |
Data | Message | 32 | n | The data in the segment, of the specified message length |
When segment type F, M, or L is specified, the message is handled in the same way as when O is specified and no error occurs.
Segment type | File type |
---|---|
F | Handled as an MCF receive message file. |
M | |
L | |
O | |
H, # | Handled as an invalid file specification. The system makes a file name inquiry. |
When segment type L, H, or O is specified, the MHP regards the message as completed and ignores any subsequent segments. Segment type F is handled in the same way as segment type M.
Segment type | Segments received by MHP | ||
---|---|---|---|
First segment | Middle segment | Last segment | |
F | M | L | F, M, L |
F | L | M | F, L#1 |
F | O | L | F, L#2 |
M | M | L | M, M, L |
L | M | F | L#3 |
O | O | O | O#3 |
F | L | M | F, L#1 |
F | M | H | No segments received.#4 |
X | M | L | |
F | X | L | |
F | M | X | |
H | F | L | H#3 |
H | O | O | H#3 |
Files can only be concatenated when H is specified as the segment type. Otherwise, the file specifications are ignored.
Segment type (combinations for concatenation) | File type |
---|---|
H + (file beginning with F) | Handled as a concatenated MCF receive message file. |
H + (file beginning with M) | |
H + (file beginning with L) | |
H + (file beginning with O) | |
H + (file beginning with #) | |
F, M, L, or O + (file beginning with any segment type) | The file following + is ignored. |
# + (file beginning with any segment type) | Handled as an invalid file specification. The system makes a file name inquiry. |
Do not use a plus sign (+), space, or tab code in the file name. Also, do not use ps or end as the file name.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.