STRMOD

Démarrer un mode

En bref

La commande STRMOD permet de démarrer un ou plusieurs modes en cours d'utilisation pour un lieu éloigné APPC (communications évoluées de programme à programme).

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

Syntaxe minimale

STRMOD RMTLOCNAME(…)

Paramètres

RMTLOCNAME Lieu éloigné obligatoire
DEV Unité
MODE Mode
LCLLOCNAME Lieu local
RMTNETID ID éloigné réseau

Astuce : dans une session 5250, tapez STRMOD 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 STRMOD permet de démarrer un ou plusieurs modes en cours d'utilisation pour un lieu éloigné APPC (communications évoluées de programme à programme). L'utilisateur peut utiliser la commande STRMOD à l'état de restauration ou de fin ; elle est requise uniquement après que la commande ENDMOD a mis fin à un mode. Pour plus de détails, consultez le manuel APPC Programming, SC41-5443.

Restriction : Afin d'utiliser cette commande, l'utilisateur doit disposer du droit d'utilisation pour l'unité APPC.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RMTLOCNAME	Lieu éloigné	Nom de communication	Obligatoire, positionnel 1
DEV	Unité	Nom, *LOC	Facultatif, positionnel 2
MODE	Mode	Nom de communication, NETATR, ALL	Facultatif
LCLLOCNAME	Lieu local	Nom de communication, LOC, NETATR	Facultatif
RMTNETID	ID éloigné réseau	Nom de communication, LOC, NETATR, *NONE	Facultatif

Lieu éloigné (RMTLOCNAME)

Indique le nom du lieu éloigné.

Ce paramètre est obligatoire.

Unité (DEV)

Indique le nom de la description d'unité.

Les valeurs possibles sont les suivantes :

*LOC: La description d'unité est déterminée par le système.
nom-unité: Indiquez le nom de la description d'unité.

Mode (MODE)

Indique le mode devant être démarré.

Les valeurs possibles sont les suivantes :

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

*ALL

Tous les modes en cours d'utilisation sur le lieu éloigné doivent être démarrés.

Si la description d'unité est créée automatiquement par la fonction APPN ou si vous avez répondu *YES au paramètre APPN, le paramètre *ALL indique que tous les modes utilisés lorsque le lieu éloigné était en fonction, mais qui restent encore hors fonction, doivent être démarrés.
Si, lors de la création manuelle de la description d'unité, vous avez répondu *NO au paramètre APPN, *ALL indique que tous les modes configurés pour le lieu éloigné désigné doivent être démarrés.

BLANK

Un nom de mode, composé de 8 caractères blanc, est utilisé.

nom-mode

Indiquez un mode.

Remarque :SNASVCMG et CPSVCMG sont des noms réservés. Vous ne pouvez pas vous en servir.

Lieu local (LCLLOCNAME)

Indique le nom du lieu local.

Les valeurs possibles sont les suivantes :

*LOC: Le nom du lieu local est déterminé par le système.

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

nom-lieu-local: Indiquez le nom de votre lieu. Cette information est nécessaire si vous voulez indiquer un nom de lieu local particulier pour le lieu éloigné.

ID éloigné réseau (RMTNETID)

Indique l'ID éloigné du réseau utilisé sur le lieu éloigné.

Les valeurs possibles sont les suivantes :

*LOC: Le système sélectionne l'ID éloigné du réseau.

*NETATR: L'ID éloigné du réseau figurant dans les attributs du réseau est utilisé.

*NONE: Aucun ID éloigné du réseau n'est utilisé.

ID-éloigné-réseau: Indiquez l'ID éloigné du réseau.

Exemples

STRMOD   RMTLOCNAME(APPCRLOC)  DEV(APPCDEV)  MODE(APPCMODE)
         RMTNETID(CHICAGO)

Cette commande démarre un mode nommé APPCMODE pour un lieu éloigné nommé APPCRLOC, une unité nommée APPCDEV et l'ID de réseau distant CHICAGO.

Messages d'erreur

Messages *ESCAPE

CPF598B: Commande &1 non exécutée pour un ou plusieurs modes.