205 lines
10 KiB
HTML
205 lines
10 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="reference" />
|
||
|
|
<meta name="DC.Title" content="Transfer QSYS.LIB files" />
|
||
|
|
<meta name="abstract" content="This topic discusses the FTP operations for the QSYS.LIB file system." />
|
||
|
|
<meta name="description" content="This topic discusses the FTP operations for the QSYS.LIB file system." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqfrmt.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqreferencedt6a.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiqreferencedt7.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzaiqreferencedt6" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>Transfer QSYS.LIB files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzaiqreferencedt6"><a name="rzaiqreferencedt6"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Transfer QSYS.LIB files</h1>
|
||
|
|
<div><p>This topic discusses the FTP operations for the QSYS.LIB file system.</p>
|
||
|
|
<div class="section"><p><a href="#rzaiqreferencedt6__referencedt6one">Table 1</a> and <a href="#rzaiqreferencedt6__referencedt6two">Table 2</a> summarize FTP operations
|
||
|
|
in stream transfer mode and in image transfer type for the QSYS.LIB file system.
|
||
|
|
Keep the following points in mind when using these tables:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Compatible record length and file size</h4><p>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 iSeries™ Display File Description (DSPFD)
|
||
|
|
command.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Automatic file creation on the iSeries server</h4><p>When receiving
|
||
|
|
a file, the iSeries server
|
||
|
|
automatically creates a physical file, if one does not already exist. However,
|
||
|
|
it is recommended that you pre-create the file on the iSeries.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Data type</h4><p>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.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> 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.</div>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><a name="rzaiqreferencedt6__referencedt6one"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaiqreferencedt6__referencedt6one" frame="border" border="1" rules="all"><caption>Table 1. Stream
|
||
|
|
transfer mode for QSYS.LIB file system</caption><thead align="left"><tr><th valign="top" id="d0e65">Library exists</th>
|
||
|
|
<th valign="top" id="d0e67">File exists</th>
|
||
|
|
<th valign="top" id="d0e69">Member exists</th>
|
||
|
|
<th valign="top" id="d0e71">Replace selected</th>
|
||
|
|
<th valign="top" id="d0e73">Compatible record length</th>
|
||
|
|
<th valign="top" id="d0e75">Compatible file size</th>
|
||
|
|
<th valign="top" id="d0e77">Result</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e69 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e71 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e73 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e75 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e77 ">Data written to member.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e69 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e71 ">No</td>
|
||
|
|
<td valign="top" headers="d0e73 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e75 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e77 ">Transfer rejected and message sent.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e69 ">No</td>
|
||
|
|
<td valign="top" headers="d0e71 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e73 ">No</td>
|
||
|
|
<td valign="top" headers="d0e75 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e77 ">File transfer completed, records truncated, and message returned.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e69 ">No</td>
|
||
|
|
<td valign="top" headers="d0e71 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e73 ">No</td>
|
||
|
|
<td valign="top" headers="d0e75 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e77 ">File transfer completed, records truncated, and message returned.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e69 ">No</td>
|
||
|
|
<td valign="top" headers="d0e71 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e73 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e75 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e77 ">Member created and data written to it.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e69 ">No</td>
|
||
|
|
<td valign="top" headers="d0e71 ">No</td>
|
||
|
|
<td valign="top" headers="d0e73 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e75 ">No</td>
|
||
|
|
<td valign="top" headers="d0e77 ">Transfer rejected and message sent.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e67 ">No</td>
|
||
|
|
<td valign="top" headers="d0e69 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e71 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e73 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e75 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e77 ">File created with record length equal to the maximum record length
|
||
|
|
of the incoming file. Member created and data written to member.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e65 ">No</td>
|
||
|
|
<td valign="top" headers="d0e67 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e69 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e71 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e73 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e75 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e77 ">Transfer rejected and message sent. Use the CRTLIB command to create
|
||
|
|
a library on the remote iSeries server.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><a name="rzaiqreferencedt6__referencedt6two"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaiqreferencedt6__referencedt6two" frame="border" border="1" rules="all"><caption>Table 2. Image transfer type for QSYS.LIB
|
||
|
|
file system</caption><thead align="left"><tr><th valign="top" id="d0e214">Library exists</th>
|
||
|
|
<th valign="top" id="d0e216">File exists</th>
|
||
|
|
<th valign="top" id="d0e218">Member exists</th>
|
||
|
|
<th valign="top" id="d0e220">Replace selected</th>
|
||
|
|
<th valign="top" id="d0e222">Result</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" headers="d0e214 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e216 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e218 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e220 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e222 ">Data written to member.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e214 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e216 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e218 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e220 ">No</td>
|
||
|
|
<td valign="top" headers="d0e222 ">Transfer rejected and message sent.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e214 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e216 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e218 ">No</td>
|
||
|
|
<td valign="top" headers="d0e220 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e222 ">Member created and data</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e214 ">Yes</td>
|
||
|
|
<td valign="top" headers="d0e216 ">No</td>
|
||
|
|
<td valign="top" headers="d0e218 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e220 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e222 "> </td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" headers="d0e214 ">No</td>
|
||
|
|
<td valign="top" headers="d0e216 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e218 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e220 ">N/A</td>
|
||
|
|
<td valign="top" headers="d0e222 "> </td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaiqreferencedt6a.htm">Receive text files to QSYS.LIB</a></strong><br />
|
||
|
|
Because the iSeries QSYS.LIB file system internally supports
|
||
|
|
a record structure, the iSeries File Transfer Protocol (FTP) converts files
|
||
|
|
received on the iSeries server
|
||
|
|
into a record structure and converts files sent from the iSeries server
|
||
|
|
into the FTP file structure.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiqfrmt.htm" title="Before you begin to transfer files, you must choose the appropriate file transfer type.">Data transfer methods</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="rzaiqreferencedt7.htm" title="It is strongly recommended that you pre-create any files that are to be transferred into the iSeries QSYS.LIB file system. This is the best method of ensuring that your data is transferred reliably and effectively with optimal performance and integrity.">File pre-creation considerations</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|