PUTMEMBER command
Use the PUTMEMBER command to add a member to an existing Information Exchange library.
Syntax putmember
owner(library owner account) library(library name) member(member name) fileid(file ID)
replace(n|y) format(n|y) class(class) ack(blank|d)
msgname(message name) msgseqno(message sequence no) datatype(e|b) truncate(n|y) delimit(n|c|l) crlfeof(crlfeof) verify(n|y) description(description)
destfile(destination file name) destloc(destination file location);
Example
putmember owner(abcsales) library(sales1) member(1q04) fileid(myfiles/prices(send1));
Results: The member prices is placed in 1q04 in sales1 under the owner abcsales. If more than one such file exists in your mailbox, it is appended to prices.
Parameters library
Name of the library to update. Use 1 to 8 alphanumeric characters.
member
Name of the member as it should appear in the library. Use 1 to 8 alphanumeric characters.
owner
Library owner’s account. The default is your account. Use 1 to 8 alphanumeric characters.
fileid
File to be sent. Use 1 to 33 alphanumeric characters. Format is:
library/filename(member)
NOTE: You must have authority to update the library or you will receive a system error message in your mailbox.
PUTMEMBER command
replace
Indicates whether a member with the same name should replace an existing library member.
format
Specifies whether you want the data sent as a file or as a free-format message.
class
Specific name for the data. A receiver can use this name to receive only files of this class. If you specify FORMAT(y), Expedite Base/400 defaults to ffmsg001; otherwise, the
Expedite Base/400 defaults to blank. Use 1 to 8 alphanumeric characters.
ack
Type of acknowledgments you want to receive from Information Exchange.
msgname
Name you specify for the file. Use 1 to 8 alphanumeric characters.
msgseqno
Number you assign to the data as a message control number. Use 1 to 5 alphanumeric characters.
datatype
Indicates whether the data is EBCDIC or binary. ASCII systems translate EBCDIC data to ASCII when they receive it from Information Exchange.
truncate
Indicates whether you want the Expedite Base/400 to remove trailing blanks from each record before sending them to Information Exchange.
y Replace the member with the same name as an existing member in the library.
n Do not replace the member with the same name as an existing member in the library. This is the default.
y Format the data as a free-format message. This implies fixed 79-byte records.
Expedite Base/400 pads records with blanks. You cannot specify DATATYPE(B),
DELIMIT(B), or DELIMIT(L) with this option.
n Send the data without free-format message formatting. This is the default.
blank No acknowledgments created. This is the default.
d Delivery acknowledgments only. Acknowledgments are queued to the user ID when Information Exchange delivers the data to the library and reaches a subsequent recovery point with the same destination user ID.
e EBCDIC data. This is the default.
b Binary data.
y Truncate trailing blanks.
n Do not truncate trailing blanks. This is the default.
PUTMEMBER command
delimit
Specifies how to preserve the record structure of the file. Expedite Base/400 inserts the appropriate delimiter type into the data and puts the appropriate information into the CDH for the receiver’s use.
crlfeof
Redefines the carriage-return, line-feed, and end-of-file characters used with the DELIMIT(C) option. You need this parameter when sending to a PC that receives with a translate table other than the standard Information Exchange translate table. Use 6 hexadecimal characters.
The default value is 0D0A1A.
verify
Verifies that the library is defined and that you have update access before sending the file.
You cannot verify a library if it resides on another system.
When you use the VERIFY parameter on the PUTMEMBER command, you are not charged for the verification request.
description
Provides a free-format description of the file. Use 1 to 79 alphanumeric characters. The description is only available to receiving interfaces that support the CDH. For more infor-mation on the CDH, see Appendix B, “Common data header (CDH).’’
destfile
File name to be used in the CDH as the original file name. If the receiver is using a workstation-based Expedite program and specifies ORIGFILE(Y) on the RECEIVE or
RECEIVEEDI command, then Expedite Base uses this file name to store the data when it is received. If you specify a file name that is not valid on the receiver’s system, then Expedite Base uses the file name specified by the receiver in the FILEID parameter on the RECEIVE or
RECEIVEEDI command. By default, Expedite Base determines the original file name from the
FILEID parameter on the SEND, SENDEDI, or PUTMEMBER command. Use 1 to 54 characters.
destloc
File location to be used in the CDH. When the file is received or the receiver’s mailbox is c You want the records delimited by CRLF characters. Expedite Base/400 inserts
X‘0D0A’ at the end of each record to indicate the record structure.
Expedite Base/400 ends the file with XX‘1A’. You can change the CRLFEOF characters with the CRLFEOF parameter.
l You want the records delimited with delimiters that are 2 bytes long.
Expedite Base/400 inserts a 2-byte delimiter at the beginning of each record to delineate the record structure.
n You want to send the records with no record delimiters. This is the default.
y Verify that the library is defined and that you have update access before sending the file. If you cannot verify the library for either reason, the file is not sent and there is a WARNING record in the output file for this command.
n Do not verify that the library is defined or that you have access. This is the default.
PUTMEMBER command
Notes:
1) Expedite Base/400 users who want to implement the DESTFILE and DESTLOC feature must be using an Expedite Base Version 4 Release 3 or later product on both the sending and receiving systems.
2) Expedite Base/400 does not support the ORIGFILE parameter on the RECEIVE or
RECEIVEEDI commands. Users on this system must allocate the receive file before running Expedite, and must specify the file name on the RECEIVE or RECEIVEEDI commands.