• No results found

RECEIVED record

In document Expedite Base/400 Programming Guide (Page 182-189)

Expedite Base/400 produces a RECEIVED record for every file or EDI envelope received from Information Exchange. This record contains information describing the received data.

Format

MSGDATE(message date) MSGDATELONG(message date long format) MSGTIME(message time)

FILEDATE(file date) FILEDATELONG(file date long format) FILETIME(file time) RECFM(record format) RECLEN(record length) RECDLM(c|e|l|n)

DESCRIPTION(description) UNIQUEID(unique ID) CODEPAGE(code page) SYSTYPE(01|10|11|12|14|15|16|17|19|20|21|22|30|31|33|40|44|61|62|71|80|90|91) SYSVER(system version) TRANSLATE(xlate table)

COMSW(compression software name) COMVER(compression software version) COMFILE(name of compressed file) DCMPRC(decompression return code);

Parameters ALIAS

Table type and table name of an alias table.

ALIASNAME

Alias name defined in the alias table. This parameter contains 1 to 16 alphanumeric characters.

gxxx Global alias table, where xxx identifies a 1- to 3-character table name.

oxxx Organizational alias table, where xxx identifies a 1- to 3-character table name.

pxxx Private alias table, where xxx identifies a 1- to 3-character table name. This parameter contains 1 to 4 alphanumeric characters.

OUTMSG response records

SYSID

System ID of the user who sent the message. This parameter contains 1 to 3 alphanumeric characters.

ACCOUNT

Account of the user who sent the message. This parameter contains 1 to 8 alphanumeric characters.

USERID

User ID of the user who sent the message. This parameter contains 1 to 8 alphanumeric characters.

RECEIVER

Receiver ID specified in the EDI data. This parameter contains 1 to 35 characters.

RECVQUAL

EDI qualifier for the receiver specified in the EDI data. This parameter contains 1 to 4 characters.

SENDER

Sender ID specified in the EDI data. This parameter contains 1 to 35 characters.

SENDQUAL

EDI qualifier for the sender specified in the EDI data.

CONTROLNUM

Interchange Control Number from the X12 or UCS data. For UN/TDI data, this is the SNRF element. For EDIFACT data, this is the element 0020 (Interchange Control Reference). This parameter contains 1 to 14 characters.

CLASS

User class of the data specified by the sender to identify the data. This parameter contains 1 to 8 alphanumeric characters.

MODE

Sender-specified network data class field for this data. This parameter does not appear in the record for a message that is not test mode (indicated by the value T).

PRIORITY

Class of delivery service for this file. This parameter does not appear in the record for a normal-priority message.

CHARGE

Indicates how the file charges will be paid.

a Normal-priority requeued archive message

i Express delivery to those users who have the continuous receive capability (Expedite Base/400 does not support the continuous receive capability.) p High priority

OUTMSG response records

ACK

Indicates whether delivery was successful. If the sender asked Information Exchange to send a delivery acknowledgment, this value is set to D. Otherwise, this parameter is omitted.

LENGTH

Length of the received file. This parameter contains 1 to 9 alphanumeric characters.

FILEID

Name of the file in which Expedite Base/400 placed the data received. This parameter contains 1 to 33 alphanumeric characters.

MSGDATE

Date the data received was placed into Information Exchange. The format of this parameter is YYMMDD.

MSGDATELONG

Long format of MSGDATE. The format is YYYYMMDD. The YY value from MSGDATE is inter-preted by Expedite Base/400 as YYYY.

MSGTIME

Time the data received was placed into Information Exchange. The format of this parameter is HHMMSS.

MSGSEQO

Unique number assigned to the data by Information Exchange. This parameter contains 1 to 6 numeric characters.

MSGNAME

Name for the data specified by the sender. This parameter contains 1 to 8 alphanumeric characters.

MSGSEQNO

Number assigned by the sender as a file control number for this data. This parameter contains 1 to 5 alphanumeric characters.

SESSIONKEY

Session access key that Expedite Base/400 used when the file was received. This value is the archive ID for the file if you did not specify an ARCHIVEID parameter in the RECEIVE,

RECEIVEEDI, or RECEIVESTREAM command. This parameter contains 1 to 8 alphanumeric characters.

DELIMITED

Indicates how Expedite Base/400 processed record delimiters when the file was received.

c Expedite Base/400 split records at carriage-return/line-feed (CRLF) characters.

l Expedite Base/400 split records according to the 2-byte length delimiters at the beginning of each record.

e Expedite Base/400 split records according to EDI delimiters. If you specified

EDIOPT(n), the records are split according to the length of the data set.

n Expedite Base/400 stored the data as it was received. The record length of the data depends on the record length of the data set allocated to receive the data, or on the format option.

OUTMSG response records

SYSNAME

Name of the system that sent the data. This parameter contains 1 to 8 alphanumeric characters.

SYSLEVEL

Level of the system that sent the data. This parameter contains 1 to 4 alphanumeric characters.

STARTDATE

Starting date for files received from Information Exchange. The format is YYMMDD or YYYYMMDD. This parameter contains up to 8 numeric characters.

STARTTIME

Starting time for files received from Information Exchange. The format is HHMMSS. This parameter contains 6 numeric characters.

ENDDATE

Ending date for files received from Information Exchange. The format is YYMMDD or YYYYMMDD. This parameter contains up to 8 numeric characters. This parameter contains 6 numeric characters.

ENDTIME

Ending time for files received from Information Exchange. The format is HHMMSS. This parameter contains 6 numeric characters.

TIMEZONE

Time zone reference for the STARTTIME and ENDTIME parameters.

DATATYPE

Type of data (EBCDIC or binary).

EDITYPE

Type of EDI data received (X12, UCS, UNTDI, EDIFACT, or unformatted). This parameter contains 1 to 11 alphanumeric characters.

SENDERFILE

File name the data had on the sender's system. This parameter contains 1 to 33 alphanumeric characters.

SENDERLOC

Location of the file on the sender's system. This parameter contains 1 to 65 alphanumeric characters.

FILEDATE

l Local time, as defined on the TIMEZONE parameter of the IDENTIFY command.

g Greenwich mean time (GMT)

e EBCDIC b Binary

OUTMSG response records

FILETIME

Time of the file on the sender's system. The format is HHMMSS.

RECFM

Record format of the file on the sender's system. If the record format is not appropriate for the sending machine (for example, if the sending machine is a PC), the value is ????. This parameter contains 1 to 4 alphanumeric characters.

RECLEN

Record length of the file on the sender's system. This parameter contains 1 to 5 numeric characters.

RECDLM

Method used to delimit the records.

DESCRIPTION

Free-format description of the data given by the sender. This parameter contains 1 to 79 alphanumeric characters.

UNIQUEID

Random ID assigned to the data by the sending interface. It helps you identify the data. This parameter contains 8 alphanumeric characters.

CODEPAGE

Code page used by the sending system to determine the character representation of a given byte. This parameter contains 3 numeric characters.

SYSTYPE

Type of system that sent the data. The codes for the systems are as follows:

c CRLF characters delimit the records.

e EDI characters delimit the records.

l A 2-byte length preceding each record delimits the records.

n The records contain no delimiters, or the sender did not indicate the type of delim-iters.

01 Unknown system type 10 expEDIte/PC

11 Expedite Base/2

12 Expedite Base for AIX 14 Expedite Base for SCO UNIX 15 Expedite Base/DOS

16 Expedite Base for SCO XENIX 17 Expedite Base for Windows 19 Expedite for Windows 20 expEDIte/MVS Host

21 Expedite Base/MVS

OUTMSG response records

SYSVER

Software version of the system sending the data. This parameter contains 1 to 3 numeric characters.

TRANSLATE

ASCII-to-EBCDIC translate table used when this file was sent to Information Exchange.

This parameter contains 1 to 8 alphanumeric characters.

COMSW

Name of the software compression package used to compress the file. This parameter contains 10 alphanumeric characters.

COMVER

Version of the compression software package used to compress the file. This parameter contains 1 to 5 alphanumeric characters.

COMFILE

Name of the compressed file. This parameter contains 1 to 54 alphanumeric characters.

DCMPRC

Return code from decompression processing. This parameter contains 1 to 5 alphanumeric characters.

22 Information Exchange File Transfer Protocol

30 Mail Exchange

31 Expedite Base/VM 33 X.400 Gateway 40 Expedite/Direct 44 EDI VAN Interconnect 61 EDI Server

62 IBM Exchange for Websphere MQ 71 Expedite Base/400

80 Expedite/CICS

90 Information Exchange Administration Services 91 Expedite/Async

OUTMSG response records

RETURN record

The RETURN record indicates the completion of a command in INPRO or INMSG. A zero value indicates that the command completed normally.

Format

RETURN(return) ERRDESC(error description) REASON(reason) ERRTEXT(error text)...

SESSIONKEY(session key)

Parameters RETURN

Completion code for the Expedite Base/400 command. If the return code is zero, the command completed normally. If the return code is not zero, Expedite Base/400 displays an error number and possibly ERRDESC, REASON, and ERRTEXT values. This parameter contains 5 numeric characters.

ERRDESC

Short description of the error condition. If the return code is zero, Expedite Base/400 does not display this parameter. This parameter contains 1 to 80 alphanumeric characters.

REASON

Cause of the error. If Expedite Base/400 includes REASON in the record, it gives more infor-mation about what caused the error. Expedite Base/400 usually includes REASON when an error occurs opening a file. This parameter contains 1 to 240 alphanumeric characters.

ERRTEXT

Detailed description of an error which might suggest steps to correct the problem. Expedite Base/400 might include this parameter more than once in a record if the error text consists of multiple lines. This parameter contains 1 to 80 alphanumeric characters.

SESSIONKEY

Session access key provided by Information Exchange upon a successful session start. The session access key is only provided after a START command. When the RETURN record contains a session access key, this is the only parameter included in the record.

OUTMSG response records

In document Expedite Base/400 Programming Guide (Page 182-189)