| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
Restrictions:
You must have *IOSYSCFG special authority to use this command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| AUTOSTART | Autostart server | *YES, *NO, *SAME | Optional, Positional 1 |
| ENBBCAST | Enable subnet broadcast | *YES, *NO, *SAME | Optional |
| NBRSVR | Number of server jobs | Element list | Optional |
| Element 1: Minimum | 1-20, *SAME, *DFT | ||
| Element 2: Maximum | 1-250, *SAME, *DFT | ||
| INACTTMR | Server inactivity timer | 1-1440, *SAME, *DFT | Optional |
| CCSID | ASCII single byte CCSID | Element list | Optional |
| Element 1: Coded character set identifier | 1-65532, *SAME, *DFT | ||
| MAXBLKSIZE | Maximum block size | 512-65464, *SAME, *DFT | Optional |
| RSPTIMO | Connection response timeout | 1-600, *SAME, *DFT | Optional |
| ALWWRT | Allow file writes | *DFT, *NONE, *CREATE, *REPLACE, *SAME | Optional |
| ALTSRCDIR | Alternate source directory | Character value, *SAME, *NONE, *DFT | Optional |
| ALTTGTDIR | Alternate target directory | Character value, *SAME, *NONE, *DFT | Optional |
| Top |
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.
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.
When the value is set to *NO, only the STRTCPSVR *TFTP command or the STRTCPSVR *ALL command will start the TFTP server.
If you do not intend to use the TFTP server, set AUTOSTART to *NO.
| Top |
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.
| Top |
The number of servers (NBRSVR) parameter has two parts, minimum and maximum.
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.
Note: 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.
Maximum is the maximum number of TFTP server jobs.
Element 1: Minimum
Element 2: Maximum
| Top |
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.
| Top |
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.
| Top |
Specifies the maximum block size, in bytes, to send or receive data in.
| Top |
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.
| Top |
The value of this parameter determines whether TFTP users are allowed to create and replace files on this system.
| Top |
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.
| Top |
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:
Note: The *REPLACE option works only when the file already exists.
| Top |
Example 1: Start the TFTP Server Automatically
CHGTFTPA AUTOSTART(*YES)
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.
Example 2: Changing the Number of Initial Server Jobs
CHGTFTPA NBRSVR(5)
This command indicates that the next time the TFTP server is started, five TFTP server jobs will be started automatically.
Example 3: Changing the Number of Server Jobs
CHGTFTPA NBRSVR(4 7)
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.
| Top |
None
| Top |