HP 3000 Manuals

The FSC Error File [ HP DeskManager Customization ] MPE/iX 5.0 Documentation


HP DeskManager Customization

The FSC Error File 

The IPC file whose format is discussed here is used to describe the
identity of one or more MPE files that a foreign interface program has
been unable to bring into HP Desk.  There is only one IPC Error file for
each FSC format per system and it will be pre-built by HP Desk.

With both EFT and FSC, a file containing a message too big for the
current capacity of the database will cause an entry in the appropriate
error file.  FSC messages that are addressed to a mailnode unknown to the
receiving HP Desk computer will be delivered to the default configured
mailnode.

The characteristics of the error files are the same as those given by the
MPE commands:

     BUILD ERRARPA:MAILDB:HPOFFICE;REC=-80,,F,ASCII;MSG

for ARPA Standard and Compressed

     BUILD ERRAREF:MAILDB:HPOFFICE;REC=-80,,F,ASCII;MSG

for ARPA Reference.

The fields in each record of the Error file are:

Entry type: 

COBOL PIC S9(4) 

PASCAL smallint 

2 describes an ARPA Standard format file

3 describes an ARPA Reference format file

4 describes an ARPA Compressed format file

Filename: 

COBOL PIC X(36) 

PASCAL 36 chars packed 

Name of MPE file containing messages.

Filler: 

COBOL PIC S9(4) OCCURS 5 

PASCAL smallint times 5 

Reserved for future use.

Gateway name: 

COBOL PIC X(8) 

PASCAL 8 chars packed 

Name of the gateway from which messages are being received which, if not
blank, is for use when resolving foreign alias addresses.

Filler: 

COBOL PIC S9(4) OCCURS 3 

PASCAL smallint times 3 

Software level number: 

COBOL PIC S9(4) 

PASCAL smallint 

The version number of the FSC software that produced the files.  The
number will increase with each release of the software.

Failed message number: 

COBOL PIC S9(4) 

PASCAL smallint 

Set to the sequence number of the message (within the incoming message
file) that halted processing.  This is the number used as Start message
number in the incoming FSC file.

Error code: 

COBOL PIC S9(4) 

PASCAL smallint 

Gives the reason for failure.

1 is database full

3 is unrecognized entry/format type

5 is reference file access error

999 is other error, details of which are given in the job history for the
FSC truck.

Filler: 

COBOL PICS9(4) 

PASCAL smallint 

Suppress message header indicator: 

COBOL PIC S9(4) 

PASCAL smallint 

This indicates whether, when a message from a foreign system is brought
into HP Desk, the generation of the "Part 2 MESSAGE HEADER" should be
suppressed or not.

1 means suppression

Any other value means a message header should be generated.

Filler: 

Remaining bytes.

These are reserved for future use.

Sample FSC Error File 

     ERRARPA.MAILDB.HPOFFICE RECORD 0 (%0, #0)

     00000: 0002 5837 3631 3932 3533 2E48 5054 454C ..X7619253.HPTEL
     00010: 4558 2E48 504F 4646 4943 453B 2020 2020 EX.HPOFFICE;
     00020: SAME: TO 000030-1
     00030: 2020 2020 2020 2020 2020 2020 2020 0FA0               ..
     00040: 0000 03E7 2020 2020 2020 2020 2020 2020 ....

     ERRARPA.MAILDB.HPOFFICE RECORD 1 (%1, #1)

     00000: 0002 5730 3334 3732 312E 5052 4F46 534D ..W034721.PROFSM
     00010: 5347 2E48 504F 4646 4943 453B 2020 2020 SG.HPOFFICE;
     00020: SAME: TO 000030-1
     00030: 5245 4D47 4154 4532 2020 2020 2020 0FA0 REMGATE2      ..
     00040: 0002 03E7 2020 2020 2020 2020 2020 2020 ....

     ERRARPA.MAILDB.HPOFFICE RECORD 2 (%2, #2)

     00000: 0002 5730 3335 3032 342E 5052 4F46 534D ..W035024.PROFSM
     00010: 5347 2E48 504F 4646 4943 453B 2020 2020 SG.HPOFFICE;
     00020: SAME: TO 000030-1
     00030: 5245 4D47 4154 4532 2020 2020 2020 0FA0 REMGATE2      ..
     00040: 0006 03E7 2020 2020 2020 2020 2020 2020 ....

     ERRARPA.MAILDB.HPOFFICE RECORD 3 (%3, #3)

     00000: 0002 5831 3935 3332 3236 2E48 5054 454C ..X1953226.HPTEL
     00010: 4558 2E48 504F 4646 4943 453B 2020 2020 EX.HPOFFICE;
     00020: SAME: TO 000030-1
     00030: 2020 2020 2020 2020 2020 2020 2020 0FAD               ..
     00040: 0000 03E7 2020 2020 2020 2020 2020 2020 ....



MPE/iX 5.0 Documentation