ENDCMNSVR

Arrêter serveur communications

En bref

La commande ENDCMNSVR (Arrêter serveur communications) permet d'interrompre le serveur passe-système cible ou le serveur d'utilitaires passe-système.

ENDCMNSVR se lit END (Arrêter) + CMNSVR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDCMNSVR

Paramètres

SERVER Type de serveur
OPTION Type d'arrêt
DELAY Délai d'arrêt contrôlé

Astuce : dans une session 5250, tapez ENDCMNSVR 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 ENDCMNSVR (Arrêter serveur communications) permet d'interrompre le serveur passe-système cible ou le serveur d'utilitaires passe-système. Le serveur passe-système cible traite le passe-système, la fonction WSF de System i5 Access et d'autres programmes d'émulation 5250 sur des postes de travail programmables. Le serveur d'utilitaires passe-système peut réduire le temps nécessaire à l'établissement d'une session.

Restriction : Pour pouvoir utiliser cette commande, vous devez disposer du droit spécial d'exploitation des travaux (*JOBCTL).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SERVER	Type de serveur	PASTHR, UTILSVR	Facultatif, positionnel 1
OPTION	Type d'arrêt	CNTRLD, IMMED	Facultatif, positionnel 2
DELAY	Délai d'arrêt contrôlé	1-86400, *NOMAX	Facultatif

Type de serveur (SERVER)

Indique le type de serveur à arrêter.

*PASTHR: Le serveur passe-système cible, s'il est actif, est arrêté.
*UTILSVR: Le serveur d'utilitaires passe-système, s'il est actif, est arrêté.

Type d'arrêt (OPTION)

Indique si le serveur passe-système cible ou le serveur d'utilitaires passe-système est arrêté de manière immédiate ou contrôlée.

*CNTRLD: Le serveur est arrêté de manière contrôlée. Les sessions actives peuvent achever les opérations en cours. L'ouverture de nouvelles sessions n'est pas possible. Après le laps de temps spécifié, le traitement de ENDCMNSVR OPTION(*IMMED) s'effectue.
*IMMED: Le serveur est arrêté de manière immédiate. Toutes les sessions actives démarrées via le serveur passe-système cible sont arrêtées immédiatement.

Délai d'arrêt contrôlé (DELAY)

Indique le délai (en secondes) admis pour achever l'arrêt contrôlé du serveur passe-système cible. Ce laps de temps écoulé, tous les travaux de ce serveur sont immédiatement arrêtés.

*NOMAX: Il n'y a pas de délai d'attente maximum. Les serveurs ne seront arrêtés que lorsque toutes les sessions actives se seront achevées normalement.
délai-attente: Indiquez le nombre de secondes nécessaires à l'opération d'arrêt. Les valeurs admises sont comprises entre 1 et 86400.

Exemples

Exemple 1 : arrêt du serveur de passe-système cible

ENDCMNSVR

Cette commande permet d'arrêter le serveur de passe-système cible de manière contrôlée. Aucune des sessions actives utilisant le serveur passe-système cible n'est affectée. Ce serveur n'admet pas de nouvelle session. Le serveur de passe-système cible s'arrête une fois toutes les sessions actives interrompues.

Exemple 2: Arrêt du serveur d'utilitaires passe-système

ENDCMNSVR SERVER(*UTILSVR)

Cette commande permet d'arrêter le serveur d'utilitaires passe-système de manière contrôlée. Aucune des sessions actives utilisant le serveur d'utilitaires passe-système n'est affectée. Il est possible que le temps nécessaire à l'établissement de nouvelles sessions soit augmenté.

Messages d'erreur

Messages *ESCAPE

CPF8947: Erreur inattendue à l'arrêt des serveurs de passe-système cible.