HLDCMNDEV

Suspendre unité communications

En bref

La commande HLDCMNDEV (Suspendre une unité de communications) permet à l'opérateur de suspendre les communications à partir de l'unité indiquée.

HLDCMNDEV se lit HLD (Suspendre) + CMNDEV. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

HLDCMNDEV DEV(…)

Paramètres

DEV Unité obligatoire
OPTION Option

Astuce : dans une session 5250, tapez HLDCMNDEV 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 HLDCMNDEV (Suspendre une unité de communications) permet à l'opérateur de suspendre les communications à partir de l'unité indiquée. Les communications seront rétablies au moyen de la commande RLSCMNDEV (Libérer une unité de communications) ou de la commande VRYCFG (Changer l'état d'une configuration), qui permet de mettre l'unité hors fonction puis de nouveau en fonction.

Restriction : Cette commande est fournie avec le droit public *EXCLUDE et les profils utilisateurs QPGMR, QSYSOPR, QSRV et QSRVBAS disposent des droits privés permettant de l'utiliser.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité	Nom	Obligatoire, positionnel 1
OPTION	Option	CNTRLD, IMMED	Facultatif, positionnel 2

Unité (DEV)

Indique le nom de l'unité sur laquelle les communications doivent être suspendues. Les unités sur lesquelles les communications sont suspendues sont les suivantes :

Valeur DEV: Unité
3180: Clavier-écran
3277: Clavier-écran
3278: Clavier-écran
3279: Clavier-écran
3287: Imprimante (poste de travail)
5219: Imprimante (poste de travail)
5224: Imprimante (poste de travail)
5225: Imprimante (poste de travail)
5251: Clavier-écran
5252: Clavier-écran
5256: Imprimante (poste de travail)
5291: Clavier-écran
5292: Clavier-écran
PLU1: Unité logique principale, type 1 (pour SNA)
BSC: Unité synchrone binaire (Base et RJE)
BSCT: Ce système &sys. est un poste tributaire multipoint BSC
APPC: Unité logique d'un réseau APPC (communications évoluées de programme à programme)

Ce paramètre est obligatoire.

Option (OPTION)

Indique comment les communications avec cette unité seront suspendues.

Les valeurs possibles sont les suivantes :

*CNTRLD: L'unité indiquée ne pourra ni établir ni recevoir de communications lors des prochaines opérations OPEN et ACQUIRE. L'option *CNTRLD permet à tout programme utilisant cette unité de communications de continuer à effectuer des opérations d'E/S, mais aucune autre opération sur cette unité ne pourra être démarrée.
*IMMED: L'unité indiquée ne pourra ni établir ni recevoir de communications lors des prochaines opérations READ, WRITE, OPEN et ACQUIRE. L'option *IMMED entraîne l'arrêt immédiat de l'unité de communications et le programme reçoit un message d'erreur grave en E/S.

Exemples

HLDCMNDEV   DEV(WSPR05)

Cette commande met en attente la capacité de communication de l'unité WSPR05 au moment de l'opération OPEN ou ACQUIRE suivante.

Messages d'erreur

Messages *ESCAPE

CPF5920: Unité &1 hors fonction ou en mode diagnostic.
CPF5921: &1 n'est pas une unité de communications.
CPF5922: Unité &1 déjà suspendue avec l'option *IMMED.
CPF5935: Erreur pendant le traitement de la commande.
CPF5984: Non autorisé à effectuer cette opération.
CPF9814: Unité &1 non trouvée.
CPF9825: Accès non autorisé à l'unité &1.