ENDTCP

La commande Arrêter TCP/IP (ENDTCP) arrête le traitement TCP/IP. The End TCP/IP (ENDTCP) command ends TCP/IP processing.

Attention : Attention:

La commande ENDTCP doit être utilisée avec précaution. Lorsqu'elle est utilisée, elle arrête tout le traitement TCP/IP sur le système sur lequel vous travaillez. The ENDTCP command must be used carefully. When it is used, it ends all TCP/IP processing on the system that you are working on.

Si OPTION(*IMMED) est indiqué pour la commande ENDTCP, les points suivants sont vrais : If OPTION(*IMMED) is specified for the ENDTCP command, the following is true:

• Toutes les connexions TCP/IP sont arrêtées. Cela affecte toutes les applications actuellement actives qui utilisent des sockets. All TCP/IP connections are ended. This affects all currently active applications using sockets.
• Sauf si ENDSVR(*NO) est indiqué, les travaux serveur TCP/IP sont arrêtés pour TELNET, FTP, TFTP, SMTP, LPD, HTTP, POP, RouteD, DHCP, DNS, DDM, BOOTP, REXEC, SNMP, DIRSRV, INETD, MGTC, ONDMD, NETSVR, DLFM, VPN, EDRSQL, NTP, QoS, TCM, DOMINO, WEBFACING, OMPROUTED et CIMOM. Unless ENDSVR(*NO) is specified, TCP/IP server jobs are ended for TELNET, FTP, TFTP, SMTP, LPD, HTTP, POP, RouteD, DHCP, DNS, DDM, BOOTP, REXEC, SNMP, DIRSRV, INETD, MGTC, ONDMD, NETSVR, DLFM, VPN, EDRSQL, NTP, QoS, TCM, DOMINO, WEBFACING, OMPROUTED and CIMOM.
• Les agents actuellement actifs dans le sous-système QSYSWRK sont arrêtés. Voir la description du paramètre Arrêter les serveurs d'applications (ENDSVR) pour plus d'informations. Agents that are currently active in the QSYSWRK subsystem are ended. See the description of the End application servers (ENDSVR) parameter for more information.
• Toutes les interfaces TCP/IP actives sont arrêtées. All active TCP/IP interfaces are ended.

Si OPTION(*CNTRLD) est indiqué pour la commande ENDTCP, les points suivants sont vrais : If OPTION(*CNTRLD) is specified for the ENDTCP command, the following is true:

• Aucune nouvelle opération d'ouverture n'est autorisée pour les sockets TCP, UDP ou bruts. No new open operations are allowed to TCP, UDP, or raw sockets.
• Un travail est soumis au sous-système QSYSWRK ; à l'expiration du délai indiqué dans la valeur du paramètre DELAY, il effectue une opération ENDTCP *IMMED. A job is submitted to the QSYSWRK subsystem that will, after the time indicated in the DELAY parameter value has expired, do an ENDTCP *IMMED operation.
• Une commande ENDTCP OPTION(*IMMED) peut être soumise à tout moment après l'émission de ENDTCP OPTION(*CNTRLD). Elle annule l'arrêt contrôlé. Le traitement TCP/IP est arrêté immédiatement lorsque ENDTCP OPTION(*IMMED) est émise. An ENDTCP OPTION(*IMMED) can be submitted at any time after issuing ENDTCP OPTION(*CNTRLD). This cancels the controlled end. TCP/IP processing is ended immediately when the ENDTCP OPTION(*IMMED) is issued.

Restrictions:

• Cette commande est compatible multitâche sous condition. Elle appelle différents programmes pour traiter chaque type de serveur TCP/IP. Si les programmes appelés sont compatibles multitâche, cette commande l'est également. This command is conditionally threadsafe. This command calls different programs to process each type of TCP/IP server. If the programs being called are threadsafe, this command is threadsafe.

Paramètres

Type d'arrêt (OPTION)

Indique si le traitement TCP/IP est arrêté de manière immédiate ou contrôlée. Specifies whether TCP/IP processing is ended in an immediate or controlled manner.

*IMMED

TCP/IP processing is ended immediately.

Attention : Attention:

La commande ENDTCP OPTION(*IMMED) doit être utilisée avec précaution. Des données partiellement mises à jour peuvent en résulter si une application traite des données et n'a pas terminé une opération lorsque la commande ENDTCP *IMMED est émise. Il est conseillé de procéder comme suit : The ENDTCP OPTION(*IMMED) command should be used carefully. Partially updated data may result if an application is processing data and has not completed an operation when the ENDTCP *IMMED command is issued. It is suggested that you do the following:

• Avertissez tous les utilisateurs avant d'émettre la commande ENDTCP afin qu'ils puissent arrêter leurs applications. Notify all users before issuing the ENDTCP command so that they can end their applications.
• Émettez la commande ENDTCP à un moment où vous savez qu'aucun trafic TCP/IP n'existe sur le système. Pour afficher le trafic TCP/IP en cours sur le système, utilisez l'option 3 de la commande Gestion de l'état TCP/IP (WRKTCPSTS ou NETSTAT). Issue the ENDTCP command at a time when you know no TCP/IP traffic is occurring on the system. To display the current TCP/IP traffic on the system, use option 3 on the Work with TCP/IP Status (WRKTCPSTS or NETSTAT) command.

*CNTRLD

TCP/IP processing is ended in a controlled manner. Applications using TCP/IP are given time to complete their processing. New application processing is not allowed. After the specified period of time elapses, the processing for ENDTCP OPTION(*IMMED) is performed.

Le traitement d'arrêt contrôlé ne fait pas ce qui suit : The controlled end processing does not do any of the following:

• Il ne vérifie pas si tout le traitement TCP/IP est terminé avant l'expiration du délai indiqué. It does not monitor to see if all TCP/IP processing has completed before the specified period of time has elapsed.
• Il n'avertit pas une application qui utilise activement une connexion TCP/IP que le traitement TCP/IP va être arrêté. It does not notify an application that is actively using a TCP/IP connection that TCP/IP processing will be ended.

Délai d'arrêt contrôlé (DELAY)

Indique le délai (en secondes) accordé pour effectuer un arrêt contrôlé du traitement TCP/IP. Passé ce délai, tout le traitement TCP/IP est arrêté immédiatement. Specifies the amount of time (in seconds) allowed in which to complete a controlled end of TCP/IP processing. After this period of time all TCP/IP processing is ended immediately.

1-86400

Indiquez le nombre de secondes dans lequel l'opération d'arrêt est effectuée. Specify the number of seconds in which the end operation is completed.

Arrêter les serveurs d'applications (ENDSVR)End application servers (ENDSVR)

Indique si tous les travaux serveur d'applications TCP/IP sont arrêtés lorsque la commande ENDTCP arrête le traitement TCP/IP. Specifies whether or not all TCP/IP application server jobs are ended when the ENDTCP command ends TCP/IP processing.

Attention : Attention:

Avant d'indiquer *NO pour ce paramètre, tenez compte de ce qui suit : Before specifying *NO for this parameter, please consider the following:

• Il n'est pas possible d'arrêter tout le traitement TCP/IP de votre système sans affecter les applications qui utilisent TCP/IP. It is not possible to end all the TCP/IP processing on your system without affecting the applications which use TCP/IP.
• Si le traitement TCP/IP est arrêté et qu'aucune forme d'émulation TCP/IP (telle qu'AnyNet) n'est active, les applications TCP/IP qui ne sont pas redémarrées ne fonctionneront pas correctement. If TCP/IP processing is ended and no form of TCP/IP emulation (such as AnyNet) is active, then TCP/IP applications which are not restarted will not function correctly.

*YES

La commande ENDTCP arrête tous les serveurs d'applications TCP/IP avant d'arrêter le traitement TCP/IP. The ENDTCP command ends all TCP/IP application servers prior to ending TCP/IP processing.

*NO

La commande ENDTCP n'arrête aucun travail serveur d'applications TCP/IP lorsqu'elle arrête le traitement TCP/IP. The ENDTCP command does not end any TCP/IP application server jobs when it ends TCP/IP processing.

Remarque :ENDTCP ENDSVR(*NO) peut être utilisée pour arrêter le traitement TCP/IP sans perturber le fonctionnement des travaux utilisant AnyNet. Le traitement TCP/IP sera arrêté, mais les serveurs d'applications TCP/IP qui utilisent AnyNet continueront de fonctionner. Remarque :ENDTCP ENDSVR(*NO) can be used to end TCP/IP processing without disturbing the operation of jobs using AnyNet. TCP/IP processing will be ended, however TCP/IP application servers that are using AnyNet will continue to function.

Si TCP/IP et AnyNet sont tous deux inactifs, utilisez la commande Arrêter le serveur TCP/IP (ENDTCPSVR) pour arrêter les travaux serveur d'applications TCP/IP. If both TCP/IP and AnyNet are inactive, use the End TCP/IP Server (ENDTCPSVR) command to end TCP/IP application server jobs.

Confirmer (CONFIRM)Confirm (CONFIRM)

Indique si la demande doit être confirmée avant l'arrêt de TCP/IP. Specifies whether the request should be confirmed before TCP/IP is ended.

*ENVVAR

La valeur de la variable d'environnement QIBM_ENDTCP_CONFIRM est utilisée pour déterminer si la demande doit être confirmée. Si la valeur est *INTERACT, *YES ou *NO, l'action décrite ci-dessous pour cette valeur est effectuée. Si la variable d'environnement n'est pas définie ou n'a pas l'une de ces valeurs, il n'y a pas de confirmation. The value in environment variable QIBM_ENDTCP_CONFIRM is used to determine whether the request should be confirmed. If the value is set to *INTERACT, *YES, or *NO, the action described below for that value is taken. If the environment variable is not defined or not set to one of these values, then there is no confirmation.

*INTERACT

Un panneau de confirmation est affiché lorsque la commande ENDTCP est émise dans un travail interactif. Il n'y a pas de confirmation lorsque la commande ENDTCP est émise dans un travail non interactif. A confirmation panel is displayed when the ENDTCP command is issued in an interactive job. There is no confirmation when the ENDTCP command is issued in a non-interactive job.

*YES

Un panneau de confirmation est affiché lorsque la commande ENDTCP est émise dans un travail interactif. Un message d'interrogation est envoyé à QSYSOPR lorsque la commande ENDTCP est émise dans un travail non interactif. A confirmation panel is displayed when the ENDTCP command is issued in an interactive job. An inquiry message is sent to QSYSOPR when the ENDTCP command is issued in a non-interactive job.

*NO

Il n'y a pas de confirmation lorsque la commande ENDTCP est émise. There is no confirmation when the ENDTCP command is issued.

Exemples

Exemple 1 : Arrêt immédiat de TCP/IP Example 1: Ending TCP/IP Immediately

ENDTCP   OPTION(*IMMED)

Cette commande arrête immédiatement tout le traitement TCP/IP sur le système. This command ends all TCP/IP processing on the system immediately.

Exemple 2 : Arrêt de TCP/IP dans un délai contrôlé Example 2: Ending TCP/IP in a Controlled Time

ENDTCP   OPTION(*CNTRLD)  DELAY(120)

Cette commande arrête tout le traitement TCP/IP après l'expiration de 120 secondes. Pendant ce temps, aucun nouveau traitement TCP/IP n'est autorisé. This command ends all TCP/IP processing after 120 seconds have expired. During this time, new TCP/IP processing is not allowed.

Exemple 3 : Arrêt immédiat de TCP/IP sans arrêt des serveurs d'applications Example 3: Ending TCP/IP Immediately Without Ending Application Servers

ENDTCP   OPTION(*IMMED)  ENDSVR(*NO)

Cette commande arrête immédiatement tout le traitement TCP/IP sur le système. Toutefois, les serveurs d'applications TCP/IP (FTP, SMTP, etc.) qui sont actifs ne sont pas arrêtés lorsque le traitement TCP/IP est arrêté. This command ends all TCP/IP processing on the system immediately. However, any TCP/IP application servers (FTP, SMTP, and so on) that are active are not ended when TCP/IP processing is ended.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP1A13

Un autre travail démarre ou arrête TCP/IP ou IP over SNA. Another job is starting or ending TCP/IP or IP over SNA.

TCP1A70

&1 n'est pas actif. &1 not active.

TCP1A72

TCP/IP est déjà en cours d'arrêt avec l'option *CNTRLD. TCP/IP already ending with *CNTRLD option.

TCP1A73

Objet interne endommagé. Internal object damaged.

TCP1A74

Une erreur s'est produite lors de la soumission du travail. Error occurred submitting job.

TCP1A77

&1 s'est terminé correctement ; toutefois, des erreurs se sont produites. &1 completed successfully; however errors occurred.

TCP8A3F

Impossible de déterminer si l'opération s'est terminée. Unable to determine if operation completed.

TCP9999

Erreur système interne dans le programme &1. Internal system error in program &1.