Aller au contenu

CRTMODD

Créer une description de mode

En bref

la commande CRTMODD permet de créer une description de mode pour les unités APPC (Communications évoluées de programme à programme).

CRTMODD se lit CRT (Créer) + MODD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTMODD MODD(…)

Paramètres

  • MODD Description de mode obligatoire
  • 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'
  • COS Classe de service
  • AUT Droits

Astuce : dans une session 5250, tapez CRTMODD 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 CRTMODD permet de créer une description de mode pour les unités APPC (Communications évoluées de programme à programme). Une description de mode définit les caractéristiques de la session et le nombre de sessions pour un lien entre les lieux local et éloigné. Pour plus de détails sur les modes, consultez les manuels APPC Programming, SC41-5443 et APPN de la catégorie Networking de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

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 de communication Obligatoire, positionnel 1
MAXSSN Nombre maximal de sessions 1-512, 8 Facultatif
MAXCNV Nb maximal de conversations 1-512, 8 Facultatif
LCLCTLSSN Sessions contrôlées en local 0-512, 4 Facultatif
PREESTSSN Nombre sessions pré-établies 0-512, 0 Facultatif
MAXINPAC Régulation réception maximale 1-32767, *CALC Facultatif
INPACING Valeur régulation réception 0-63, 7 Facultatif
OUTPACING Valeur régulation émission 0-63, 7 Facultatif
MAXLENRU Longueur maximale de RU 241-32767, *CALC Facultatif
DTACPR Compression des données 1-2147483647, *NETATR, *NONE, *ALLOW, *REQUEST, *REQUIRE Facultatif
INDTACPR Niveau compression en entrée *RLE, *LZ9, *LZ10, *LZ12, *NONE Facultatif
OUTDTACPR Niveau compression en sortie *RLE, *LZ9, *LZ10, *LZ12, *NONE Facultatif
SLE Chiffrement niveau session *NONE, *ALL Facultatif
TEXT Texte 'descriptif' Valeur caractère, *BLANK Facultatif
COS Classe de service Nom de communication, #CONNECT, #BATCH, #INTER, #BATCHSC, #INTERSC Facultatif
AUT Droits Nom, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT Facultatif

Description de mode (MODD)

Indique le nom de la description de mode.

Ce paramètre est obligatoire.

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.

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.

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.

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.

Régulation réception maximale (MAXINPAC)

Indique la valeur de régulation SNA maximale 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.

*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.

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.

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.

Compression des données (DTACPR)

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

*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.

*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).

*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.

*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.

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.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*CHANGE
L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.
*ALL
L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.
*USE
L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).
*EXCLUDE
L'utilisateur n'a pas accès à l'objet.
*LIBCRTAUT
Le système détermine les droits sur l'objet à l'aide de la valeur précisée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.
nom
Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTMODD   MODD(MODE1)  COS(COSD1)
          TEXT('Mode utilisant la classe de service COSD1')

Cette commande permet de créer un mode, MODE1, qui définit la description de classe de service COSD1.

Messages d'erreur

Messages *ESCAPE

CPF261B
Description de mode &1 non créée à la suite d'erreurs.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.