ADDTCPSVR

La commande Ajout de serveur TCP/IP (ADDTCPSVR) permet d'ajouter des serveurs à la liste des serveurs pris en charge par les commandes Démarrage de serveur TCP/IP (STRTCPSVR) et Fin de serveur TCP/IP (ENDTCPSVR). The Add TCP/IP Server (ADDTCPSVR) command is used to add servers to the list of servers supported by the Start TCP/IP Server (STRTCPSVR) and End TCP/IP Server (ENDTCPSVR) commands.

Les serveurs ajoutés avec la commande ADDTCPSVR peuvent être modifiés avec la commande Modification de serveur TCP/IP (CHGTCPSVR) ou supprimés avec la commande Retrait de serveur TCP/IP (RMVTCPSVR). Servers added with the ADDTCPSVR command can be changed with the Change TCP/IP Server (CHGTCPSVR) command or removed with the Remove TCP/IP Server (RMVTCPSVR) command.

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

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

Indique la valeur spéciale utilisée pour identifier le serveur ajouté. Cette valeur est utilisée par les commandes Démarrage de serveur TCP/IP (STRTCPSVR) et Fin de serveur TCP/IP (ENDTCPSVR). Specifies the special value to be used to identify the server being added. This value will be used by the Start TCP/IP Server (STRTCPSVR) and End TCP/IP Server (ENDTCPSVR) commands.

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

valeur-caractère

Specify a special value (up to 10 characters) that will identify the server to be added. The following rules and restrictions apply:

• Le premier caractère doit être un astérisque ('*') The first character must be an asterisk ('*')
• Le deuxième caractère doit être une lettre majuscule ('A-Z'), $, # ou @. The second character must be an uppercase letter ('A-Z'), $, # or à.
• Les caractères restants doivent être des lettres majuscules ('A-Z'), des chiffres ('0-9'), $, #, @, des traits de soulignement (_) et des points (.). The remaining characters must be uppercase letters ('A-Z'), numbers ('0-9'), $, #, à, underscores (_), and periods (.).

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)

Les données suivantes sont transmises dans un seul argument au programme défini : The following data will be passed in a single argument to the defined program:

• A 10 character field indicating the action being performed:
  • "*START " - si STRTCPSVR ou STRTCP est émis. "*START " - if STRTCPSVR or STRTCP is issued.
  • "*END " - si ENDTCPSVR ou ENDTCP est émis. "*END " - if ENDTCPSVR or ENDTCP is issued.
• Une zone réservée de 20 caractères contenant des blancs. A 20 character reserved field containing blanks.
• Une zone réservée de 2 octets contenant des zéros. A 2 byte reserved field containing zeros.
• Une zone de 32 caractères contenant le nom de l'instance à démarrer ou à arrêter. Cette zone est complétée par des blancs. A 32 character field containing the instance name to be started or ended. This field is padded with blanks.
• Une zone binaire de 4 octets contenant la longueur des valeurs de démarrage de l'instance. A 4 byte binary field containing the length of the instance startup values.
• Jusqu'à 300 caractères contenant les valeurs de démarrage de l'instance. Up to 300 characters containing the instance startup values.

Remarque :Les serveurs qui ne prennent pas en charge plusieurs instances doivent uniquement traiter les 10 premiers caractères des données, qui contiennent l'action en cours d'exécution. Remarque :Servers that do not support multiple instances are only required to process the first 10 characters of data which contain the action being performed.

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

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.

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.

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

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.

*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.

*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

ADDTCPSVR   SVRSPCVAL(*XYZ)
            PGM(MYLIB/UUSTARTXYZ)
            SVRNAME('XYZ protocol server')
            SVRTYPE('XYZ')  AUTOSTART(*YES)

Cette commande ajoute un nouveau serveur à la liste des serveurs pris en charge par les commandes CL STRTCPSVR (Démarrage de serveur TCP/IP) et ENDTCPSVR (Fin de serveur TCP/IP). Le nouveau type de serveur peut être sélectionné dans les commandes STRTCPSVR ou ENDTCPSVR en indiquant SERVER(*XYZ). Le programme utilisateur UUSTARTXYZ de la bibliothèque MYLIB est appelé lorsque le serveur XYZ est démarré ou arrêté. Le nouveau serveur est 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émarrage de TCP/IP). This command adds a new server to the list of servers supported by the STRTCPSVR (Start TCP/IP Server) and ENDTCPSVR (End TCP/IP Server) CL commands. The new server type can be selected on the STRTCPSVR or ENDTCPSVR commands by specifying SERVER(*XYZ). User program UUSTARTXYZ in library MYLIB will be called when the XYZ server is started or ended. The new server will 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

TCP1621

Le serveur TCP/IP &1 n'a pas été ajouté. TCP/IP server &1 not added.