CHGHTTPA

La commande Modification des attributs HTTP (CHGHTTPA) permet de modifier les attributs configurables du serveur HTTP (World Wide Web Hypertext Transfer Protocol). (Ce serveur est également appelé IBM HTTP Server). The Change HTTP Attributes (CHGHTTPA) command is used to change the configurable World Wide Web Hypertext Transfer Protocol (HTTP) server attributes. (This server is also known as the IBM HTTP Server).

Lorsque vous modifiez les attributs HTTP avec cette commande, les modifications s'appliquent à tous les serveurs HTTP et à toutes les instances de serveur HTTP, avec les exceptions suivantes : When you change HTTP attributes using this command, the changes apply to all HTTP servers and HTTP server instances, with the following exceptions:

• Les valeurs indiquées dans les formulaires de configuration et d'administration d'une instance particulière sont prioritaires sur les valeurs indiquées avec la commande CHGHTTPA. Pour des informations détaillées sur l'utilisation des formulaires de configuration et d'administration, consultez le site Web HTTP à l'adresse http://www.ibm.com/eserver/iseries/http. Values specified on configuration and administration forms for a particular instance take precedence over the values specified with the CHGHTTPA command. For detailed information on how to use configuration and administration forms go to the HTTP web site at http://www.ibm.com/eserver/iseries/http.
• Les valeurs indiquées comme "valeurs de démarrage de l'instance" dans le paramètre HTTPSVR de la commande Démarrage de serveur TCP/IP (STRTCPSVR) sont prioritaires sur les valeurs indiquées ailleurs. Values specified as "instance startup values" on the HTTPSVR parameter of the Start TCP/IP Server (STRTCPSVR) command take precedence over values specified anywhere else.

Les modifications prennent effet au prochain démarrage du serveur HTTP, par la commande Démarrage de TCP/IP (STRTCP) ou par la commande Démarrage de serveur TCP/IP (STRTCPSVR). The changes take effect the next time the HTTP server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.

Restrictions

• Vous devez posséder le droit spécial de configuration du système d'entrée-sortie (*IOSYSCFG) pour utiliser cette commande. You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Paramètres

Démarrage automatique (AUTOSTART)Autostart (AUTOSTART)

Indique s'il faut démarrer automatiquement le serveur HTTP lorsque TCP/IP est démarré par la commande STRTCP. Lorsque HTTP est démarré par la commande STRTCPSVR, le paramètre AUTOSTART est ignoré et le serveur HTTP est démarré quelle que soit la valeur de ce paramètre. Si STRTCPSVR *HTTP est indiqué et que le serveur HTTP est déjà en cours d'exécution, la demande de démarrage est refusée. Specifies whether to automatically start the HTTP server when TCP/IP is started by the STRTCP command. When HTTP is started by the STRTCPSVR command, the AUTOSTART parameter is ignored and the HTTP server is started regardless of the value of this parameter. If STRTCPSVR *HTTP is specified, and the HTTP server is already running, then the start request is denied.

*SAME

La valeur AUTOSTART ne change pas si elle avait été définie précédemment. Sinon, *NO est utilisé. The AUTOSTART value does not change if it was previously set. Otherwise, *NO is used.

*NO

Ne démarre pas le serveur HTTP lorsque la commande STRTCP est émise. Si vous n'avez pas l'intention d'utiliser HTTP, donnez la valeur *NO à ce paramètre. Do not start the HTTP server when the STRTCP command is issued. If you do not intend to use HTTP, set this parameter to *NO.

*YES

Démarre le serveur HTTP lorsque la commande STRTCP est émise. Start the HTTP server when the STRTCP command is issued.

Nombre d'unités d'exécution du serveur (NBRSVR)Number of server threads (NBRSVR)

Indique le nombre minimal et maximal d'unités d'exécution du serveur HTTP à démarrer lorsque HTTP est démarré par la commande Démarrage de TCP/IP (STRTCP) ou par la commande Démarrage de serveur TCP/IP (STRTCPSVR). Specifies the minimum and maximum number of HTTP server threads to start when HTTP is started by either the Start TCP/IP (STRTCP) command or the Start TCP/IP Server (STRTCPSVR) command.

Remarque :La valeur indiquée pour le nombre minimal d'unités d'exécution du serveur est ignorée. La valeur a été conservée dans la commande pour des raisons de compatibilité. Remarque :The value specified for the minimum number of server threads is ignored. The value has been left on the command for compatibility reasons.

Indiquer la valeur *NOMAX pour le nombre maximal d'unités d'exécution du serveur peut avoir un impact négatif sur les performances du système, car cela affecte tous les serveurs HTTP qui n'indiquent pas explicitement de directive ThreadsPerChild. Soyez très prudent avant d'indiquer la valeur *NOMAX. Specifying a value of *NOMAX for the maximum number of server threads could have a negative impact on system performance because it affects all HTTP servers that do not explicitly specify a ThreadsPerChild directive. Be very cautious before specifying a value of *NOMAX.

La valeur du nombre maximal d'unités d'exécution du serveur est utilisée comme valeur par défaut de la directive ThreadsPerChild du serveur HTTP. Cette valeur affecte tous les serveurs HTTP pour lesquels aucune directive de configuration ThreadsPerChild n'est indiquée. Une directive ThreadsPerChild indiquée dans le fichier de configuration du serveur HTTP, ou comme valeur de démarrage, remplace cet attribut de serveur. The maximum number of server threads value is used as the default setting for the HTTP Server ThreadsPerChild directive. This value affects all HTTP servers that do not have a ThreadsPerChild configuration directive specified. A ThreadsPerChild directive specified in the HTTP server configuration file, or as a start up value, overrides this server attribute.

Consultez la documentation du serveur HTTP sur la directive ThreadsPerChild pour plus d'informations sur le nombre maximal d'unités d'exécution du serveur. See the HTTP server documentation on the ThreadsPerChild directive for more information regarding the maximum number of server threads.

Élément 1: Minimum

*SAME

Le nombre minimal d'unités d'exécution du serveur précédemment défini ne change pas. Sinon, 10 est utilisé. The minimum number of server threads that was previously set does not change. Otherwise, 10 is used.

*DFT

Le nombre minimal d'unités d'exécution du serveur prend la valeur par défaut de 10. The minimum number of server threads is set to the default value of 10.

1-9999

Indiquez le nombre minimal d'unités d'exécution du serveur dont le démarrage est demandé. Specify the minimum number of server threads requested to start.

Élément 2: Maximum

*SAME

Le nombre maximal d'unités d'exécution du serveur précédemment défini ne change pas. Sinon, 40 est utilisé. The maximum number of server threads previously set does not change. Otherwise, 40 is used.

*NOMAX

L'option *NOMAX pour le nombre maximal d'unités d'exécution du serveur a été conservée dans la commande pour des raisons de compatibilité. Indiquer la valeur *NOMAX revient à utiliser un nombre maximal d'unités d'exécution du serveur de 9999. The *NOMAX option for the maximum number of server threads has been left on the command for compatibility reasons. Specifying a value of *NOMAX uses a maximum number of server threads value of 9999.

*DFT

Le nombre maximal d'unités d'exécution du serveur prend la valeur par défaut de 40. Si vous laissez ce paramètre à sa valeur par défaut, le nombre minimal d'unités d'exécution du serveur indiqué ne peut pas être supérieur à 40. The maximum number of server threads is set to the default value of 40. If you allow this parameter to default, the minimum number of server threads specified cannot be greater than 40.

1-9999

Indiquez le nombre maximal d'unités d'exécution du serveur autorisées à démarrer. Cette valeur doit être supérieure à celle indiquée pour le premier élément de ce paramètre. Specify the maximum number of server threads that are allowed to start. This value must be greater than the value specified for the first element of this parameter.

Identificateur de jeu de caractères codés (CCSID)Coded character set identifier (CCSID)

Si le jeu de caractères et la page de codes ne sont pas identifiés dans l'en-tête MIME du navigateur World Wide Web (WWW), cette valeur sert à déterminer la valeur de l'identificateur de jeu de caractères codés (CCSID) ASCII à utiliser pour les traductions lors de la conversion ASCII vers EBCDIC et EBCDIC vers ASCII. La conversion est déterminée à partir des valeurs de l'en-tête MIME ou du CCSID ASCII indiqué et du CCSID EBCDIC par défaut du travail. If the character set and code page are not identified in the MIME header from the World Wide Web (WWW) browser, this value is used to determine the ASCII coded-character set identifier (CCSID) value to be used for translations when doing ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. Mapping is determined using the MIME header values or the specified ASCII CCSID and the EBCDIC default CCSID of the job.

La conversion sortante et entrante peut éventuellement être effectuée avec les tables de conversion définies dans les paramètres TBLHTTPOUT et TBLHTTPIN. Normalement, les paramètres TBLHTTPOUT et TBLHTTPIN sont définis à la valeur par défaut *CCSID ou *DFT, toutes deux indiquant que la valeur du paramètre CCSID est utilisée pour la conversion. Outgoing and incoming mapping can optionally be done with mapping tables defined in the TBLHTTPOUT and TBLHTTPIN parameters. Normally the TBLHTTPOUT and TBLHTTPIN parameters are set to the default of *CCSID or *DFT, with both indicating that the value used in the CCSID parameter is used for mapping.

Si une table de conversion doit être utilisée pour la conversion sortante, un objet table peut être indiqué dans le paramètre TBLHTTPOUT. Cet objet table est alors utilisé pour la conversion sortante à la place de la valeur CCSID. If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLHTTPOUT parameter. Then this table object is used for outgoing mapping instead of the CCSID value.

La conversion entrante peut être modifiée de la même manière pour utiliser une table de conversion en indiquant un objet table dans le paramètre TBLHTTPIN. Cette table de conversion remplace alors la valeur CCSID indiquée et est utilisée pour la conversion entrante. Incoming mapping can be changed to use a mapping table in the same manner by specifying a table object in the TBLHTTPIN parameter. This mapping table then overrides the specified CCSID value and is used for incoming mapping.

*SAME

La valeur CCSID précédemment définie ne change pas ; sinon, 00819 (ISO 8859-1 ASCII 8 bits) est utilisé. The CCSID value that was previously set does not change; otherwise, 00819 (ISO 8859-1 8-bit ASCII) is used.

*DFT

La valeur CCSID est 00819 (ISO 8859-1 ASCII 8 bits). The CCSID value is 00819 (ISO 8859-1 8-bit ASCII).

1-65533

Indiquez le CCSID à utiliser. Cette valeur est validée pour s'assurer qu'un CCSID ASCII valide a été demandé. Specify the CCSID to be used. This value is validated to ensure a valid ASCII CCSID has been requested.

Tables de conversion du serveur (TBLHTTPOUT)Server mapping tables (TBLHTTPOUT)

Indique l'objet table à utiliser pour convertir toutes les données sortantes du serveur dans HTTP. Les données sortantes du serveur sont converties d'EBCDIC en ASCII. Specifies the table object that is to be used to map all outgoing server data in HTTP. Outgoing server data is mapped from EBCDIC to ASCII.

Si un objet table est indiqué pour le paramètre TBLHTTPOUT, cet objet table est utilisé pour la conversion sortante. Sinon, le paramètre CCSID sert à déterminer la conversion sortante. If a table object is specified for the TBLHTTPOUT parameter, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used to determine outgoing mapping.

Valeurs uniques

*SAME

La valeur TBLHTTPOUT ne change pas si elle avait été définie précédemment ; sinon, *CCSID est utilisé. The TBLHTTPOUT value does not change if it was previously set; otherwise, *CCSID is used.

*CCSID

Le paramètre CCSID sert à déterminer la conversion sortante. The CCSID parameter is used to determine outgoing mapping.

*DFT

Le paramètre CCSID sert à déterminer la conversion sortante. The CCSID parameter is used to determine outgoing mapping.

Qualificatif 1 : Table EBCDIC/ASCII sortante Qualificatif 1: Outgoing EBCDIC/ASCII table

nom

Indiquez le nom de l'objet table à utiliser pour la conversion des données sortantes du serveur HTTP. Specify the name of the table object to be used for mapping the outgoing HTTP server data.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL

Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.

*CURLIB

La bibliothèque en cours du travail est recherchée. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Bibliothèque (TBLHTTPIN)Library (TBLHTTPIN)

Indique l'objet table utilisé pour convertir toutes les données entrantes du serveur dans HTTP. Les données entrantes du serveur sont converties d'ASCII en EBCDIC. Specifies the table object that is used to map all incoming server data in HTTP. Incoming server data is mapped from ASCII to EBCDIC.

Si un objet table est indiqué pour le paramètre TBLHTTPIN, cet objet table est utilisé pour la conversion entrante. Sinon, le paramètre CCSID sert à déterminer la conversion entrante. If a table object is specified for the TBLHTTPIN parameter, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping.

Valeurs uniques

*SAME

La valeur TBLHTTPIN ne change pas si elle avait été définie précédemment ; sinon, *CCSID est utilisé. The TBLHTTPIN value does not change if it was previously set; otherwise, *CCSID is used.

*CCSID

Le paramètre CCSID sert à déterminer la conversion entrante. The CCSID parameter is used to determine incoming mapping.

*DFT

Le paramètre CCSID sert à déterminer la conversion entrante. The CCSID parameter is used to determine incoming mapping.

Qualificatif 1 : Table ASCII/EBCDIC entrante Qualificatif 1: Incoming ASCII/EBCDIC table

nom

Indiquez le nom de l'objet table à utiliser pour la conversion des données entrantes du serveur HTTP. Specify the name of the table object to be used for mapping the incoming HTTP server data.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL

Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.

*CURLIB

La bibliothèque en cours du travail est recherchée. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée. The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Exemples

Exemple 1 : Modification des attributs HTTP pour démarrer automatiquement le serveur lorsque vous utilisez la commande CL Démarrage de TCP/IP (STRTCP). Example 1: Changing the HTTP Attributes to Automatically Start the Server When You Use the Start TCP/IP (STRTCP) CL Command.

CHGHTTPA   AUTOSTART(*YES)

Cette commande indique que le serveur démarre automatiquement la prochaine fois que vous utilisez la commande STRTCP. Les instances de serveur démarrent automatiquement si leur valeur AUTOSTART n'est pas remplacée. This command indicates that the server will automatically start up the next time that you use the STRTCP command. Server instances will start automatically if they do not have AUTOSTART overridden.

Exemple 2 : Modification du nombre maximal d'unités d'exécution du serveur. Example 2: Changing the Maximum Number of Server Threads.

CHGHTTPA   NBRSVR(10 50)

Cette commande indique qu'un maximum de 50 unités d'exécution du serveur sont autorisées à démarrer pour traiter les demandes HTTP entrantes. Notez que le nombre minimal d'unités d'exécution du serveur peut être indiqué, mais qu'il est ignoré. This command indicates that a maximum of 50 server threads will be allowed to start to handle incoming HTTP requests. Note that the minimum number of server threads is allowed to be specified, but is ignored.

Exemple 3 : Utilisation des tables de conversion du serveur Example 3: Using the Server Mapping Tables

CHGHTTPA   TBLHTTPOUT(*LIBL/TSTHTTPO)
           TBLHTTPIN(*LIBL/TSTHTTPI)

Cette commande indique que lors du prochain démarrage du serveur, celui-ci présente les caractéristiques suivantes : This command indicates that the next time the server is started, the server will have the following characteristics:

• La conversion ASCII vers EBCDIC et EBCDIC vers ASCII est effectuée à l'aide des tables de conversion sortante et entrante, plutôt qu'avec une valeur CCSID. The ASCII-to-EBCDIC and EBCDIC-to-ASCII conversion is done using the outgoing and incoming mapping tables, rather than with a CCSID value.
• Le serveur utilise une copie des informations de l'objet table TSTHTTPO pour convertir les données sortantes dans HTTP. L'objet table est recherché à l'aide de la liste de bibliothèques de l'unité d'exécution. The server uses a copy of the information that you find in the TSTHTTPO table object for mapping outgoing data in HTTP. The table object is found by using the library list for the thread.
• Le serveur utilise une copie des informations de l'objet table TSTHTTPI pour convertir les données entrantes dans HTTP. L'objet table est recherché à l'aide de la liste de bibliothèques de l'unité d'exécution. The server uses a copy of the information that you find in the TSTHTTPI table object for mapping incoming data in HTTP. The table object is found by using the library list for the thread.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP8050

Le droit *IOSYSCFG est requis pour utiliser &1. *IOSYSCFG authority required to use &1.