HP 3000 Manuals HP 3000 Manuals
EFT File Structures
IPC Files for Outgoing EFT Messages
The IPC file whose format is shown below is used to describe the identity
and destination of one or more MPE files containing messages to be
transmitted by an external transport system.
There is one IPC file for each external transport system, that is, one
for each gateway known to the local computer. The IPC file for the
gateway must be built before the external transport system can be used.
The format of an EFT outgoing IPC file is the same as that of an FSC
outgoing IPC file. Refer to Chapter 13 for a sample file. The
characteristics of the IPC file must be the same as if it were to be
built by the following MPE command:
BUILD filename;REC=-80,,,ASCII;MSG
The length of each record in the IPC file is 80 bytes. The fields in
each record are:
Entry type
COBOL pic S9(4)
PASCAL smallint
1 in this field describes an HP Desk internal format file (EFT).
Note that smallint is defined in a PASCAL program as:
TYPE smallint= -32768...32767;
Filename
COBOL pic X(36)
PASCAL 36 chars packed
Name of MPE file containing messages.
Note that 36 chars packed is defined in a PASCAL program as:
VAR filename:PACKED ARRAY [1..36] OF char;
Filler
COBOL PIC S9(4)
PASCAL smallint
These are reserved for future use.
Target mailnode
COBOL PIC X(8)
PASCAL 8 chars packed
This is the HP Desk location and sublocation of the target mailnode as
configured.
Note that 8 chars packed is defined in a PASCAL program as:
VAR target_node:PACKED ARRAY [1..8] OF char;
Gateway name
COBOL PIC X(8)
PASCAL 8 chars packed
Time
COBOL PIC S9(8)
PASCAL integer
The time that the entry was written to the IPC file in CLOCK format.
Date
COBOL PIC S9(4)
PASCAL smallint
The date that this entry was written to the IPC file in CALENDAR format.
Software level number
COBOL PIC S9(4)
PASCAL smallint
The version number of the EFT software that produced the file. The
number will increase with each release of the software; the increment may
be greater than one.
Filler
COBOL PIC S9(8)
PASCAL integer
This is reserved for future use.
Privileged file indicator
COBOL PIC S9(4)
PASCAL smallint
Shows whether the file is privileged or not:
0 means the file is a normal file
1 means the file is a privileged file
Filler
Remaining bytes.
These are reserved for future use.
IPC File for Incoming EFT Messages
This IPC file is used to describe the identity of an MPE file delivered
by an external transport system and containing the HP Desk internal
format messages which need to be brought in to HP Desk.
On any system there is only one incoming IPC file for EFT. This is
pre-built by an MPE command which varies depending on the format used by
the gateway. The MPE command for EFT format files is:
BUILD EFTIPCIN.MAILDB.HPOFFICE;REC=-80,,F,ASCII;MSG
The length of each record in the IPC file is 80 bytes.
The fields in each record are:
Entry type
COBOL PIC S9(4)
PASCAL smallint
1 is used to describe an HP Desk internal format serialized file.
Filename
COBOL PIC X(36)
PASCAL 36 chars packed
Name of the MPE file containing the incoming messages.
Filler
COBOL PIC S9(4) OCCURS 5
PASCAL smallint times 5
Gateway name
COBOL PIC X(8)
PASCAL 8 chars packed
This field is not applicable to EFT.
Filler
COBOL PIC S9(4) OCCURS 4
PASCAL smallint times 4
Start message number
COBOL PIC S9(4)
PASCAL smallint
This field is not applicable to EFT.
Filler
COBOL PIC S9(4) OCCURS 2
PASCAL smallint times 2
Suppress message header indicator
COBOL PIC S9(4)
PASCAL smallint
This field is not applicable to EFT.
Filler
Remaining bytes.
These are reserved for future use.
Sample EFTIPCIN File Format
EFTIPCIN.MAILDB.HPOFFICE RECORD 0 (%0, #0)
00000: 0001 4530 3532 3039 3436 2E48 504D 4149 ..E0520946.HPMAI
00010: 4C2E 4850 4F46 4649 4345 3B20 2020 2020 L.HPOFFICE;
00020: SAME: TO 000050-1
EFTIPCIN.MAILDB.HPOFFICE RECORD 1 (%1, #1)
00000: 0001 4530 3532 3130 3136 2E48 504D 4149 ..E0521016.HPMAI
00010: 4C2E 4850 4F46 4649 4345 3B20 2020 2020 L.HPOFFICE;
00020: SAME: TO 000050-1
EFTIPCIN.MAILDB.HPOFFICE RECORD 2 (%2, #2)
00000: 0001 4530 3532 3130 3137 2E48 504D 4149 ..E0521017.HPMAI
00010: 4C2E 4850 4F46 4649 4345 3B20 2020 2020 L.HPOFFICE;
00020: SAME: TO 000050-1
The hex codes on the left are printed out on the right with non-printable
characters represented by periods (.). This IPC file is clearly EFTIPCIN
and therefore is the system IPC file for incoming messages received from
a foreign transport system in HP Desk serialized internal format. Each
record defines an MPE file which resides in the group HPMAIL.HPOFFICE.
Structure of EFT Data Files
HP Desk internal format (EFT) files contain messages taken from a single
mail node queue which are intended to be delivered to another HP Desk
site. The transporting program does not need to have any knowledge of
the internal format. All the addressing information will have been
passed by the IPC file interface.
The characteristics of this file are the same as those given by the MPE
command:
BUILD name; REC=128,1,F,BINARY,DISC=1024,8,1
At the start of each file is a descriptor record which contains the
following fields:
Entry
COBOL PIC S9(4)
PASCAL smallint
This value should always be set to "1" for a "serialized" file destined
for an HP Desk mailnode.
Target mailnode
COBOL PIC X(8)
PASCAL 8 chars packed
Location/sublocation code of target destination.
Originating computer system
COBOL PIC X(8)
PASCAL 8 chars packed
Computer name of HP Desk system that created this file.
Filler
Remaining bytes.
These are reserved for future use.
Sample File
E0611351.HPMAIL.HPOFFICE RECORD 0 (%0, #0)
00000: 0001 4850 3737 3737 3030 4845 524D 4553 ..HP777700HERMES
00010: 2020 2020 2020 2020 2020 2020 2020 2020
00020: SAME: TO 000200-1
E0611351.HPMAIL.HPOFFICE RECORD 1 (%1, #1)
00000: 0000 0003 0000 0000 0000 0000 0000 0000 ................
00010: SAME: TO 000200-1
E0611351.HPMAIL.HPOFFICE RECORD 2 (%2, #2)
00000: SAME: TO 000200-1
:
:
:
:
This is an example of a descriptor record which would be followed by one
or more serialized messages. The messages on this file are destined for
the HP Desk mailnode HP7777/00 and this particular message was originated
on the computer system known as HERMES. The format of an incoming HP Desk
internal format MPE file is identical to this outgoing one.