CHGSSNMAX

La commande CHGSSNMAX (Modifier le maximum de sessions) permet de modifier de façon dynamique le nombre maximum de sessions attribué à un mode en local.

Lorsque le nombre maximal de sessions est modifié, le système éloigné en est informé et peut négocier un nombre moins élevé de sessions. Toutefois, le système éloigné ne peut négocier un nombre supérieur à celui défini pour le lieu local. La valeur maximum de la session résultante est le maximum de la session courante. Le système, local ou éloigné, ne pourra ouvrir plus de sessions qu'il n'en est indiqué dans cette invite.

Si le système éloigné accepte ou négocie le nombre maximum de sessions, la valeur proposée dans cette commande est enregistrée comme nombre maximal de sessions en local. Le système éloigné n'est pas autorisé à fixer un nombre maximal de sessions en cours supérieur à celui spécifié en local. Le nombre de sessions en local ne sera utilisé que pour une nouvelle négociation. Le nombre maximum de sessions, actuellement défini, permet de contrôler le nombre de sessions pouvant être actives entre le lieu local et le lieu éloigné, et reste inchangé si la commande échoue. En effet, si le lieu éloigné refuse de modifier le nombre maximum de sessions, la commande se termine de façon anormale, et le nombre maximum de sessions locales est modifié de la façon suivante : si vous augmentez ce nombre, la valeur demandée sera acceptée ; si vous la diminuez, la valeur ne sera pas modifiée.

Cette commande est habituellement utilisée par l'opérateur système. Elle lui permet de contrôler le nombre de sessions pouvant être simultanément actives sur le lieu éloigné. Tant que le nombre de sessions actives est supérieur à la valeur indiquée dans la commande, aucune session nouvelle ne pourra être créée. S'il est inférieur à cette valeur, l'ouverture d'une nouvelle session est subordonnée au démarrage d'un travail. La valeur que le système aura générée sera réactualisée lors d'une nouvelle exécution de la commande CHGSSNMAX, ou à l'exécution d'une commande ENDMOD (Arrêter un mode), ou encore lorsque toutes les descriptions d'unités rattachées au lieu éloigné seront mises hors fonction.

REMARQUES :

1. Lorsque cette commande permet de réduire le nombre de sessions sur un système éloigné, les sessions qui sont arrêtées en premier sont celles qui sont contrôlées en local, suivies des autres sessions disponibles. Si le nouveau nombre de session n'est toujours pas atteint, d'autres sessions sont arrêtées dans la mesure où les travaux les utilisant sont terminés ou annulés.
2. Lorsque la commande CHGSSNMAX permet d'augmenter le nombre maximal de sessions pouvant être créé sur un système éloigné, les sessions contrôlées en local sont disponibles (en fonction des valeurs négociées) avant les autres sessions.
3. La commande CHGSSNMAX ne modifie pas la valeur indiquée pour le paramètre MAXSSN dans la description de mode ; la commande CHGMODD (Modifier description de mode) doit être utilisée pour modifier en permanence la valeur. Lorsque l'unité est ensuite mise en fonction, la valeur MAXSSN de la description de mode permet de limiter le nombre de sessions au lieu de la valeur MAXSSN indiquée dans une commande CHGSSNMAX précédente.

Pour plus de détails sur cette commande, consultez le manuel APPC Programming, SC41-5443

Paramètres

Lieu éloigné (RMTLOCNAME)

Indique le nom du lieu éloigné.

Ce paramètre est obligatoire.

Nombre maximal de sessions (MAXSSN)

Indique le nombre de sessions permises avec le système éloigné. Cette valeur représente le nombre maximal de sessions que vous désirez associer à ce mode. Il doit être inférieur ou égal au nombre de sessions indiqué dans la description du mode. Le lieu éloigné pouvant négocier une valeur inférieure, la valeur spécifiée en regard de cette invite n'est pas nécessairement celle qui sera utilisée.

Les valeurs admises pour ce paramètre doivent être comprises entre 1 et 512.

Unité (DEV)

Indique le nom de la description d'unité utilisée sur le lieu éloigné.

Les valeurs possibles sont les suivantes :

*LOC

Il s'agit de l'unité associée au lieu éloigné. Si plusieurs unités peuvent être rattachées à ce lieu, le système détermine l'unité à utiliser.

nom-unité

Indiquez le nom de la description d'unité associée au lieu éloigné.

Mode (MODE)

Indique le nom du mode devant être modifié.

Les valeurs possibles sont les suivantes :

*NETATR

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

BLANK

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

nom-mode

Indiquez une valeur (8 caractères maximum) permettant d'identifier le mode à modifier.

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 du lieu local associé au lieu éloigné.

ID éloigné réseau (RMTNETID)

Indique l'ID éloigné du réseau qui est utilisé avec 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 un ID éloigné du réseau.

Exemples

CHGSSNMAX   RMTLOCNAME(APPCRLOC)  DEV(APPCDEV)  MODE(APPC2)  MAXSSN(3)

Cette commande fait passer à trois le nombre maximum de sessions autorisées par le lieu éloigné APPCRLOC pour le mode APPC2.

Messages d'erreur

Messages *ESCAPE

CPF598B

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