367 lines
13 KiB
HTML
367 lines
13 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Send Network File (SNDNETF)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="SNDNETF.Top_Of_Page"></a>
|
|
<h2>Send Network File (SNDNETF)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#SNDNETF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SNDNETF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SNDNETF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SNDNETF"></a>
|
|
<p>The Send Network File (SNDNETF) command sends a save file or a member of a physical database file to another user on the local system or on a remote system through the SNADS network. This command can be used to:
|
|
</p>
|
|
<ul>
|
|
<li>Send data files to a user.
|
|
</li>
|
|
<li>Send source files to a user. Source sequence information is kept in the file sent.
|
|
</li>
|
|
<li>Send other object types stored in a save file to a user.
|
|
</li>
|
|
</ul>
|
|
<p>When the file arrives at its destination, a notification message is sent to both the recipient and sender of the file.
|
|
</p>
|
|
<p>When a source physical file is sent, the source sequence number and change date in positions 1 through 12 of the record are sent with the file. These are kept if the file is received into a source physical file, and are truncated if the file is received into a nonsource physical file. When a file that was originally a nonsource physical file is received into a source physical file, the source sequence numbers are created and placed in front of the records.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Save files created on the AS/400 system cannot be distributed to System/38. However, save files created on System/38 <b>can</b> be distributed to the AS/400 system.
|
|
</p>
|
|
<p>This command does not perform any CCSID translation on the contents of the file. However, the user ID and address of both the recipient and the originator are translated from the current job CCSID to the multinational character set 697/500.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The user must be enrolled in the system distribution directory.
|
|
</li>
|
|
<li>The maximum size of a file that can be sent using the SNDNETF command is approximately 2 billion bytes.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SNDNETF.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDNETF.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">File</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDNETF.TOUSRID"><b>TOUSRID</b></a></td>
|
|
<td valign="top">User ID</td>
|
|
<td valign="top">Values (up to 50 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: User ID</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Address</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDNETF.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDNETF.TOTYPE"><b>TOTYPE</b></a></td>
|
|
<td valign="top">To file type</td>
|
|
<td valign="top"><b><u>*FROMFILE</u></b>, *DATA</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDNETF.CLASS"><b>CLASS</b></a></td>
|
|
<td valign="top">VM/MVS class</td>
|
|
<td valign="top"><b><u>A</u></b>, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDNETF.FORMAT"><b>FORMAT</b></a></td>
|
|
<td valign="top">Send format</td>
|
|
<td valign="top"><b><u>*V</u></b>, *F, *U</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDNETF.PTY"><b>PTY</b></a></td>
|
|
<td valign="top">Send priority</td>
|
|
<td valign="top"><b><u>*NORMAL</u></b>, *HIGH</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SNDNETF.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the name and library of the file that is sent. The file being sent can be a physical file or a save file; logical files and device files are not allowed. Overrides to the specified file are ignored.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the file.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDNETF.TOUSRID"></a>
|
|
<h3>User ID (TOUSRID)</h3>
|
|
<p>Specifies the two-part user ID of one or more users to whom the file is being sent, or the name of one or more distribution lists containing the user IDs of one or more users to whom the file is being sent. A combination of user IDs and distribution lists can be specified on the same command. Each user ID or distribution list is specified as a two-part name, and both parts are required.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>You can enter multiple values for this parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDNETF.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the member that is sent from the file. A member name is not allowed if the file is a save file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member (in order of creation) in the file is sent.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the file member that is sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDNETF.TOTYPE"></a>
|
|
<h3>To file type (TOTYPE)</h3>
|
|
<p>Specifies, when you send a source file, whether the sequence numbers and date fields are to be removed from the transmitted copy of the file. The source file is not changed. This parameter is not valid for non-source files.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FROMFILE</u></b></dt>
|
|
<dd>The file type of the source file is used when sending the file. The transmitted file does not change.
|
|
</dd>
|
|
<dt><b>*DATA</b></dt>
|
|
<dd>The file is sent as a non-source file. The transmitted copy is sent without sequence numbers and date fields.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDNETF.CLASS"></a>
|
|
<h3>VM/MVS class (CLASS)</h3>
|
|
<p>Specifies the VM/MVS SYSOUT class for distributions sent to a VM host system or to an MVS host system.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>A</u></b></dt>
|
|
<dd>The class is A.
|
|
</dd>
|
|
<dt><b><i>B-Z, 0-9</i></b></dt>
|
|
<dd>Specify the distribution class. Valid values range from B through Z and 0 through 9.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDNETF.FORMAT"></a>
|
|
<h3>Send format (FORMAT)</h3>
|
|
<p>Specifies the record format in which the network file is transmitted.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*V</u></b></dt>
|
|
<dd>The file is sent using variable-length records with trailing blanks removed from each record.
|
|
</dd>
|
|
<dt><b>*F</b></dt>
|
|
<dd>The file is sent as fixed-length records with no trailing blanks removed from the records. Specifying this value affects only network files sent to a System/370. This value is not recommended for sending files to another AS/400 system.
|
|
</dd>
|
|
<dt><b>*U</b></dt>
|
|
<dd>If the file contains null capable fields, specifying this value causes SNDNETF to allow sending of the file and to send the mapping information which indicates which fields are null capable. This value for FORMAT will only produce the desired results when the file is sent to another AS/400 with OS/400 release VRM420 and later installed.
|
|
<p>
|
|
<b>Note: </b>Specifying FORMAT(*F) may increase the amount of storage and time required when transmitting the network file. Specifying FORMAT(*U) also requires that the receiving system must have a database file created with the identical field mappings as the file being sent, in order to receive the file correctly.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDNETF.PTY"></a>
|
|
<h3>Send priority (PTY)</h3>
|
|
<p>Specifies the queuing priority used for this file when it is being routed through a SNADS network.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NORMAL</u></b></dt>
|
|
<dd>The file is sent with a service level priority of data low, which is used for most data traffic. On an AS/400 system, data low distributions are placed on the normal distribution queue specified for the route.
|
|
</dd>
|
|
<dt><b>*HIGH</b></dt>
|
|
<dd>The file is sent with a service level priority of data high, which is used for high priority data traffic. On an AS/400 system, data high distributions are placed on the data high distribution queue specified for the route.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDNETF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Sending a Member</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SNDNETF TOUSRID((JONES SYSTEM1)) FILE(EMPLOYEE) MBR(PGMR)
|
|
</pre>
|
|
</p>
|
|
<p>This command sends member PGMR of file EMPLOYEE to the user identified to the network with a user ID of (JONES SYSTEM1). The library list is used to locate the file.
|
|
</p>
|
|
<p><b>Example 2: Sending a Nonsource File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SNDNETF TOUSRID((JONES SYSTEM2)) FILE(EMPLOYEE) MBR(PGMR)
|
|
TOTYPE(*DATA)
|
|
</pre>
|
|
</p>
|
|
<p>This command sends member PGMR of file EMPLOYEE to the user identified to the network with a user ID of (JONES SYSTEM2). The library list is used to locate the file. The file is being sent as a nonsource file removing the sequence numbers and date fields.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDNETF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8057</b></dt>
|
|
<dd>File &1 in &2 not a physical file or save file.
|
|
</dd>
|
|
<dt><b>CPF8058</b></dt>
|
|
<dd>File &1 is a spooled file.
|
|
</dd>
|
|
<dt><b>CPF8059</b></dt>
|
|
<dd>Member name not allowed for save file.
|
|
</dd>
|
|
<dt><b>CPF8063</b></dt>
|
|
<dd>Cannot assign necessary resource.
|
|
</dd>
|
|
<dt><b>CPF8064</b></dt>
|
|
<dd>File &1 in &2 member &3 not sent to any users.
|
|
</dd>
|
|
<dt><b>CPF8066</b></dt>
|
|
<dd>One or more user identifiers on this command is not correct.
|
|
</dd>
|
|
<dt><b>CPF8068</b></dt>
|
|
<dd>Error detected while processing file to be sent.
|
|
</dd>
|
|
<dt><b>CPF8072</b></dt>
|
|
<dd>Object to be sent is greater than maximum size of 2GB.
|
|
</dd>
|
|
<dt><b>CPF9005</b></dt>
|
|
<dd>System resource required to complete this request not available.
|
|
</dd>
|
|
<dt><b>CPF9006</b></dt>
|
|
<dd>User not enrolled in system distribution directory.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9807</b></dt>
|
|
<dd>One or more libraries in library list deleted.
|
|
</dd>
|
|
<dt><b>CPF9808</b></dt>
|
|
<dd>Cannot allocate one or more libraries on library list.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9848</b></dt>
|
|
<dd>Cannot open file &1 in library &2 member &3.
|
|
</dd>
|
|
<dt><b>CPF9849</b></dt>
|
|
<dd>Error while processing file &1 in library &2 member &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDNETF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|