ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgtftpa.htm

415 lines
16 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change TFTP Attributes (CHGTFTPA)</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="CHGTFTPA.Top_Of_Page"></a>
<h2>Change TFTP Attributes (CHGTFTPA)</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="#CHGTFTPA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGTFTPA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGTFTPA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGTFTPA"></a>
<p>The Change TFTP Server Attributes (CHGTFTPA) command is used to change the Trivial File Transfer Protocol (TFTP) server attributes. The changes take effect the next time the TFTP server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.
</p>
<p><b>Restrictions:</b>
</p>
<p>You must have *IOSYSCFG special authority to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGTFTPA.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"><a href="#CHGTFTPA.AUTOSTART"><b>AUTOSTART</b></a></td>
<td valign="top">Autostart server</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.ENBBCAST"><b>ENBBCAST</b></a></td>
<td valign="top">Enable subnet broadcast</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGTFTPA.NBRSVR"><b>NBRSVR</b></a></td>
<td valign="top">Number of server jobs</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Minimum</td>
<td valign="top">
1-20, <b><u>*SAME</u></b>, *DFT</td>
</tr>
<tr>
<td valign="top">Element 2: Maximum</td>
<td valign="top">
1-250, <b><u>*SAME</u></b>, *DFT</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.INACTTMR"><b>INACTTMR</b></a></td>
<td valign="top">Server inactivity timer</td>
<td valign="top">1-1440, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="2"><a href="#CHGTFTPA.CCSID"><b>CCSID</b></a></td>
<td valign="top">ASCII single byte CCSID</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="2">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Coded character set identifier</td>
<td valign="top">
1-65532, <b><u>*SAME</u></b>, *DFT</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.MAXBLKSIZE"><b>MAXBLKSIZE</b></a></td>
<td valign="top">Maximum block size</td>
<td valign="top">512-65464, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.RSPTIMO"><b>RSPTIMO</b></a></td>
<td valign="top">Connection response timeout</td>
<td valign="top">1-600, <b><u>*SAME</u></b>, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.ALWWRT"><b>ALWWRT</b></a></td>
<td valign="top">Allow file writes</td>
<td valign="top">*DFT, *NONE, *CREATE, *REPLACE, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.ALTSRCDIR"><b>ALTSRCDIR</b></a></td>
<td valign="top">Alternate source directory</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE, *DFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTFTPA.ALTTGTDIR"><b>ALTTGTDIR</b></a></td>
<td valign="top">Alternate target directory</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE, *DFT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGTFTPA.AUTOSTART"></a>
<h3>Autostart server (AUTOSTART)</h3>
<p>The AUTOSTART attribute determines whether or not the TFTP server starts automatically when TCP/IP is started using the STRTCP command, or when the STRTCPSVR SERVER(*AUTOSTART) command is issued.
</p>
<p>This attribute is only used by the STRTCPSVR command if STRTCPSVR *AUTOSTART is specified. STRTCPSVR *TFTP or STRTCPSVR *ALL will start the TFTP server regardless of the value of the AUTOSTART attribute. If STRTCPSVR SERVER(*TFTP) is specified and the TFTP server is already running, then an additional server job is started.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The AUTOSTART value does not change if it was previously set. Otherwise, *NO is used.
</dd>
<dt><b>*YES</b></dt>
<dd>Specify a value of *YES if you want the number of TFTP server jobs specified in the NBRSVR parameter to start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR *AUTOSTART command.
</dd>
<dt><b>*NO</b></dt>
<dd>Specify *NO if you do not want the number of TFTP server jobs specified in the NBRSVR parameter to start automatically each time TCP/IP is started by the STRTCP command, or each time the TCP/IP servers are started by the STRTCPSVR *AUTOSTART command.
<p>When the value is set to *NO, only the STRTCPSVR *TFTP command or the STRTCPSVR *ALL command will start the TFTP server.
</p>
<p>If you do not intend to use the TFTP server, set AUTOSTART to *NO.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.ENBBCAST"></a>
<h3>Enable subnet broadcast (ENBBCAST)</h3>
<p>This parameter enables subnet directed TFTP broadcasts which allow multiple clients on the same subnet to load at the same time. Clients must be enabled to use this protocol.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value of the ENBBCAST parameter will not be changed if it was previously set.
</dd>
<dt><b>*DFT</b></dt>
<dd>The subnet broadcast option is set to *YES.
</dd>
<dt><b>*YES</b></dt>
<dd>Enable the TFTP Subnet broadcast.
</dd>
<dt><b>*NO</b></dt>
<dd>Disable the TFTP Subnet broadcast.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.NBRSVR"></a>
<h3>Number of server jobs (NBRSVR)</h3>
<p>The number of servers (NBRSVR) parameter has two parts, minimum and maximum.
</p>
<p>Minimum specifies the number of TFTP server jobs to start when TFTP is started by either the Start TCP/IP (STRTCP) command or the Start TCP/IP Server (STRTCPSVR) command. These jobs allow new clients to connect to the server without having to wait for the overhead associated with starting a new job. The server tries to keep at least this number of jobs available for connecting to new clients as the number of connected clients changes. This is a performance enhancement for the TFTP server that reduces the system overhead each time a client connects.
</p>
<p>
<b>Note: </b>The actual number of jobs seen in the job list may be slightly greater that the number defined due to the fact that one job is always listening and is not counted as an active job.
</p>
<p>Maximum is the maximum number of TFTP server jobs.
</p>
<p><b>Element 1: Minimum</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of server jobs previously set does not change. Otherwise two (2) is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The number of server jobs is set to the default value of 2.
</dd>
<dt><b><i>1-20</i></b></dt>
<dd>Specify the number of server jobs to start.
</dd>
</dl>
<p><b>Element 2: Maximum</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of server jobs previously set does not change. Otherwise six (6) is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The number of server jobs is set to the default value of 6.
</dd>
<dt><b><i>1-250</i></b></dt>
<dd>Specify the maximum number of server jobs to start. The number specified must be equal or greater than the minimum.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.INACTTMR"></a>
<h3>Server inactivity timer (INACTTMR)</h3>
<p>During periods of inactivity the number of active TFTP servers can drop to the minimum. The inactivity timer (INACTTMR) specifies, in minutes, how often the primary TFTP server checks TFTP activity to see if a server can be terminated.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The inactivity timer value does not change if it was previously set. Otherwise 10 minutes is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The inactivity timer value is set to the default value of 10 minutes.
</dd>
<dt><b><i>1-1440</i></b></dt>
<dd>Specify an inactivity timer value in minutes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.CCSID"></a>
<h3>ASCII single byte CCSID (CCSID)</h3>
<p>Specifies the ASCII coded-character set identifier (CCSID) to use with integrated file system files. Integrated file system files will be read or write with this CCSID if they are not in the "qibm/proddata" directory. Files in the "qibm/proddata" directory will be read in CCSID 00819.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The CCSID value that was previously set does not change. Otherwise, 00819 (ISO 8859-1 8-bit ASCII) is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The CCSID value is set to 00819 (ISO 8859-1 8-bit ASCII).
</dd>
<dt><b><i>CCSID-value</i></b></dt>
<dd>Specify an ASCII CCSID value. This value is validated to ensure that you are specifying a valid ASCII CCSID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.MAXBLKSIZE"></a>
<h3>Maximum block size (MAXBLKSIZE)</h3>
<p>Specifies the maximum block size, in bytes, to send or receive data in.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The block size does not change if it was previously set. Otherwise 1024 bytes is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The block size is set to 1024 bytes.
</dd>
<dt><b><i>512-65464</i></b></dt>
<dd>Specify the block size in number of bytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.RSPTIMO"></a>
<h3>Connection response timeout (RSPTIMO)</h3>
<p>Specifies the number of seconds to wait for an expected response before terminating the requested transfer. Re-transmissions may occur during this time period based on an internally calculated re-transmission timeout value.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The response timeout value does not change if it was previously set. Otherwise 60 seconds is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The response timeout value is set to the default value of 60 seconds.
</dd>
<dt><b><i>1-600</i></b></dt>
<dd>Specify a response timeout value in seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.ALWWRT"></a>
<h3>Allow file writes (ALWWRT)</h3>
<p>The value of this parameter determines whether TFTP users are allowed to create and replace files on this system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change if it was previously set. Otherwise, *NONE is used.
</dd>
<dt><b>*DFT</b></dt>
<dd>The value is set to *NONE.
</dd>
<dt><b>*NONE</b></dt>
<dd>Do not allow TFTP users to create new files on this system or replace existing files.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Allow TFTP users to replace existing files on this system.
</dd>
<dt><b>*CREATE</b></dt>
<dd>Allow TFTP users to create new files and replace existing files on this system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.ALTSRCDIR"></a>
<h3>Assigned directories (ALTSRCDIR)</h3>
<p>Specifies the authorized alternate path to the integrated file system directory containing files to be read. If the path of the read request matches the source directory path specified on this parameter, and the permission bit set on the integrated file system object allows access from the QTFTP profile, the read is allowed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value that was previously set does not change.
</dd>
<dt><b>*DFT</b></dt>
<dd>The path is set to *NONE.
</dd>
<dt><b>*NONE</b></dt>
<dd>No path (or access) is authorized except through the default directory for the IBM Network Station.
</dd>
<dt><b><i>path-name</i></b></dt>
<dd>Specify the alternate authorized path to the source files. Note that imbedded spaces and single quotation marks (apostrophes) will be removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTFTPA.ALTTGTDIR"></a>
<h3>Alternate target directory (ALTTGTDIR)</h3>
<p>Specifies the alternate authorized path to the integrated file system directory containing files to be written to. The write is allowed if all of the following are true:
</p>
<ol>
<li>The path of the write request matches the target directory path specified on this parameter
</li>
<li>The permission bit set on the integrated file system object allows access from the QTFTP profile
</li>
<li>The allow write (ALWWRT) parameter is set to *CREATE or *REPLACE.
<p>
<b>Note: </b>The *REPLACE option works only when the file already exists.
</p>
</li>
</ol>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value that was previously set does not change.
</dd>
<dt><b>*DFT</b></dt>
<dd>The path is set to *NONE.
</dd>
<dt><b>*NONE</b></dt>
<dd>No path (or access) is authorized except through the default directory for the IBM Network Station.
</dd>
<dt><b><i>path-name</i></b></dt>
<dd>Specify the alternate authorized path to the target directory for files to be written. Note that imbedded spaces and single quotation marks (apostrophes) will be removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTFTPA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Start the TFTP Server Automatically</b>
</p>
<p>
<pre>
CHGTFTPA AUTOSTART(*YES)
</pre>
</p>
<p>This command indicates that the next time the STRTCP command is issued to start up TCP/IP and to automatically start the TCP/IP applications, the TFTP server will be automatically started.
</p>
<p><b>Example 2: Changing the Number of Initial Server Jobs</b>
</p>
<p>
<pre>
CHGTFTPA NBRSVR(5)
</pre>
</p>
<p>This command indicates that the next time the TFTP server is started, five TFTP server jobs will be started automatically.
</p>
<p><b>Example 3: Changing the Number of Server Jobs</b>
</p>
<p>
<pre>
CHGTFTPA NBRSVR(4 7)
</pre>
</p>
<p>This command indicates that the next time the TFTP server is started, four TFTP server jobs will be started automatically, and the maximum will be seven.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTFTPA.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTFTPA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>