SENDSTREAM command
Use the SENDSTREAM command to send data from the message command file (INMSG) to Infor-mation Exchange. You can place the data immediately after the SENDSTREAM command in the command file. This command is valid only with session-level recovery.
Syntax
msgname(message name) msgseqno(message sequence no) class(class) verify(n|y|f) description(description) retain(retain time)
compress(n|y|t) selectrcv(n|f|blank);
Example
sendstream listname(list3) class(testclas) endstr(xxx);
Results: This data is sent to everyone who is defined in list3.
Parameters alias
Table type and table name of an alias table.
aliasname
Alias name defined in the alias table. Use 1 to 16 alphanumeric characters.
sysid
System ID of a single destination user ID. You need the system ID only if you specify the
ACCOUNT and USERID parameters for a user on another Information Exchange system. If you specify a SYSID parameter, you must specify the ACCOUNT and USERID parameters. Use 1 to 3 alphanumeric characters.
blank An alias name was not used. This is the default.
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.
NOTE: You create and maintain alias tables by using Information Exchange Administration Services (see Information Exchange Administration Services User’s Guide), or by using the DEFINEALIAS command (see “DEFINEALIAS command” on page 94).
SENDSTREAM command
account
Account ID of a single destination user ID to whom you are sending data. Expedite Base/400 uses this field together with the USERID parameter to identify the user. If you specify an
ACCOUNT parameter, you must also specify a USERID parameter. Use 1 to 8 alphanumeric characters.
userid
User ID of an Information Exchange user to whom you are sending data. Expedite Base/400 uses this field together with the ACCOUNT parameter to identify the user. If you specify a
USERID parameter, you must also specify an ACCOUNT parameter. Use 1 to 8 alphanumeric characters.
listname
Name of a previously defined list of account IDs and user IDs. Use 1 to 8 alphanumeric characters.
endstr
Character string used to mark the end of the data contained in the command stream. You can split the end string across record boundaries. Use 1 to 79 alphanumeric characters. This parameter is required.
datatype
Indicates whether the data is EBCDIC or binary. ASCII systems translate EBCDIC data to ASCII when they receive it from Information Exchange. For more information on EBCDIC and binary data, see Chapter 3, “Communicating with other operating systems.’’
mode
Indicates whether the file is a test file or a normal file.
priority
Class of delivery service for this data.
charge
Indicates how you would like the charges paid.
e EBCDIC data. This is the default.
b Binary data.
blank Normal file. This is the default.
t Test-mode file.
blank Normal priority. This is the default.
i Express delivery to those users who have the continuous receive capability and are currently in session with Information Exchange. (Expedite
Base/400 does not support the continuous receive capability.)
p High priority.
1 Receiver pays all charges.
SENDSTREAM command
ack
Type of acknowledgments you want to receive from Information Exchange.
msgname
User-specified name for the data. Use 1 to 8 alphanumeric characters.
msgseqno
User-specified message control number for the data. Use 1 to 5 alphanumeric characters.
class
Unique, user-specified name for the data. A receiver can then use this name to receive only files of this class. Use 1 to 8 alphanumeric characters.
verify
Verifies that the receiver exists before sending the data.
If you request verification, you might incur an Information Exchange message charge. See
“Validating addresses, payment levels, and authorizations” on page 67 for more information.
description
Free-format description of the data sent. Use 1 to 79 alphanumeric characters.
3 Receiver pays all charges if agreed to; otherwise, the sender and receiver split the charges, if agreed to by the receiver. Otherwise, the sender pays all charges. This is the default.
4 Sender and receiver split the charges, if agreed to by the receiver. Otherwise, the sender pays all charges.
5 Sender and receiver split the charges.
6 Sender pays all charges.
blank No acknowledgments are created. This is the default.
a Purge acknowledgments only.
b Both receipt and delivery acknowledgments.
c Both receipt and purge acknowledgments.
d Delivery acknowledgments only. It queues the delivery acknowledgments to the user ID when Information Exchange delivers the data to a destination user ID and reaches a subsequent recovery point with that destination user ID.
e Either a purge or a delivery acknowledgment.
f Receipt and either a purge or a delivery acknowledgment.
r Receipt acknowledgments only when Expedite Base/400 finishes sending a file.
n Do not verify that the receiver exists. This is the default.
y Verify that the receiver exists before sending the data.
f Verify that the receiver exists. If Information Exchange cannot tell whether the receiver exists (for example, if the receiver is on another system), send the data anyway.
SENDSTREAM command
retain
Number of days Information Exchange keeps the file if the receiver does not receive it. Valid values are blank and 0 through 180.
The maximum retention period and the default retention period can be different on different Information Exchange systems. These periods are system-dependent. The default retention period is determined when Information Exchange is installed. For installations in the U.S., the default retention period is 30 days. Contact your marketing representative for more infor-mation on these values.
If you specify 0 or blank, Information Exchange retains the file for the default retention period. If you specify a retention period that is longer than the maximum retention period for your system, Information Exchange retains the file for the default retention period.
compress
Indicates whether the specified file should be compressed.
You must have the supported compression software installed to use data compression.
Some of the parameters of this command may work differently when sending compressed data; see Appendix D, “Using data compression,’’ for more information.
selectrcv
Indicates whether the file should be marked in Information Exchange so that the file cannot be received by a blanket receive.
When f is selected in SELECTRCV, the file being sent is marked in Information Exchange and cannot be received by a blanket receive. The file can only be received if the receiver specifies one of the following:
• Sender ID (account ID and user ID)
• Message class
• Message key
n Do not compress the specified file. This is the default.
y Compress the specified file.
t For each sender/receiver pair, use the setting of the COMPRESS parameter (y or n) indicated in the CPLOOKUP table.
If the receiver/sender pair is not in the CPLOOKUP table, send the data, and write a warning to the response file, OUTMSG.
n Allows the file to be received by a blanket receive.
f Marks the file in Information Exchange so that the file cannot be received by a blanket receive.
blank Allows the file to be received by a blanket receive. This is the default.