CHGTCPSVR

Modifier serveur TCP/IP

Change TCP/IP Server

En bref

La commande Modifier un serveur TCP/IP (CHGTCPSVR) permet de modifier un serveur précédemment défini à l'aide de la commande Ajouter un serveur TCP/IP (ADDTCPSVR). The Change TCP/IP Server (CHGTCPSVR) command is used to change a server that was previously defined using the Add TCP/IP Server (ADDTCPSVR) command.

CHGTCPSVR se lit CHG (Modifier) + TCPSVR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGTCPSVR SVRSPCVAL(…)

Paramètres

SVRSPCVAL Valeur spéciale du serveur Server special value obligatoire
PGM Programme à appeler Program to call
SVRNAME Nom du serveur Server name
SVRTYPE Type de serveur Server type
AUTOSTART Démarrage automatique Autostart
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGTCPSVR puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Modifier un serveur TCP/IP (CHGTCPSVR) permet de modifier un serveur précédemment défini à l'aide de la commande Ajouter un serveur TCP/IP (ADDTCPSVR). Toutes les valeurs définies pour le serveur peuvent être modifiées, à l'exception de la valeur spéciale du serveur (SRVSPCVAL). The Change TCP/IP Server (CHGTCPSVR) command is used to change a server that was previously defined using the Add TCP/IP Server (ADDTCPSVR) command. All values defined for the server can be changed except for the server special value (SRVSPCVAL).

Restrictions:

Vous devez posséder les droits spéciaux de configuration du système d'entrée-sortie (*IOSYSCFG) et sur tous les objets (*ALLOBJ) pour exécuter cette commande. You must have input/output system configuration (*IOSYSCFG) and all object (*ALLOBJ) special authorities to run this command.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SVRSPCVAL	Valeur spéciale du serveurServer special value	Valeur caractère	Obligatoire, clé, positionnel 1
PGM	Programme à appelerProgram to call	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif, positionnel 2
	Qualificatif 1 : Programme à appelerQualificatif 1: Program to call	Nom
	Qualificatif 2: Biblio	Nom
SVRNAME	Nom du serveurServer name	Valeur caractère, *SAME	Facultatif, positionnel 3
SVRTYPE	Type de serveurServer type	Valeur caractère, *SAME	Facultatif, positionnel 4
AUTOSTART	Démarrage automatiqueAutostart	SAME, YES, *NO	Facultatif, positionnel 5
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif, positionnel 6

Valeur spéciale du serveur (SVRSPCVAL)Server special value (SVRSPCVAL)

Indique la valeur spéciale du serveur à modifier. Specifies the special value for the server to be changed.

Ce paramètre est obligatoire. This is a required parameter.

valeur-caractère: Indiquez la valeur spéciale du serveur à modifier. Specify the special value of the server to be changed.

Programme à appeler (PGM)Program to call (PGM)

Indique le programme à appeler lorsque ce serveur est démarré ou arrêté par les commandes suivantes : Specifies the program to be called when this server is started or ended by the following commands:

Démarrage de serveur TCP/IP (STRTCPSVR) Start TCP/IP Server (STRTCPSVR)
Fin de serveur TCP/IP (ENDTCPSVR) End TCP/IP Server (ENDTCPSVR)
Démarrage de TCP/IP (STRTCP) - si le serveur est défini avec AUTOSTART(*YES) Start TCP/IP (STRTCP) - if the server is defined as AUTOSTART(*YES)
Fin de TCP/IP (ENDTCP) End TCP/IP (ENDTCP)

Valeurs uniques

*SAME: Le programme à appeler reste le même. The program to be called remains the same.

Qualificatif 1 : Programme à appeler Qualificatif 1: Program to call

nom: Indiquez le nom du programme à appeler lorsque ce serveur est démarré ou arrêté. Specify the name of the program to be called when this server is started or ended.

Qualificatif 2: Biblio

nom: Indiquez le nom de la bibliothèque où se trouve le programme. Specify the name of library where the program is located.

Nom du serveur (SVRNAME)Server name (SVRNAME)

Indique le nom de texte du serveur que Systems Director Navigator utilise pour afficher une entrée pour ce serveur. Specifies the textual server name that will be used by Systems Director Navigator to display an entry for this server.

Ce paramètre est obligatoire. This is a required parameter.

*SAME: Le nom textuel du serveur reste le même. The textual server name remains the same.
valeur-caractère: Indiquez le nom de texte de ce serveur. Specify the text name of this server.

Type de serveur (SVRTYPE)Server type (SVRTYPE)

Indique le type de serveur que les fonctions de gestion du travail de Systems Director Navigator utilisent pour trouver les informations de travail de ce serveur, telles que les historiques de travail et l'état du serveur. Specifies the server type that will be used by Work Management functions from Systems Director Navigator to find job information, such as joblogs and server status, for this server.

*SAME

Le type de serveur reste le même. The server type remains the same.

valeur-caractère

Specify the server type name to be used by Systems Director Navigator to find joblog information and server status. The following rules and restrictions apply:

Les blancs intégrés ou les caractères nuls ne sont pas autorisés. Imbedded blanks or null characters are not allowed.
Le travail serveur qui s'exécute sur le système doit également avoir le type de serveur défini pour ce travail. Pour cela, ajoutez la définition du type de serveur à l'aide de l'API Modification de travail (QWTCHGJB) après le démarrage du travail serveur. Consultez l'API Modification de travail (QWTCHGJB) pour plus de détails sur la définition du type de serveur dans le travail serveur. Si le type de serveur n'est pas défini dans le travail serveur ou s'il ne correspond pas à celui défini dans le paramètre SVRTYPE, les informations d'historique du travail et l'état du serveur ne sont pas disponibles avec Systems Director Navigator. The server job running on the system must also have the server type defined for that job. This is done by adding the server type definition using the Change Job (QWTCHGJB) API after the server job is started. See the Change Job (QWTCHGJB) API for more detail on how to define the server type within the server job. If the server type is not set within the server job or if the server type does not match what is defined on the SVRTYPE parameter, joblog information and server status will not be available using Systems Director Navigator.

Démarrage automatique (AUTOSTART)Autostart (AUTOSTART)

Indique si le serveur ajouté doit être démarré lors de l'exécution de la commande Démarrage de TCP/IP (STRTCP). Specifies whether the server being added should be started when the Start TCP/IP (STRTCP) command is run.

*SAME: La valeur de démarrage automatique du serveur reste la même. The server autostart value remains the same.
*NO: Le serveur ajouté ne doit pas démarrer lors de l'exécution de la commande STRTCP. The server being added should not start when the STRTCP command runs.
*YES: Le serveur ajouté doit démarrer lors de l'exécution de la commande STRTCP. The server being added should start when the STRTCP command runs.

Texte 'descriptif' (TEXT)

Indique une description de texte du serveur ajouté. Specifies a text description for the server being added.

*SAME: La description textuelle reste la même. The text description remains the same.
*BLANK: Aucun texte n'est indiqué. No text is specified.

valeur-caractère: Indiquez 50 caractères de texte au maximum, placés entre apostrophes. Specify no more than 50 characters of text, enclosed in apostrophes.

Exemples

CHGTCPSVR   SVRSPCVAL(*XYZ)
            PGM(MYLIB/MYSTARTXYZ)
            AUTOSTART(*NO)

Cette commande modifie un serveur existant dans la liste des serveurs pris en charge par les commandes CL STRTCPSVR (Démarrer un serveur TCP/IP) et ENDTCPSVR (Arrêter un serveur TCP/IP). Le programme utilisateur à appeler lors du démarrage ou de l'arrêt du serveur XYZ devient le programme MYSTARTXYZ de la bibliothèque MYLIB. Le serveur XYZ ne sera pas démarré automatiquement lors de l'exécution de la commande STRTCPSVR avec SERVER(*AUTOSTART), ou lors de l'exécution de la commande STRTCP (Démarrer TCP/IP). This command changes an existing server in the list of servers supported by the STRTCPSVR (Start TCP/IP Server) and ENDTCPSVR (End TCP/IP Server) CL commands. The user program that is to be called when the XYZ server is started or ended is changed to program MYSTARTXYZ in library MYLIB. The XYZ server will not be started automatically when the STRTCPSVR command is run specifying SERVER(*AUTOSTART), or when the STRTCP (Start TCP/IP) command is run.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP1631: Le serveur TCP/IP &1 n'a pas été modifié. TCP/IP server &1 not changed.