GETMEMBER command
Use the GETMEMBER command to copy a member from an existing Information Exchange library to an Information Exchange mailbox. When the member is available in the mailbox, specify a
RECEIVE command as the next command in the input file to receive this member. You should use the RECEIVE or RECEIVESTREAM command as usual to receive the data from the mailbox to your system. If the destination is left blank on the GETMEMBER command, the default will be your own mailbox. The MSGNAME, MSGSEQNO, and CLASS parameters, if not specified, will default to values indicated when the member was stored in the library.
The library member requested may not be immediately available in your Information Exchange mailbox. If you do not receive the member and the GETMEMBER command (a RETURN(00000) code) completed successfully, try to receive the member in a subsequent session.
Syntax
Results: The member prices is retrieved from 1q04 in sales1 under the owner abcsales. If more than one such file exists in your mailbox, it is appended to prices.
Parameters owner
Owner of the account of the requested library. The default is your own account. Use 1 to 8 alphanumeric characters.
library
Library from which the member is to be copied. Use 1 to 8 alphanumeric characters.
member
Library member to be copied. Use 1 to 8 alphanumeric characters.
sysid
System ID of an Information Exchange system user receiving the member. 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
GETMEMBER command
account
Account name of the Information Exchange user receiving the file. Expedite Base/400 uses this field together with the USERID parameter to identify the user. If you specify an ACCOUNT
parameter, you must specify a USERID parameter. Use 1 to 8 alphanumeric characters. The default is your own account.
userid
User ID of the Information Exchange user receiving the member. Expedite Base/400 uses this field together with the ACCOUNT parameter to identify the user. If you specify a USERID
parameter, you must specify an ACCOUNT parameter. Use 1 to 8 alphanumeric characters.
The default is your own user ID.
alias
Table type and table name of an alias table. This field is used in conjunction with the
ALIASNAME parameter to identify the user receiving the file.
aliasname
Alias name defined in the alias table. This field is used in conjunction with the ALIAS
parameter to identify the user receiving the file. Use 1 to 16 alphanumeric characters.
listname
Name of a previously defined list of accounts and user IDs. This field is used to identify the list of users receiving the file. Use 1 to 8 alphanumeric characters.
msgname
Name you specify for the file. Use 1 to 8 alphanumeric characters.
msgseqno
Number assigned by you as a message control number for the data. Use 1 to 5 alphanumeric characters.
class
Specific name for the data. A receiver can use this name to receive only files of this class.
The default is blank.
charge
Specifies how the sender wants the file charges paid.
blank An alias name was not used. This is the default.
gxxx Global alias table, where xxx identifies a 1- to 3-character table.
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 Using Information Exchange Administration Services), or by using the DEFINEALIAS command (see
“DEFINEALIAS command” on page 94).
1 The receiver pays all charges.
GETMEMBER command
ack
Type of acknowledgments you want to receive from Information Exchange.
retain
Number of days Information Exchange keeps the file in the mailbox if no one receives 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.
5 The library owner pays the receive charge, if agreed to by the library owner.
Otherwise, the receiver pays.
6 The library owner pays the receive charge.
blank No acknowledgments 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. Acknowledgments are queued to the user ID when Information Exchange delivers the data to a destination user ID and reaches a subsequent recovery point with the same destination user ID.
e Either purge or delivery acknowledgments.
f Receipt acknowledgments and either purge or delivery acknowledgments.
r Receipt acknowledgments only when Expedite Base/400 finishes sending a file.
NOTE: Expedite Base/400 sends the receipt acknowledgment to whomever is paying for the GETMEMBER request. This is either the library owner or the individual who requested the member (issued the GETMEMBER command).