Commande CL IBM i (AS/400)

RLSRMTPHS

Libérer phase éloignée

En bref

La commande RLSRMTPHS lance une session entre l'IBM System i et un système hôte System/370 NetView Distribution Manager (NDM).

RLSRMTPHS se lit RLS (Libérer) + RMTPHS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RLSRMTPHS PHASE(…) PLAN(…) APPID(…) RMTLOCNAME(…) DEV(…)

Paramètres

PHASE Phase obligatoire
PLAN Plan obligatoire
APPID Identificateur d'application obligatoire
RMTLOCNAME Lieu éloigné obligatoire
DEV Unité obligatoire

Astuce : dans une session 5250, tapez RLSRMTPHS 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 RLSRMTPHS lance une session entre l'IBM System i et un système hôte System/370 NetView Distribution Manager (NDM). Une fois la phase libérée par NDM (ou après un essai infructueux), la session est close.

Les remarques suivantes s'appliquent lors de l'exécution de cette commande :

Le plan NDM précisé dans le paramètre PLAN doit exister, et doit avoir été préalablement soumis à l'application hôte NDM désignée par le paramètre APPID.
La phase NDM précisée par le paramètre PHASE doit exister et faire partie du plan NDM indiqué par le paramètre PLAN.
La phase NDM précisée par le paramètre PHASE doit, sur le système hôte, être à l'état RETENU.
L'unité précisée par le paramètre DEV doit être de type SNUF et doit admettre PSR (demande de démarrage de programme).
Cette commande ne s'exécute que sur un noeud fonctionnant en interface hôte pour le système hôte NDM. Cependant, vous pouvez également libérer d'autres phases NDM que celles ayant pour destination le noeud émetteur de la commande. Toute phase peut donc être libérée pour tout noeud partageant le noeud interface hôte.

Restriction: Pour utiliser cette commande, l'utilisateur doit ouvrir une session QPGMR ou QSYSOPR, ou disposer du droit *ALLOBJ.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PHASE	Phase	Nom de communication	Obligatoire, positionnel 1
PLAN	Plan	Nom de communication	Obligatoire, positionnel 2
APPID	Identificateur d'application	Nom	Obligatoire, positionnel 3
RMTLOCNAME	Lieu éloigné	Nom de communication	Obligatoire, positionnel 4
DEV	Unité	Nom	Obligatoire, positionnel 5

Phase (PHASE)

Indique le nom de la phase NDM à libérer. Cette phase doit exister sur le système hôte NDM, faire partie du plan défini au paramètre PLAN et être à l'état RETENU.

Ce paramètre est obligatoire.

Plan (PLAN)

Indique le nom du plan NDM contenant la phase à libérer. Ce plan doit exister sur le système hôte NDM.

Ce paramètre est obligatoire.

Identificateur d'application (APPID)

Indique le nom de l'application NDM sous laquelle le nom de phase, défini au paramètre PHASE, a été soumis. Il s'agit du nom identifiant NDM lors de sa génération sous MVS.

Ce paramètre est obligatoire.

Libérer phase éloignée (RMTLOCNAME)

Indique le nom du lieu éloigné avec lequel communique cette unité. Il doit correspondre au nom figurant au paramètre RMTLOCNAME de l'unité définie par le paramètre DEV.

Ce paramètre est obligatoire.

Description d'unité (DEV)

Indique le nom de l'unité IBM System i à utiliser pour la session de communication démarrée par cette commande. Cette unité doit être de type SNUF et doit admettre PSR (demande de démarrage de programme).

Ce paramètre est obligatoire.

Exemples

RLSRMTPHS   PHASE(MESSAGE)  PLAN(ALEXPLAN)  APPID(DSXNDM)
            RMTLOCNAME(A083187)  DEV(SNUFDEV)

Cette commande initialise une session à l'aide de l'unité SNUFDEV avec un nom d'emplacement éloigné A083187 pour se connecter à l'application du système hôte DSXNDM de System/370 NetView Distribution Manager. Une fois la connexion à la session établie, la phase MESSAGE, dans le plan ALEXPLAN, effectue une tentative de libération. Si la libération aboutit, le message CPC8889 (phase MESSAGE libérée par NetView Distribution Manager) est envoyé. Si la libération échoue, le message CPF8880 (phase MESSAGE non libérée par Netview Distribution Manager) est envoyé.

Messages d'erreur

Messages *ESCAPE

CPF8880: La phase &1 n'a pas été libérée par NetView Distribution Manager.