gtpo1m7k | Operations |
Use this command to change an Internet server application entry in the Internet daemon configuration file (IDCF).
Requirements and Restrictions
Format
|
Notes:
You can add a maximum of 20 IP addresses to an Internet server application entry.
If all the IP addresses for an Internet server application are deleted, the Internet daemon binds the socket to INADDR_ANY.
The Internet daemon does not start the Internet server application until the TPF system reaches the specified state. If the TPF system cycles below the specified state, the Internet daemon will stop the Internet server application.
If you do not specify this parameter or if you specify a value of 0, the Internet daemon listener will not restrict the time it takes an Internet server application process instance to run.
If you specify a value greater than 0, you must enable SIGTERM signals in your Internet server application because if a timeout occurs, the Internet daemon sends a SIGTERM signal to the Internet server application. Use the signal function to enable signals in your applications. See TPF C/C++ Language Support User's Guide for more information about the signal function.
The MAXPROC parameter is useful only when you specify NOWAIT for the MODEL parameter. If you specify WAIT for the MODEL parameter, the Internet daemon listener will use a value of 1 for MAXPROC.
If you specify NOWAIT for the MODEL parameter, and you do not specify the MAXPROC parameter or you specify a value of 0, the Internet daemon listener will use a value of 1000.
This is the number of times the Internet daemon listener will allow the Internet server application to end in error during the sampling interval specified by the SERVETIME parameter. If the error rate is exceeded, the Internet daemon listener stops the Internet server application. Once the Internet server application has been stopped, you must enter the ZINET START command to start the Internet server application again.
If you do not specify this parameter or if you specify a value of 0, the Internet daemon listener will not maintain an error rate threshold for the Internet server application.
If you do not specify this parameter or if you specify a value of 0, the Internet daemon listener will not maintain an error rate threshold for the Internet server application.
The Internet daemon uses the specified user name to retrieve information about the Internet server application from the password file. The Internet server application is started with the user ID, group ID, and working directory information found in the password file entry.
If you specify this parameter, it must be the last parameter in the command entry and you must specify a string of parameter data; specifying a NULL string will cause problems when starting the Internet server application.
Additional Information
ZINET HELP
ZINET ?
Examples
The following example changes the Trivial File Transfer Protocol (TFTP) server entry in the IDCF to monitor an error rate threshold for the TFTP server. The Internet daemon will deactivate the TFTP server if it ends in error 10 times in a 60-second sampling interval.
+--------------------------------------------------------------------------------+ |User: ZINET ALT S-TFTP SERVERRORS-10 SERVETIME-60 | | | |System: INET0012I 10.06.07 SERVER TFTP ENTRY UPDATED | | CSMP0097I 10.06.07 CPU-B SS-BSS SSU-HPN IS-01 | | SERVER - TFTP PROCID - B ACTIVATION - OPER | | PGM - CTFT PARM - | | PROTOCOL - UDP PORT - 00069 MODEL - NOWAIT | | SERVERRORS - 00000 SERVETIME - 00000 USER - nobody | | MAXPROC - 00005 TIMEOUT - 00120 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00000 | | IP - 9.117.198.24 | | | | ALTERED TO - | | | | SERVER - TFTP PROCID - B ACTIVATION - OPER | | PGM - CTFT PARM - | | PROTOCOL - UDP PORT - 00069 MODEL - NOWAIT | | SERVERRORS - 00010 SERVETIME - 00060 USER - nobody | | MAXPROC - 00005 TIMEOUT - 00120 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00000 | | IP - 9.117.198.24 | | END OF DISPLAY | +--------------------------------------------------------------------------------+
The following example changes the TFTP entry in the IDCF to listen for input over a second IP address (9.117.198.55).
+--------------------------------------------------------------------------------+ |User: ZINET ALTER SERVER-TFTP ADDIP-9.117.198.55 | | | |System: INET0012I 10.07.04 SERVER TFTP ENTRY UPDATED | | CSMP0097I 10.07.04 CPU-B SS-BSS SSU-HPN IS-01 | | SERVER - TFTP PROCID - B ACTIVATION - OPER | | PGM - CTFT PARM - | | PROTOCOL - UDP PORT - 00069 MODEL - NOWAIT | | SERVERRORS - 00010 SERVETIME - 00060 USER - nobody | | MAXPROC - 00005 TIMEOUT - 00120 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00000 | | IP - 9.117.198.24 | | | | ALTERED TO - | | | | SERVER - TFTP PROCID - B ACTIVATION - OPER | | PGM - CTFT PARM - | | PROTOCOL - UDP PORT - 00069 MODEL - NOWAIT | | SERVERRORS - 00005 SERVETIME - 00060 USER - nobody | | MAXPROC - 00005 TIMEOUT - 00120 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00000 | | IP - 9.117.198.24 9.117.198.55 | | END OF DISPLAY | +--------------------------------------------------------------------------------+
The following example changes the Apache entry in the IDCF to add an XPARM parameter.
+--------------------------------------------------------------------------------+ |User: ZINET ALTER SERVER-APACHE XPARM--f /usr/local/apache/conf/httpd.conf | | | |System: INET0012I 11.57.04 SERVER APACHE ENTRY UPDATED | | CSMP0097I 11.57.04 CPU-B SS-BSS SSU-HPN IS-01 | | SERVER - APACHE PROCID - B ACTIVATION - AUTO | | PGM - QZZ8 PARM - | | PROTOCOL - PORT - 00000 MODEL - DAEMON | | SERVERRORS - 00000 SERVETIME - 00000 USER - root | | MAXPROC - 00001 TIMEOUT - 00000 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00000 | | IP - ANY | | | | ALTERED TO - | | | | SERVER - APACHE PROCID - B ACTIVATION - AUTO | | PGM - QZZ8 PARM - | | PROTOCOL - PORT - 00000 MODEL - DAEMON | | SERVERRORS - 00000 SERVETIME - 00000 USER - root | | MAXPROC - 00001 TIMEOUT - 00000 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00000 | | XPARM - -f | | IP - ANY | | END OF DISPLAY | +--------------------------------------------------------------------------------+
The following example changes the maximum number of connection requests that can be queued for the File Transfer Protocol (FTP) server entry in the IDCF.
+--------------------------------------------------------------------------------+ |User: ZINET ALTER SERVER-FTP BACKLOG-100 | | | |System: INET0012I 13.28.58 SERVER FTP ENTRY UPDATED | | CSMP0097I 13.28.58 CPU-B SS-BSS SSU-HPN IS-01 | | SERVER - FTP PROCID - B ACTIVATION - AUTO | | PGM - CFTP PARM - | | PROTOCOL - TCP PORT - 00021 MODEL - NOWAIT | | SERVERRORS - 00000 SERVETIME - 00000 USER - root | | MAXPROC - 00000 TIMEOUT - 00000 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00005 | | IP - ANY | | | | ALTERED TO - | | | | SERVER - FTP PROCID - B ACTIVATION - AUTO | | PGM - CFTP PARM - | | PROTOCOL - TCP PORT - 00021 MODEL - NOWAIT | | SERVERRORS - 00000 SERVETIME - 00000 USER - root | | MAXPROC - 00000 TIMEOUT - 00000 STATE - NORM | | AORLENGTH - 00000 BACKLOG - 00100 | | IP - ANY | | END OF DISPLAY | +--------------------------------------------------------------------------------+
Related Information