Aller au contenu

STRTCPPTP

Démarrer TCP/IP point à point

Start Point-to-Point TCP/IP

En bref

La commande Démarrer TCP/IP point à point (STRTCPPTP) sert à démarrer un travail de session TCP/IP point à point. The Start Point-to-Point TCP/IP (STRTCPPTP) command is used to start a point-to-point TCP/IP session job.

STRTCPPTP se lit STR (Démarrer) + TCPPTP. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRTCPPTP CFGPRF(…)

Paramètres

  • CFGPRF Profil de configuration Configuration profile obligatoire
  • OUTPUT Sortie du dialogue de script Script dialog output
  • RESTART Redémarrage Restart
  • SNDINQMSG Envoi d'un message d'interrogation Send inquiry message
  • AUTODLTCFG Suppression automatique de la configuration Autodelete configuration

Astuce : dans une session 5250, tapez STRTCPPTP 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 : Sous conditions

La commande Démarrer TCP/IP point à point (STRTCPPTP) sert à démarrer un travail de session TCP/IP point à point. Un travail de session fonctionne selon l'un des deux modes possibles : The Start Point-to-Point TCP/IP (STRTCPPTP) command is used to start a point-to-point TCP/IP session job. A session job operates in one of two possible modes:

  1. Les sessions en mode réponse (*ANS) permettent à un système distant de contacter le système local et d'établir une session TCP/IP point à point. Answer mode (*ANS) sessions allow a remote system to contact the local system and establish a point-to-point TCP/IP session.
  2. Les sessions en mode appel (*DIAL) servent à faire contacter un système distant par le système local et à établir une session TCP/IP point à point. Dial mode (*DIAL) sessions are used to have the local system contact a remote system and establish a point-to-point TCP/IP session.

Remarque : Vous pouvez démarrer avec cette commande tous les profils de type de ligne *PPP. Vous devez utiliser Systems Director Navigator pour configurer les profils *PPP. Remarque :You can start any profiles of linetype *PPP with this command. You must use Systems Director Navigator to configure *PPP profiles.

Paramètres

Mot-clé Description Valeurs possibles Remarques
CFGPRF Profil de configurationConfiguration profile Valeur caractère, *AUTOSTART Obligatoire, positionnel 1
OUTPUT Sortie du dialogue de scriptScript dialog output *ERROR, *NONE, *PRINT Facultatif
RESTART RedémarrageRestart *NO, *YES Facultatif
SNDINQMSG Envoi d'un message d'interrogationSend inquiry message *NO, *YES Facultatif
AUTODLTCFG Suppression automatique de la configurationAutodelete configuration *NO, *YES Facultatif

Profil de configuration (CFGPRF)Configuration profile (CFGPRF)

Indique le profil de configuration point à point à démarrer. *AUTOSTART indique que tous les profils de configuration point à point ayant cet attribut doivent être démarrés. Le profil indique tous les attributs et valeurs nécessaires pour définir une session. Le mode indiqué dans le profil détermine si le système local contacte un système distant (session *DIAL) ou si un système distant contacte le système local (session *ANS). Toutes les autres informations sur les caractéristiques de la session figurent également dans le profil de configuration point à point. Specifies the point-to-point configuration profile to start. *AUTOSTART indicates that all point-to-point configuration profiles with this attribute should be started. The profile specifies all the attributes and values necessary to define a session. The mode specified in the profile determines whether the local system will be contacting a remote system (*DIAL session), or if a remote system will be contacting the local system (*ANS session). All other information about the characteristics of the session is also contained in the point-to-point configuration profile.

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

*AUTOSTART
Démarre tous les fichiers de configuration point à point marqués de cet attribut. Start all point-to-point configuration files marked with this attribute.
name
Indiquez le nom d'un profil de configuration point à point valide et inactif. Specify the name of a valid, inactive point-to-point configuration profile.

Sortie du dialogue de script (OUTPUT)Script dialog output (OUTPUT)

Indique s'il faut ou non imprimer une copie du dialogue de script entre le système local et le système distant. Vous pouvez utiliser ce dialogue pour diagnostiquer les problèmes qui empêchent l'établissement d'une session TCP/IP point à point. Specifies whether or not to print a copy of the script dialog between the local system and the remote system. You can use this dialog to diagnose problems that prevent a point-to-point TCP/IP session from being successfully established.

Remarque : Ce paramètre n'a aucune incidence sur la création ou la sortie de l'historique du travail. Remarque :This parameter does not affect job log creation or output.

*ERROR
Imprime le dialogue de script uniquement si des erreurs se produisent lors de l'établissement du travail de session TCP/IP point à point. Print the script dialog only if errors occur while establishing the TCP/IP point-to-point session job.
*NONE
N'imprime pas le dialogue de script. Do not print the script dialog.
*PRINT
Imprime le dialogue de script avec la sortie spoule du travail qui a émis la commande STRTCPPTP, qu'une erreur se soit produite ou non. Print the script dialog with the spooled output of the job that issued the STRTCPPTP command, regardless of whether or not any errors occurred.

Redémarrage (RESTART)Restart (RESTART)

Indique s'il faut redémarrer le travail de session TCP/IP point à point qui exécute le profil indiqué dans le paramètre Profil de configuration (CFGPRF). Specifies whether to restart the TCP/IP point-to-point session job that is running the profile specified on the Configuration profile (CFGPRF) parameter.

Ce paramètre n'est valide que pour un profil TCP/IP point à point actif. Si le profil TCP/IP point à point n'est pas actif, ce paramètre est ignoré. This parameter is only valid when specified for an active TCP/IP point-to-point profile. If the TCP/IP point-to-point profile is not active, this parameter is ignored.

*NO
Ne redémarre pas le travail de session TCP/IP point à point. Do not restart the TCP/IP point-to-point session job.
*YES
Restart the TCP/IP point-to-point session job.

La manière dont le travail de session TCP/IP point à point est redémarré dépend du mode de la session point à point en cours. Selon le mode, la session est redémarrée comme suit : How the TCP/IP point-to-point session job is restarted depends on the mode of point-to-point session that is running. By mode, the session is restarted as follows:

Switched Line Dial (Dial remote systems)
Réinitialise la session pour qu'elle démarre en recomposant le numéro du système distant. Reset the session to start by redialing the remote system.
Switched Line Answer (Answering incoming calls)
Réinitialise la session à l'état d'attente de sonnerie (attente de l'appel du système distant). Reset the session to Ring Wait state (wait for remote system to dial in).
Leased Line (Initiator or Terminator) for PPP
Réinitialise à l'état LCP Configure Request. Reset back to LCP Configure Request state.
Leased Line (Initiator or Terminator) for SLIP
Réinitialise à l'état 'Actif' Reset back to an 'Active' state
Dial-on-Demand
Réinitialise la session pour qu'elle attende la prochaine demande de numérotation à la demande. Reset the session to wait for the next Dial-on-Demand request.

Envoi d'un message d'interrogation (SNDINQMSG)Send inquiry message (SNDINQMSG)

Indique s'il faut ou non envoyer un message d'interrogation une fois l'initialisation terminée. Le message d'interrogation est envoyé à la file d'attente de messages QTCP. Specifies whether or not to send an inquiry message after any initialization has been completed. The inquiry message will be sent to the QTCP message queue.

Tant que vous ne répondez pas au message d'interrogation, le travail de session point à point est bloqué. Pendant ce temps, vous pouvez configurer des outils de trace pour diagnostiquer les problèmes liés à ce travail de session TCP/IP point à point. Until you respond to the inquiry message, the point-to-point session job is held. While the job is held, you can set up trace tools for diagnosing problems related to this TCP/IP point-to-point session job.

Remarque : Ce paramètre est ignoré pour tous les profils de type de ligne *PPP. Remarque :This parameter is ignored for any profiles of linetype *PPP.

*NO
N'envoie pas de message d'interrogation une fois l'initialisation terminée. Do not send an inquiry message after initialization has been completed.
*YES
Le travail de session point à point envoie un message d'interrogation une fois son initialisation terminée. Si le profil de configuration possède l'attribut de création automatique du contrôleur et de l'unité, le message d'interrogation est envoyé après la création de la description de contrôleur et de la description d'unité. The point-to-point session job will send an inquiry message after it has completed its initialization. If the configuration profile has the attribute for automatic creation of the controller and device, the inquiry message will be sent after the controller description and device description have been created.

Suppression automatique de la configuration (AUTODLTCFG)Autodelete configuration (AUTODLTCFG)

Indique si les objets de configuration de description de contrôleur et de description d'unité créés automatiquement lors de l'initialisation de STRTCPPTP doivent être supprimés automatiquement à la fin du travail de session point à point. Specifies whether or not controller description and device description configuration objects that were automatically created during STRTCPPTP initialization should be automatically deleted when the point-to-point session job ends.

*NO
Ne supprime aucun objet de configuration de description de contrôleur ou de description d'unité créé automatiquement par STRTCPPTP. Cela permet de réutiliser la description de contrôleur et la description d'unité au prochain démarrage d'un travail de session TCP/IP point à point avec le profil de configuration indiqué. Do not delete any controller description and device description configuration objects that were automatically created by STRTCPPTP. This allows the controller description and device description to be reused the next time a TCP/IP point-to-point session job is started using the specified configuration profile.
*YES
Supprime tous les objets de configuration de description de contrôleur et de description d'unité créés automatiquement lors de l'initialisation de STRTCPPTP. Delete any controller description and device description configuration objects that were automatically created during STRTCPPTP initialization.

Exemples

Exemple 1 : Démarrer un travail de session TCP/IP point à point. Example 1: Start a Point-To-Point TCP/IP Session Job.

STRTCPPTP   CFGPRF(DIALPRF)

Cette commande démarre un travail de session TCP/IP point à point. Le profil de configuration point à point "DIALPRF" contient les informations qui déterminent si le système local contacte un système distant (session *DIAL) ou si un système distant contacte le système local (session *ANS). This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile "DIALPRF" contains the information that will determine whether the local system will be contacting a remote system (*DIAL session), or if a remote system will be contacting the local system (*ANS session).

Exemple 2 : Démarrer une session et capturer le dialogue de script. Example 2: Start a Session and Capture the Script Dialog.

STRTCPPTP   CFGPRF(DIALPRF)  OUTPUT(*PRINT)

Cette commande démarre un travail de session TCP/IP point à point. Le profil de configuration point à point "DIALPRF" contient les informations que le système local utilise pour contacter le système distant et établir avec lui une session TCP/IP point à point. Une copie du dialogue échangé entre les deux systèmes avant l'établissement d'une session TCP/IP point à point est écrite dans la file d'attente en sortie par défaut du travail qui a émis la commande STRTCPPTP. This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile "DIALPRF" contains the information that the local system will use to contact the remote system and establish a point-to-point TCP/IP session with it. A copy of the dialog exchanged between the two systems prior to establishing a point-to-point TCP/IP session is written to the default output queue for the job that issued the STRTCPPTP command.

Exemple 3 : Envoyer un message d'interrogation après l'initialisation du travail de session TCP/IP. Example 3: Send an Inquiry Message After Initializing the TCP/IP Session Job.

STRTCPPTP   CFGPRF(ANSWERPRF)  SNDINQMSG(*YES)

Cette commande utilise le paramètre SNDINQMSG, qui n'est normalement utilisé que s'il est nécessaire de collecter des informations de trace interne détaillées lorsque la description de contrôleur et la description d'unité utilisées par le travail de session point à point sont créées automatiquement. This command uses the SNDINQMSG parameter, which is normally used only if it is necessary to collect detailed internal trace information when the controller and device description used by the point-to-point session job are automatically created.

Cette commande démarre un travail de session TCP/IP point à point. Le profil de configuration point à point "ANSWERPRF" contient les informations qui servent à établir une session TCP/IP point à point lorsqu'un système distant contacte le système local. This command starts a point-to-point TCP/IP session job. The point-to-point configuration profile "ANSWERPRF" contains the information that will be used to establish a point-to-point TCP/IP session when a remote system contacts the local system.

Après avoir créé automatiquement la description de contrôleur et la description d'unité qu'il utilisera, le travail de session point à point envoie un message d'interrogation à la file d'attente de messages QTCP. Selon la réponse, le travail continue de s'exécuter ou est annulé. After automatically creating the controller and device description it will use, the point-to-point session job will send an inquiry message to the QTCP message queue. Depending on the response, the job will either continue running or will be cancelled.

Exemple 4 : Redémarrer un profil point à point en cours d'exécution. Example 4: Restarting a Running Point-To-Point Profile.

STRTCPPTP   CFGPRF(ANSWERPRF)  RESTART(*YES)

Cette commande redémarre le profil point à point en cours d'exécution ANSWERPRF. La manière dont la session est réinitialisée (redémarrée) dépend du type de connexion de la ligne (commutée ou non commutée) et du mode (appel ou réponse). Pour plus d'informations sur la réinitialisation de la session, voir les détails de RESTART(*YES) ci-dessus. This command will restart the running point-to-point profile ANSWERPRF. How the session is reset (restarted) depends on the connection type of the line (switched or unswitched) and the mode (dial or answer). For more information on how the session would be reset, see the details for RESTART(*YES) above.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP1A1F
Impossible de traiter la demande tant que &3/&2/&1 utilise &6. Cannot process request while &3/&2/&1 using &6.
TCP8205
L'objet requis &2/&1 de type *&3 est introuvable. Required object &2/&1 type *&3 not found.
TCP8207
STRTCPPTP &1 non exécutée. L'unité d'exécution &10 du travail &6/&5/&4 utilise &1. STRTCPPTP &1 not performed. Thread &10 in job &6/&5/&4 using &1.
TCP8208
STRTCPPTP &1 non exécutée. Voir les messages précédents. STRTCPPTP &1 not performed. See previous messages.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.