IBM AS/400e Computer Hardware User Manual


 
Transferring QSYS.LIB Files
Table 23 and Table 24 on page 264 summarize FTP operations in stream transfer
mode and in image transfer type for the QSYS.LIB file system. Keep the following
in mind when using these tables:
v Compatible record length and file size
When you send data to a file that already exists, the record and file size of the
receiving file must be compatible with the file being sent or a transfer error will
occur. Both the record and file size of the receiving file must be greater than or
equal to the source file record and file size. To determine if the existing file size
is compatible you need to consider the current number of records, the number of
extensions allowed, and the maximum record size allowed. You can view this
information by entering the AS/400 Display File Description (DSPFD) command.
v Automatic file creation on the AS/400 system
When receiving a file, the AS/400 system automatically creates a physical file, if
one does not already exist.
However, it is recommended that you pre-create the file on the AS/400. This is
discussed in “AS/400 File Pre-Creation” on page 264.
v When transferring data using TYPE I, the data is not converted. If the file does
not exist, it is tagged with CCSID 65535 when it is created.
Note: File pre-creation is advised when using the MGET and MPUT subcommands
to transfer files with multiple members. When a file is not pre-created, FTP
creates a file with a maximum record length equal to the longest record of
the first member processed. If the record length of any other file member is
longer, a data truncation error will occur when transferring that member.
Pre-creating a file with a record size to accommodate all members will
prevent this error.
Table 23. Stream Transfer Mode for QSYS.LIB File System
Compatible
Library
Exists
File
Exists
Member
Exists
Replace
Selected
Record
Length File Size Result
Yes Yes Yes Yes Yes Yes Data written to member
Yes Yes Yes No N/A N/A Transfer rejected and message sent.
Yes Yes No N/A No Yes File transfer completed, records truncated,
and message returned.
Yes Yes No Yes No Yes File transfer completed, records truncated,
and message returned.
Yes Yes No N/A Yes Yes Member created and data written to it
Yes Yes No No N/A No Transfer rejected and message sent
Yes No N/A N/A N/A N/A File created with record length equal to
the maximum record length of the
incoming file. Member created and data
written to member.
No N/A N/A N/A N/A N/A Transfer rejected and message sent. Use
the CRTLIB CL command to create a
library on the remote AS/400 system.
Chapter 7. File Transfer Protocol (FTP) Client 263