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.