STRPASTHR

Démarrer le passe-système

En bref

La commande STRPASTHR (Démarrer le passe-système) vous permet de passer à un système cible et d'y ouvrir une session, comme si vous étiez connecté localement.

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

Syntaxe minimale

STRPASTHR RMTLOCNAME(…)

Paramètres

RMTLOCNAME Lieu éloigné obligatoire
CNNDEV Unité APPC
VRTCTL Contrôleur virtuel
VRTDEV Unité écran virtuelle
MODE Mode
LCLLOCNAME Lieu local
RMTNETID ID éloigné réseau
SRQ10PGM Programme pour appel système
RMTUSER Profil utilisateur
RMTPWD Mot de passe utilisateur
RMTINLPGM Programme initial à appeler
RMTINLMNU Menu initial
RMTCURLIB Bibliothèque en cours
PASTHRSCN Option d'affichage

Astuce : dans une session 5250, tapez STRPASTHR 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande STRPASTHR (Démarrer le passe-système) vous permet de passer à un système cible et d'y ouvrir une session, comme si vous étiez connecté localement. Pour plus de détails sur la configuration ou l'utilisation du passe-système, consultez le manuel Remote Work Station Support.

Restriction :

Vous ne pouvez pas entrer cette commande sur un poste de travail dont l'écran affiche 12 lignes et 80 caractères par ligne.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RMTLOCNAME	Lieu éloigné	Nom de communication, *CNNDEV	Obligatoire, positionnel 1
CNNDEV	Unité APPC	Valeurs uniques: LOC Autres valeurs (jusqu'à 16 répétitions): Nom*	Facultatif
VRTCTL	Contrôleur virtuel	Nom, *NONE	Facultatif, positionnel 2
VRTDEV	Unité écran virtuelle	Valeurs uniques: NONE Autres valeurs (jusqu'à 32 répétitions): Nom*	Facultatif, positionnel 3
MODE	Mode	Nom de communication, *NETATR	Facultatif
LCLLOCNAME	Lieu local	Nom de communication, LOC, NETATR	Facultatif
RMTNETID	ID éloigné réseau	Nom de communication, LOC, NETATR, *NONE	Facultatif
SRQ10PGM	Programme pour appel système	Valeurs uniques: SRQMNU Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: Programme pour appel système	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
RMTUSER	Profil utilisateur	Valeur caractère, NONE, CURRENT	Facultatif
RMTPWD	Mot de passe utilisateur	Valeur caractère, *NONE	Facultatif
RMTINLPGM	Programme initial à appeler	Nom, RMTUSRPRF, NONE	Facultatif
RMTINLMNU	Menu initial	Nom, RMTUSRPRF, SIGNOFF	Facultatif
RMTCURLIB	Bibliothèque en cours	Nom, *RMTUSRPRF	Facultatif
PASTHRSCN	Option d'affichage	Valeur caractère, YES, NO	Facultatif

Lieu éloigné (RMTLOCNAME)

Indique l'une des valeurs suivantes :

Si (*LOC) est indiqué dans l'invite Unité APPC (paramètre CNNDEV), le paramètre RMTLOCNAME indique le nom du lieu éloigné qui sera la cible de la session de passe-système.
Si des unités sont indiquées au paramètre CNNDEV, le paramètre RMTLOCNAME indique le nom du premier système assurant le routage intermédiaire.

nom-lieu-éloigné: Indiquez le nom du lieu éloigné qui sera la cible de la session de passe-système, ou le nom du premier système assurant le routage intermédiaire. Le réseau APPN déterminera le routage vers ce lieu.
*CNNDEV: Utilisez les unités APPC indiquées en regard de l'invite Unité APPC (paramètre CNNDEV).

Unité APPC (CNNDEV)

Indique les noms des descriptions d'unités qui permettent la connexion entre le premier système assurant le routage et le système cible. Si *CNNDEV est précisé pour l'invite Lieu éloigné (paramètre RMTLOCNAME), la première unité mentionnée en regard de ce paramètre fait partie du système source. Si le paramètre RMTLOCNAME indique un lieu, la première unité précisée fait partie du système désigné par ce lieu éloigné. Si un autre système relie le système source au système cible et que le passe-système établisse les sessions intermédiaires, vous devez indiquer une liste d'unités APPC. Les noms de ces unités doivent être répertoriés dans l'ordre de passage des systèmes jusqu'au système cible.

Ce paramètre admet des valeurs multiples.

*LOC: L'invite Lieu éloigné (paramètre RMTLOCNAME) indique le nom du lieu éloigné qui sera la cible de la session de passe-système.
nom(s)-unité(s): Indiquez les noms des descriptions d'unités assurant le routage entre le système source et le système cible. Vous pouvez indiquer jusqu'à 16 noms.

Contrôleur virtuel (VRTCTL)

Indique le nom du contrôleur virtuel du système éloigné utilisé pour la fonction passe-système. Si vous précisez un contrôleur virtuel, l'une des unités-écrans virtuelles rattachées à celui-ci sera sélectionnée pour effectuer l'opération. L'unité du système cible correspondante est choisie en fonction de son type et de son modèle.

VRTCTL est incompatible avec l'invite Unité écran virtuelle (paramètre VRTDEV); vous devez donc préciser *NONE si une ou plusieurs unités sont déjà indiquées pour l'invite Unité écran virtuelle (paramètre VRTDEV).

*NONE: Aucun contrôleur n'est précisé. Si, de plus, *NONE est indiqué en regard de l'invite Unité écran virtuelle (paramètre VRTDEV), vous demandez une configuration automatique.
nom-contrôleur-virtuel: Indiquez le nom du contrôleur virtuel du système cible.

Unité écran virtuelle (VRTDEV)

Indique une ou plusieurs unités du système cible connectées au contrôleur virtuel utilisé pour la session de passe-système. Les unités sont choisies dans la liste du système cible en fonction de leur type et de leur modèle.

VRTDEV est incompatible avec l'invite Contrôleur virtuel (paramètre VRTCTL) ; vous devez donc préciser *NONE si un nom de contrôleur est déjà indiqué pour l'invite Contrôleur virtuel (paramètre VRTCTL).

Ce paramètre admet des valeurs multiples.

*NONE: Aucun nom d'unité n'est précisé. Si, de plus, *NONE est indiqué en regard de l'invite Contrôleur virtuel (paramètre VRTCTL), vous demandez une configuration automatique.
nom-unité-écran-virtuelle: Indiquez un ou plusieurs noms (32 au plus) d'unités-écrans virtuelles du système cible.

Mode (MODE)

Indique le mode utilisé.

*NETATR: Le mode défini dans les attributs du réseau est utilisé.

nom-mode: Indiquez un nom de mode.

Lieu local (LCLLOCNAME)

Indique le nom du lieu local.

*LOC: Le système choisira le nom de lieu local.

*NETATR: La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.

nom-lieu-APPN: Indiquez le nom de lieu local associé au système source. Si ce nom n'est pas correct, un message d'arrêt programme est envoyé.

ID éloigné réseau (RMTNETID)

Indique l'ID du réseau où se trouve le lieu éloigné.

*LOC: N'importe quel ID éloigné du réseau peut être utilisé pour le lieu éloigné.

*NETATR: La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.

*NONE: Le lieu éloigné n'admet pas d'ID réseau.
ID-réseau-APPN: Indiquez un ID éloigné du réseau.

Programme pour appel système (SRQ10PGM)

Indique que le menu Appel système est affiché, ou spécifie le nom du programme qui démarre sur le système source lorsque l'option 10 (Appel système) est sélectionnée.

A l'aide du programme utilisateur, vous pouvez afficher un menu permettant de sélectionner le système auquel vous voulez accéder, puis transférer à un travail de groupe afin d'envoyer la commande STRPASTHR (Démarrer le passe-système) vers le système choisi. Pour plus de détails, consultez le manuel Remote Work Station Support.

*SRQMNU

Le menu Appel système du système source est affiché.

nom-programme

Indiquez le nom et la bibliothèque du programme à démarrer lorsque l'option 10 (Appel système) est sélectionnée.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*LIBL: Le programme est recherché dans la liste des bibliothèques.
*CURLIB: Le programme est recherché dans la bibliothèque en cours pour le travail. Si la bibliothèque en cours n'est pas définie dans la liste des bibliothèques, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque contenant le programme.

Profil utilisateur (RMTUSER)

Indique le profil utilisateur pour ouvrir automatiquement une session sur le système cible. Lorsqu'un profil est indiqué et que la sécurité par mot de passe est active sur le système cible, *NONE est incorrect dans l'invite Mot de passe utilisateur (paramètre RMTPWD).

*NONE: Aucun profil utilisateur n'est envoyé et l'ouverture de session automatique n'a pas lieu.
*CURRENT: Le profil utilisateur associé au travail émettant cette commande est envoyé. Si le système cible l'accepte, si le profil utilisateur existe sur ce système, et si le mot de passe indiqué dans le paramètre RMTPWD est correct pour ce profil, une session est automatiquement ouverte pour l'utilisateur. Dans le cas contraire, l'utilisateur voit apparaître un écran d'ouverture de session sur le système cible, ou un message d'erreur sur le système source, selon la configuration du système cible.
nom-profil: Indiquez le nom d'un profil utilisateur existant sur le système cible. Si le système cible l'accepte et que le profil utilisateur existe sur ce système, une session est automatiquement ouverte pour l'utilisateur. Dans le cas contraire, l'utilisateur voit apparaître un écran d'ouverture de session sur le système cible, ou un message d'erreur sur le système source, selon la configuration du système cible. Si un profil est indiqué et que la sécurité par mot de passe est active sur le système cible, vous devez entrer un mot de passe, même si le profil indiqué est identique au profil en cours.

Mot de passe utilisateur (RMTPWD)

Indique le mot de passe envoyé au système cible.

*NONE: Le système n'envoie pas de mot de passe. Si un profil est indiqué en regard de l'invite Profil utilisateur (paramètre RMTUSER) et si la sécurité par mot de passe est active sur le système cible, cette valeur n'est pas admise.
mot-de-passe: Indiquez un mot de passe qui sera envoyé au système cible et permettra de vérifier que l'utilisateur mentionné au paramètre RMTUSER est autorisé à ouvrir une session. Ce mot de passe est transmis sous forme chiffrée.

Programme initial à appeler (RMTINLPGM)

Indique le programme appelé immédiatement après l'ouverture de session.

*RMTUSRPRF: Le programme initial indiqué dans le profil utilisateur éloigné est immédiatement appelé après l'ouverture de session automatique.
*NONE: Aucun programme n'est lancé avant l'affichage du menu initial, même si un programme initial est mentionné dans le profil utilisateur éloigné.
programme: Indiquez le nom du programme qui devra être appelé immédiatement après l'ouverture de session automatique.

Menu initial (RMTINLMNU)

Indique le premier menu affiché à l'ouverture de session automatique sur le système cible après exécution du programme initial.

*RMTUSRPRF: Le menu initial indiqué dans le profil utilisateur éloigné est immédiatement affiché après exécution du programme initial.
*SIGNOFF: Aucun menu n'est affiché après exécution du programme initial, même si un menu initial est mentionné dans le profil utilisateur éloigné. A la fin du programme initial, la session utilisateur est fermée et la session de passe-système se termine.
menu: Indiquez le menu devant apparaître immédiatement après exécution du programme initial.

Bibliothèque en cours (RMTCURLIB)

Indique la bibliothèque qui deviendra la bibliothèque en cours dans la liste des bibliothèques du travail après l'ouverture automatique de session.

*RMTUSRPRF: La bibliothèque en cours indiquée dans le profil utilisateur éloigné devient la bibliothèque en cours dans la liste des bibliothèques après l'ouverture de session automatique.
bibliothèque: Indiquez la bibliothèque qui devient la bibliothèque en cours dans la liste des bibliothèques après l'ouverture de session automatique.

Option d'affichage (PASTHRSCN)

Indique si l'écran passe-système et les messages d'état associés sont affichés avant que la session de passe-système ne soit établie.

*YES: L'écran passe-système et les messages d'information s'affichent avant l'ouverture de la session de passe-système.
*NO: L'écran passe-système et les messages d'information ne s'affichent pas avant l'ouverture de la session de passe-système.

Exemples

Exemple 1 : passe-système vers Toronto

STRPASTHR   RMTLOCNAME(*CNNDEV)  CNNDEV(DET CHI TOR)  VRTCTL(VWSC)

Cette commande permet de démarrer un passe-système vers le système basé à Toronto, en passant par Détroit et Chicago. Pour plus d'informations, reportez-vous à la rubrique Remote Work Station Support de l'Information Center.

Exemple 2 : passe-système vers Détroit

STRPASTHR   RMTLOCNAME(DETROIT)  VRTCTL(VWSC)

Cette commande permet de définir un passe-système vers le système basé à Détroit. L'APPN indique le chemin vers Détroit.

Exemple 3 : passe-système vers Toronto

STRPASTHR   RMTLOCNAME(DETROIT)  CNNDEV(CHI TOR)  VRTCTL(VWSC)

Cette commande permet de définir un autre chemin de passe-système vers le système basé à Toronto, en passant par Chicago et Détroit. L'APPN indique le chemin vers Détroit.

Exemple 4 : passe-système vers Détroit

STRPASTHR   RMTLOCNAME(DETROIT)  RMTUSER(*CURRENT)

Cette commande permet de définir un passe-système vers le système basé à Détroit et d'établir une connexion automatique via le profil utilisateur (même nom que celui utilisé sur le système source). Dans la mesure où aucun contrôleur virtuel ou unité virtuelle n'a été défini(e), le système basé à Détroit configure de façon automatique une unité virtuelle pour la session passe-système.

Messages d'erreur

Messages *ESCAPE

CPF2702: Description d'unité &1 non trouvée.
CPF2703: Description de contrôleur &1 non trouvée.
CPF5383: Le mode &7 indiqué pour l'unité &4 est incorrect.
CPF5536: Le système ne peut pas sélectionner automatiquement une description d'unité APPC pour le lieu éloigné.
CPF5546: Classe de service incorrecte pour l'unité &4.
CPF8901: L'unité virtuelle &1 n'est pas en fonction.
CPF8902: Unité virtuelle &1 non disponible.
CPF8903: Unité &1 incorrecte pour la fonction passe-système.
CPF8904: Demande de passe-système rejetée.
CPF8905: Fonction passe-système non admise sur ce système.
CPF8906: Erreur lors de la session d'initialisation. Code raison &1.
CPF8907: Erreur de communications pour l'unité &1.
CPF8908: Le contrôleur &1 n'est pas en fonction.
CPF8909: Ancienne édition du logiciel. Fonction passe-système interrompue.
CPF8910: Contrôleur &1 incorrect pour la fonction passe-système.
CPF8911: Erreur de communications. Session non démarrée.
CPF8912: Session de la fonction passe-système interrompue. Code raison &1.
CPF8913: Fin anormale de la fonction passe-système.
CPF8916: Impossible de sélectionner unité virtuelle &1 sur système &2.
CPF8917: Accès à &1 non autorisé.
CPF8918: Travail annulé sur le système &1.
CPF8919: Accès à l'unité &1 non établi par le système &2.
CPF8920: Echec de la fonction passe-système. Mettre &1 hors/en fonction.
CPF8921: Erreur APPC. Code d'erreur : &3.
CPF8922: Réponse négative de l'unité &1 au système &2.
CPF8923: Flot de données incorrect reçu sur le système &1.
CPF8924: Aucun contrôleur virtuel disponible.
CPF8925: Unité &1 non créée.
CPF8928: Modification de l'unité &1 impossible.
CPF8929: Mise en fonction de l'unité &1 impossible.
CPF8931: &1 n'est pas un lieu APPC.
CPF8932: &1 doit être une unité APPC non-réseau.
CPF8933: Route non trouvée pour le lieu indiqué.
CPF8935: Fonction passe-système non admise vers système &1.
CPF8936: Impossible de lancer la fonction passe-système pour raisons de sécurité.
CPF8937: Ouverture de session automatique non admise.
CPF8938: Erreur dans le programme QRMTSIGN. Echec de la fonction passe-système.
CPF8939: Trop de données à transmettre.
CPF8940: Impossible de sélectionner automatiquement l'unité virtuelle.
CPF8941: Utilisation interne incorrecte du mode transparent (pass-through). Incorrect internal use of pass-through.
CPF8943: Fonction passe-système non admise sur serveur de session TELNET.

Messages *STATUS

CPI8901: Aucune unité de type concordant sur système éloigné. Fonctions limitées.
CPI8902: Passe-système démarré sur système &1.
CPI8903: Unité virtuelle &1 sélectionnée sur système &2.
CPI8906: Ouverture de session automatique non admise.