CHGTFTPA (Change TFTP Attributes) Command
Purpose
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.
Note: To see the parameter and value descriptions for this command,
refer to the online help text.
Restrictions: You must have *IOSYSCFG special authority to use this
command.
Required Parameters
AUTOSTART Specifies whether to automatically start the TFTP server
when TCP/IP is started by the Start TCP/IP (STRTCP) command. When the TFTP
server is started by the Start TCP/IP Server (STRTCPSVR) command, this parameter
is ignored and the TFTP server is started regardless of the value of this
parameter. If STRTCPSVR SERVER(*TFTP) is specified and the TFTP server is
already running, then an additional server job is started.
*SAME: The AUTOSTART value does not change if it was previously
set; otherwise, *NO is used.
*NO: Do not start the number of server jobs defined in the NBRSVR
parameter when the STRTCP command is called. If you do not plan to use the TFTP
server, set AUTOSTART to *NO.
*YES: Start the number of server jobs specified in the NBRSVR
parameter.
ENBBCAST Allow Subnet Broadcast (SUBNETBCAST) determines whether
the subnet broadcast function of the TFTP Server is enabled. Allowing subnet
broadcast can reduce load requirements on the TFTP server when simultaneously
booting multiple Network Stations from a particular subnet. Clients from the
same subnet making compatible read requests including the subnet broadcast
option can be broadcast the requested file. Compatible read requests are read
requests for the same file, same mode, with a requested block size of greater
than or equal to an existing broadcasting job's blocksize.
*SAME: The value does not change if it was previously set.
Otherwise, *YES is used.
*DFT: The subnet broadcast option is set to *YES.
*YES: This enables the subnet broadcast function of the TFTP
server.
*NO: Disable the subnet broadcasting function of the TFTP server.
NBRSVR
The number of server (NBRSVR) parameter has two parts, minimum and maximum.
Minimum specifies the number of TFTP server jobs to start initially when TFTP
is started by either the Start TCP/IP (STRTCP) or Start TCP/IP Server
(STRTCPSVR) commands. 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. The actual number of jobs seen in the job list may be slightly
greater than the number defined due to the fact that one job is always listening
and is not counted as an active job.
Note: The actual number of jobs seen in the job list may be slightly
greater than 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 number of
jobs
*SAME: The number of server jobs previously set does not change.
Otherwise two (2) is used.
*DFT: The number of server jobs is set to the default value of 2.
number-of-servers: The number of servers requested to start. Valid
values range from 1 through 20 servers.
Element 2: Maximum number of
jobs
*SAME: The number of server jobs previously set does not change.
Otherwise six (6) is used.
*DFT: The number of server jobs is set to the default value of 6.
maximum-server-jobs: Specify the maximum number of server jobs to
start. Valid values range from 1 through 250, but must be equal or greater than
the minimum.
INACTTMR 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.
*SAME: The inactivity timer value does not change if it was
previously set. Otherwise 10 minutes is used.
*DFT: The inactivity timer value is set to the default value of 10
minutes.
inactive-timer-value: Specify an inactivity timer value in the
range 1 through 1440 minutes.
CCSID Specifies the ASCII coded-character set identifier (CCSID)
to use with integrated file system files. Integrated file system files will be
read or written with this CCSID if they are not in the "qibm/proddata"
directory. Files in the "qibm/proddata" directory will be read in CCSID 00819.
SAME: The CCSID value that was previously set does not change;
Otherwise, 00819 (ISO 8859-1 8-bit ASCII) is used.
*DFT: The CCSID value is set to 00819 (ISO 8859-1 8-bit ASCII).
CCSID-value: Specify an ASCII CCSID value. This value is validated
to ensure that you are specifying a valid ASCII CCSID.
MAXBLKSIZE Specifies the maximum block size, in bytes, to send or
receive data in. The valid range is 512 to 65464 bytes.
SAME: The block size does not change if it was previously set.
Otherwise 1024 bytes is used.
*DFT: The block size is set to 1024 bytes.
number-of-bytes: Specify the block size in number of bytes.
RSPTIMO 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.
SAME: The response timeout value does not change if it was
previously set. Otherwise 60 seconds is used.
*DFT: The response timeout value is set to the default value of 60
seconds.
response-timeout-value: Specify a response timeout value in the
range 1 to 600 seconds.
ALWWRT The value of this parameter determines whether TFTP users
are allowed to create and replace files on this system.
SAME: The value does not change if it was previously set.
Otherwise; *NONE is used.
*NONE: Do not allow TFTP users to create new files on this system
or replace existing files.
*DFT: The value is set to *NONE.
*CREATE: Allow TFTP users to create new files and replace existing
files on this system.
*REPLACE: Allow TFTP users to replace existing files on this
system.
ALTSRCDIR 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.
SAME: The value that was previously set does not change.
*NONE: No path (or access) is authorized except through the
default directory for the IBM Network Station.
*DFT: The path is set to *NONE.
path-to-source-directory: Specify the alternate authorized path to
the source files. Note that imbedded spaces and single quotation marks
(apostrophes) will be removed.
ALTTGTDIR Specifies the authorized alternate path to the
integrated file system directory containing files to be written to. The write is
allowed if all of the following are true.
° If the path of the write request matches the target directory path
specified on this parameter
° If the permission bit set on the integrated file system object allows
access from the QTFTP profile
° If the allow write (ALWWRT) parameter is set to *CREATE or *REPLACE
Note: The *REPLACE option works only when the file already exists.
SAME: The value that was previously set does not change.
*DFT: The path is set to *NONE.
path-to-target-directory: 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.
Examples
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.
| 
