CHGMODD

Modifier description de mode

En bref

La commande CHGMODD permet de modifier une description de mode pour des unités APPC (Communications évoluées de programme à programme).

CHGMODD se lit CHG (Modifier) + MODD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGMODD MODD(…)

Paramètres

MODD Description de mode obligatoire
COS Classe de service
MAXSSN Nombre maximal de sessions
MAXCNV Nb maximal de conversations
LCLCTLSSN Sessions contrôlées en local
PREESTSSN Nombre sessions pré-établies
MAXINPAC Régulation réception maximale
INPACING Valeur régulation réception
OUTPACING Valeur régulation émission
MAXLENRU Longueur maximale de RU
DTACPR Compression des données
INDTACPR Niveau compression en entrée
OUTDTACPR Niveau compression en sortie
SLE Chiffrement niveau session
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGMODD 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 CHGMODD permet de modifier une description de mode pour des unités APPC (Communications évoluées de programme à programme). APPC utilise l'Architecture de réseau des systèmes IBM (SNA).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MODD	Description de mode	Nom	Obligatoire, clé, positionnel 1
COS	Classe de service	Nom de communication, *SAME, #CONNECT, #BATCH, #INTER, #BATCHSC, #INTERSC	Facultatif
MAXSSN	Nombre maximal de sessions	1-512, *SAME	Facultatif
MAXCNV	Nb maximal de conversations	1-512, *SAME	Facultatif
LCLCTLSSN	Sessions contrôlées en local	0-512, *SAME	Facultatif
PREESTSSN	Nombre sessions pré-établies	0-512, *SAME	Facultatif
MAXINPAC	Régulation réception maximale	1-32767, SAME, CALC	Facultatif
INPACING	Valeur régulation réception	0-63, *SAME	Facultatif
OUTPACING	Valeur régulation émission	0-63, *SAME	Facultatif
MAXLENRU	Longueur maximale de RU	241-32767, SAME, CALC	Facultatif
DTACPR	Compression des données	1-2147483647, SAME, NETATR, NONE, ALLOW, REQUEST, REQUIRE	Facultatif
INDTACPR	Niveau compression en entrée	SAME, RLE, LZ9, LZ10, LZ12, NONE	Facultatif
OUTDTACPR	Niveau compression en sortie	SAME, RLE, LZ9, LZ10, LZ12, NONE	Facultatif
SLE	Chiffrement niveau session	ALL, NONE, *SAME	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Description de mode (MODD)

Indique le nom de la description de mode.

Ce paramètre est obligatoire.

Classe de service (COS)

Indique les caractéristiques du contrôle d'acheminement dans le réseau (représentées par une description de classe de service) utilisées par la fonction APPN.

#CONNECT
#BATCH
#INTER
#BATCHSC
#INTERSC

nom-classe-de-service: Indiquez le nom de la classe de service.
Remarque :Ce nom sera ignoré si le mode est utilisé pour APPC.

*SAME: La valeur ne change pas.

Nombre maximal de sessions (MAXSSN)

Indique le nombre maximal de sessions actives établies pour ce mode. Ce nombre doit être supérieur ou égal à la somme du nombre de sessions contrôlées en local indiqué au paramètre Sessions contrôlées en local (LCLCTLSSN) et du nombre de sessions contrôlées en local indiqué dans le lieu éloigné.

nombre-maximal-de-sessions: Indiquez le nombre maximal de sessions.
Vous pouvez indiquer une valeur comprise entre 1 et 512.

*SAME: La valeur ne change pas.

Nb maximal de conversations (MAXCNV)

Indique le nombre maximal de conversations simultanées avec le système éloigné. Ce nombre est égal à la somme des conversations synchrones et asynchrones et doit être égal ou supérieur à celui indiqué au paramètre Nombre maximal de sessions (MAXSSN). Une conversation synchrone est un dialogue permanent entre le programme source et le programme cible. Une conversation asynchrone est une conversation qui permet au programme cible de recevoir les données émises par le système source, après que ce dernier ait interrompu la communication.

nombre-maximal-conversations: Indiquez le nombre maximal de conversations. Vous pouvez indiquer une valeur comprise entre 1 et 512.

*SAME: La valeur ne change pas.

Sessions contrôlées en local (LCLCTLSSN)

Indique le nombre minimal de sessions actives contrôlées en local qui doivent être établies pour ce mode. Cette valeur doit être inférieure ou égale à celle spécifiée dans le paramètre Nombre maximal de sessions (MAXSSN).

sessions-contrôlées-en-local: Le nombre de sessions contrôlées en local et utilisées comme sessions source doit être compris entre 0 et 512.

*SAME: La valeur ne change pas.

Nombre sessions pré-établies (PREESTSSN)

Indique le nombre maximal de sessions contrôlées en local et établies lors du lancement du mode. Des sessions supplémentaires peuvent être établies si nécessaire, leur nombre ne pouvant être supérieur au nombre maximal de sessions contrôlées en local indiqué en regard du paramètre Nombre maximal de sessions (MAXSSN). Cette valeur doit être inférieure ou égale à la valeur indiquée dans le paramètre Sessions contrôlées en local (LCLCTLSSN).

nombre-sessions-établies: Le nombre maximal de sessions simultanées contrôlées en local et établies lors du lancement du mode doit être compris entre 0 et 512.

*SAME: La valeur ne change pas.

Régulation réception maximale (MAXINPAC)

Indique la valeur de régulation maximale SNA utilisée pour contrôler le rythme de réception des unités de demande (RU). La régulation est établie par le système récepteur pour déterminer le débit de transmission du système émetteur et éviter ainsi la perte de données.

Remarque :Pour assurer un débit optimal, il est recommandé d'utiliser la valeur *CALC.

*SAME: La valeur ne change pas.

*CALC: Le système détermine la valeur à utiliser. Elle est égale à 2*INPACING, ce qui représente deux fois la valeur indiquée au paramètre INPACING.
régulation-réception-maximale: Indiquez un nombre d'unités de demande (RU) compris entre 1 et 32767 pour définir la valeur de régulation en réception maximale.

Valeur régulation réception (INPACING)

Indique la valeur de régulation de l'Architecture de réseau des systèmes IBM (SNA) qui permet de contrôler le rythme de réception des unités de demande (RU).

7: La valeur de régulation 7 est utilisée pour la RU.
valeur-régulation-réception: Indiquez une valeur limite comprise entre 0 et 63.

*SAME: La valeur ne change pas.

Valeur régulation émission (OUTPACING)

Indique la valeur SNA de régulation permettant de contrôler le rythme d'émission des unités de demande (RU).

7: La valeur de régulation 7 est utilisée pour la RU.
valeur-régulation-à-l'émission: Indiquez une valeur limite comprise entre 0 et 63.

*SAME: La valeur ne change pas.

Longueur maximale de RU (MAXLENRU)

Indique la longueur maximale de l'unité de demande (RU).

Remarque :Pour assurer une longueur maximale, il est recommandé d'utiliser la valeur *CALC.

*CALC: Le système calcule la valeur à utiliser.

longueur-maximale-de-RU

Indiquez une valeur comprise entre 241 et 32767 octets pour la longueur maximale des unités de demande (RU) entrantes.

Vous pouvez également préciser les valeurs suivantes :

Lignes SDLC : 256, 512, 1024, 2048
Lignes pour réseau en anneau à jeton : 256, 512, 1024, 1985
Lignes X.25 (QLLC) : 247, 503, 1015
Lignes X.25 (ELLC) : 241, 497, 1009

Pour plus de détails, consultez le manuel Communications Configuration, SC41-5401.

*SAME: La valeur ne change pas.

Compression des données (DTACPR)

Indique si la compression des données est utilisée.

*SAME: La valeur ne change pas.

*NETATR: La valeur de l'attribut de réseau DTACPR est utilisée.
*NONE: La compression des données n'est pas admise dans la session.
*ALLOW: La compression des données est admise dans la session par le système local si elle est demandée par un système éloigné. Le système local ne demande pas la compression.
Si la compression des données est demandée par le système éloigné, la session utilise les niveaux de compression les plus faibles des niveaux demandés et de ceux indiqués aux paramètres Niveau compression en entrée et Niveau compression en sortie (INDTACPR et OUTDTACPR).
*REQUEST: Le système local demande la compression des données. Cependant, la demande peut être rejetée ou bien un système éloigné peut demander des niveaux de compression inférieurs. La compression des données est admise si elle est demandée par le système éloigné. Les niveaux de compression demandés pour les données en entrée et en sortie sont indiqués aux paramètres Niveau compression en entrée et Niveau compression en sortie (INDTACPR et OUTDTACPR).
Si la compression des données est demandée par le système éloigné, la session utilise les niveaux de compression les plus faibles des niveaux demandés et de ceux indiqués aux paramètres Niveau compression en entrée et Niveau compression en sortie (INDTACPR et OUTDTACPR).
*REQUIRE: La compression des données est requise dans la session. Si le système éloigné n'accepte pas les niveaux de compression exacts demandés par le système local, la session n'est pas établie.
Les niveaux de compression requis par le système local sont indiqués aux paramètres Niveau compression en entrée et Niveau compression en sortie (INDTACPR et OUTDTACPR).
vitesse-ligne: Indiquez la vitesse maximale de ligne utilisée pour la compression des données. Si la liaison utilise une vitesse de ligne inférieure ou égale à celle indiquée, la compression des données est utilisée pour la session comme si la valeur *REQUEST avait été indiquée. Dans le cas contraire, la valeur *ALLOW est prise en compte. Les valeurs admises sont comprises entre 1 et 2147483647 bits/s.

Niveau compression en entrée (INDTACPR)

Indique le niveau de compression désiré pour les données en entrée. Aucune compression n'est effectuée si la valeur *NONE est indiquée pour le paramètre Compression des données (DTACPR).

Remarque :La compression dynamique avec dictionnaire fait appel à un algorithme de compression similaire à Lempel-Ziv, qui compresse les chaînes rencontrées précédemment en codes de 9, 10 et 12 bits. Cet algorithme est désigné par l'abréviation LZ dans les paramètres décrits ci-après.

*SAME: La valeur ne change pas.

*RLE: L'algorithme RLE (encodage de plage) est utilisé. RLE remplace par une séquence de 1 ou 2 octets dans le flot de données chaque récurrence d'un même caractère. Cet algorithme ne nécessite pas de mémoire et exige moins de temps de traitement que les autres options.

*LZ9: L'algorithme LZ utilisé remplace par des codes à 9 bits les sous-chaînes récurrentes dans le flot de données. Ces codes se rapportent aux postes d'un dictionnaire commun qui sont créés lors du transfert des données entre les systèmes émetteur et récepteur. Les algorithmes LZ nécessitent de la mémoire et un temps de traitement supplémentaire. L'algorithme LZ9 est le moins exigeant en matière de mémoire et de temps de traitement, mais il est aussi celui qui comprime le moins le flot de données.

*LZ10: L'algorithme LZ utilisé remplace par des codes à 10 bits les sous-chaînes récurrentes dans le flot de données. Ces codes se rapportent aux postes d'un dictionnaire commun qui sont créés lors du transfert des données entre les systèmes émetteur et récepteur. Les algorithmes LZ nécessitent de la mémoire et un temps de traitement supplémentaire. En matière d'exigence en mémoire et en temps de traitement, comme de compression du flot de données, l'algorithme LZ10 se situe à mi-chemin entre l'algorithme LZ9 et l'algorithme LZ12.

*LZ12: L'algorithme LZ utilisé remplace par des codes à 12 bits les sous-chaînes récurrentes dans le flot de données. Ces codes se rapportent aux postes d'un dictionnaire commun qui sont créés lors du transfert des données entre les systèmes émetteur et récepteur. Les algorithmes LZ nécessitent de la mémoire et un temps de traitement supplémentaire. L'algorithme LZ12 est le plus exigeant en matière de mémoire et de temps de traitement, mais il est aussi celui qui comprime le plus le flot de données.

*NONE: Aucune compression n'est effectuée.

Niveau compression en sortie (OUTDTACPR)

Indique le niveau de compression désiré pour les données en sortie. Aucune compression n'est effectuée si la valeur *NONE est indiquée pour le paramètre Compression des données (DTACPR).

*SAME: La valeur ne change pas.

*RLE: L'algorithme RLE (encodage de plage) est utilisé. RLE remplace par une séquence de 1 ou 2 octets dans le flot de données chaque récurrence d'un même caractère. Cet algorithme ne nécessite pas de mémoire et exige moins de temps de traitement que les autres options.

*LZ9: L'algorithme LZ utilisé remplace par des codes à 9 bits les sous-chaînes récurrentes dans le flot de données. Ces codes se rapportent aux postes d'un dictionnaire commun qui sont créés lors du transfert des données entre les systèmes émetteur et récepteur. Les algorithmes LZ nécessitent de la mémoire et un temps de traitement supplémentaire. L'algorithme LZ9 est le moins exigeant en matière de mémoire et de temps de traitement, mais il est aussi celui qui comprime le moins le flot de données.

*LZ10: L'algorithme LZ utilisé remplace par des codes à 10 bits les sous-chaînes récurrentes dans le flot de données. Ces codes se rapportent aux postes d'un dictionnaire commun qui sont créés lors du transfert des données entre les systèmes émetteur et récepteur. Les algorithmes LZ nécessitent de la mémoire et un temps de traitement supplémentaire. En matière d'exigence en mémoire et en temps de traitement, comme de compression du flot de données, l'algorithme LZ10 se situe à mi-chemin entre l'algorithme LZ9 et l'algorithme LZ12.

*LZ12: L'algorithme LZ utilisé remplace par des codes à 12 bits les sous-chaînes récurrentes dans le flot de données. Ces codes se rapportent aux postes d'un dictionnaire commun qui sont créés lors du transfert des données entre les systèmes émetteur et récepteur. Les algorithmes LZ nécessitent de la mémoire et un temps de traitement supplémentaire. L'algorithme LZ12 est le plus exigeant en matière de mémoire et de temps de traitement, mais il est aussi celui qui comprime le plus le flot de données.

*NONE: Aucune compression n'est effectuée.

Chiffrement niveau session (SLE)

Indique le niveau de chiffrement souhaité pour la session.

*SAME: La valeur ne change pas.

*NONE: Les données ne sont ni chiffrées ni déchiffrées.
*ALL: Toutes les données sont chiffrées avant d'être envoyées sur le réseau et déchiffrées à la réception.
Remarque :L'utilisation du chiffrement au niveau de la session requiert l'installation d'IBM Common Cryptographic Architecture Services for i5/OS et du dispositif Cryptographic Processor ou Cryptographic Processor-Commercial.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

*SAME: La valeur ne change pas.

Exemples

CHGMODD   MODD(MODE1)  PREESTSSN(3)

Cette commande permet de modifier le nombre de sessions pré-établies pour MODE1 en trois.

Messages d'erreur

Messages *ESCAPE

CPF262D: Description de mode &1 non modifiée.