CRTDTAQ

La commande CRTDTAQ (Créer une file d'attente de données) permet de créer une file d'attente de données dans la bibliothèque indiquée.

Les files d'attente de données, qui constituent un type d'objet système i5/OS, permettent de communiquer et stocker des données utilisées par plusieurs programmes au sein d'un travail ou pour plusieurs travaux. Plusieurs travaux peuvent envoyer ou recevoir des données en utilisant une seule file d'attente de données.

Pour plus d'informations sur les files d'attente de données associées aux files d'attente en sortie, consultez le manuel Catégorie Impression de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

La commande CRTDTAQ peut créer une file d'attente de données DDM (gestion de fichiers éloignés) lorsque TYPE(*DDM) est indiqué. Cette file d'attente de données DDM permet aux programmes d'accéder aux files d'attente de données situées sur un système éloigné (cible) au sein du réseau DDM. Les programmes du système local (source) font référence à toute file d'attente de données éloignée en utilisant, à la place du nom de cette dernière, le nom de la file d'attente DDM. Cependant, ces deux noms peuvent être identiques.

La file d'attente de données DDM du système source contient le nom de la file d'attente de données éloignée et le nom du système éloigné (cible) où elle figure.

Restrictions : Les utilisateurs de cette commande doivent disposer des droits d'ajout sur la bibliothèque où se trouve la file d'attente de données.

Paramètres

File d'attente de données (DTAQ)

Indique la file d'attente de données à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : File d'attente de données

nom

Entrez le nom de la file d'attente de données.

Qualificatif 2 : Biblio

*CURLIB

La file d'attente de données est recherchée dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Entrez le nom de la bibliothèque contenant la file d'attente de données.

Type (TYPE)

Indique le type de la file d'attente de données à créer. Il peut s'agir d'une file d'attente de données standard ou DDM (gestion de fichiers éloignés), ou d'une file d'attente de données d'affichage.

*STD

Une file d'attente de données standard est créée. Le paramètre MAXLEN est nécessaire pour pouvoir utiliser cette valeur.

*DDM

Une file d'attente de données DDM est créée. Cette valeur nécessite le nom de la file d'attente de données éloignée utilisée (paramètre RMTDTAQ) et celui du système éloigné (cible) où elle figure (paramètre RMTLOCNAME).

*DSP

Une file d'attente de données d'affichage est créée. La file d'attente de données sera utilisée avec un fichier écran. Un travail interactif en attente de cette file d'attente de données sera admissible pour le délai d'inactivité d'un travail. Le paramètre MAXLEN est nécessaire pour pouvoir utiliser cette valeur.

Longueur maximale de poste (MAXLEN)

Indique la longueur maximale d'un poste de données envoyé en file d'attente.

Remarques :

1. Si la file d'attente de données est associée à une file d'attente en sortie, la valeur de la longueur maximale doit être au moins 128.
2. Ce paramètre est admis uniquement lorsque TYPE(*STD) est indiqué.

1-64512

Entrez la longueur maximale de la réponse. Les valeurs admises sont comprises entre 1 et 64512.

Stockage forcé mém secondaire (FORCE)

Indique si la file d'attente de données doit être forcée en mémoire secondaire après chaque envoi ou réception de données.

Remarque :Ce paramètre est admis uniquement lorsque TYPE(*STD) est indiqué.

*NO

La file d'attente n'est pas immédiatement forcée en mémoire secondaire en cas d'envoi ou de réception de données.

*YES

La file d'attente est immédiatement forcée en mémoire secondaire après chaque envoi ou réception de données. Ceci garantit que les modifications ne sont pas perdues en cas d'arrêt anormal du système. Ceci nécessite du temps système supplémentaire.

Séquence (SEQ)

Indique l'ordre dans lequel sont reçus les postes de la file d'attente.

Remarques :

1. Si la file d'attente de données est associée à une file d'attente en sortie, la valeur de la séquence doit être *FIFO ou *LIFO.
2. Ce paramètre est admis uniquement lorsque TYPE(*STD) est indiqué.

*FIFO

Les postes de la file d'attente de données sont reçus dans l'ordre "premier entré, premier sorti".

*LIFO

Les postes de la file d'attente de données sont reçus dans l'ordre "dernier entré, premier sorti".

*KEYED

Les postes de la file d'attente de données sont reçus par clé, préfixe ajouté au poste par l'émetteur.

Longueur de clé (KEYLEN)

Indique le nombre de caractères de la clé.

Remarque :Ce paramètre est admis uniquement lorsque SEQ(*KEYED) et TYPE(*STD) sont indiqués.

1-256

Indiquez la longueur de la clé. Les valeurs admises sont comprises entre 1 et 256.

Inclure ID émetteur (SENDERID)

Indique s'il faut associer l'ID émetteur à chaque message envoyé dans la file d'attente de données. L'ID contient le nom de travail qualifié, ainsi que le profil utilisateur en cours de l'émetteur.

Remarque :Ce paramètre est admis uniquement lorsque TYPE(*STD) est indiqué.

*NO

Les messages envoyés ne comportent pas l'ID émetteur.

*YES

Les messages envoyés comportent l'ID émetteur.

Taille de la file d'attente (SIZE)

Quantité de mémoire allouée à la file d'attente de données. Les paramètres sont le nombre maximal de postes et le nombre initial de postes de la file d'attente de données.

Remarque :Ce paramètre est admis uniquement lorsque TYPE(*STD) est indiqué.

Elément 1 : Nombre maximal de postes

Les valeurs suivantes permettent d'indiquer le nombre maximal de postes pouvant être ajoutés à la file d'attente de données.

*MAX16MB

Le système calcule le nombre maximal de postes pouvant être ajoutés à la file d'attente et dont la taille pourra passer à 16 mégaoctets environ. Un mégaoctet est égal à 1 048 576 octets. Cette valeur, disposant à l'origine de 16 postes, offre une compatibilité avec les éditions du système d'exploitation antérieures à la V4R5M0.

*MAX2GB

Le système calcule le nombre maximal de postes pouvant être ajoutés à la file d'attente de données. Celle-ci pourra croître jusqu'à atteindre la taille maximale approximative de 2 gigaoctets (Go). Un gigaoctet est égal à 1 073 741 824 octets.

nombre-postes

La file d'attente de données pourra contenir au moins le nombre de postes spécifié ici. En fonction de la taille d'extension utilisée par la machine, le nombre maximal de postes de cette file peut être légèrement supérieur à la valeur indiquée. Celle-ci doit être supérieure à 0.

Elément 2 : Nombre initial de postes

Quantité de mémoire initialement allouée à la file d'attente de données. A sa création, celle-ci pourra contenir le nombre initial de postes de longueur maximale.

16

Initialement, la mémoire allouée permet à la file d'attente de données de contenir 16 postes de longueur maximale.

nombre-initial-postes

Indiquez la valeur représentant le nombre de postes que peut initialement contenir la file d'attente de données. Cette valeur doit être supérieure à 0.

Récupération automatique (AUTORCL)

Indique si la mémoire allouée pour la file d'attente de données est automatiquement récupérée (libérée) lorsque celle-ci est vide.

Remarque :Ce paramètre est admis uniquement lorsque TYPE(*STD) est indiqué.

*NO

La mémoire allouée à la file d'attente de données n'est pas récupérée lorsque celle-ci est vide.

*YES

La mémoire allouée pour la file d'attente est récupérée lorsque celle-ci est vide. Cependant, la mémoire allouée pour le nombre initial de postes le reste.

File de données éloignée (RMTDTAQ)

Indique le nom de la file d'attente de données éloignée sur le système cible. Il n'est pas nécessaire que celle-ci existe lorsque la file d'attente de données DDM est créée.

Qualificatif 1 : File de données éloignée

nom

Indiquez le nom de la file d'attente de données éloignée à laquelle l'accès est effectuée (10 caractères maximum).

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

• Si *LIBL (bibliothèque par défaut) est indiqué ou pris par défaut, la file d'attente de données est recherchée dans la liste des bibliothèques du travail appelé sur le système cible.
• Si *CURLIB est indiqué, la file d'attente de données est recherchée dans la bibliothèque en cours du travail appelé sur le système cible.

Lieu éloigné (RMTLOCNAME)

Indique le nom du lieu éloigné utilisé avec cet objet.

Remarque :Plusieurs files d'attente de données DDM peuvent utiliser le même lieu éloigné comme système cible. Ce lieu éloigné doit être un iSeries doté d'une édition de l'i5/OS qui prend en charge les files d'attente de données éloignées.

*RDB

Les informations relatives à l'emplacement distant et provenant de l'entrée de base de données relationnelle indiquée au paramètre Base de données relationnelle (RDB) permettent de déterminer le système distant.

nom

Indiquez le nom du lieu éloigné associé au système cible. Ce lieu éloigné, qui sert à accéder au système cible, n'a pas besoin d'exister lors de la création de la file d'attente de données DDM, mais il doit exister lors de l'accès à cette dernière.

Pour plus d'informations sur les lieux éloignés, reportez-vous au manuel APPC Programming, SC41-5443.

Base de données relationnelle (RDB)

Indique quelle entrée de base de données relationnelle permet de déterminer les informations d'emplacement distant de la file d'attente de données DDM.

nom-de-communications

Tapez le nom de l'entrée de base de données relationnelle identifiant le système cible ou le groupe ASP cible. Le nom de la base de données relationnelle peut faire référence à un système distant ou à un groupe ASP distant qui est configuré et stocké sur un système distant. L'entrée de base de données relationnelle n'a pas besoin d'exister lors de la création de la file d'attente de données DDM, mais il doit exister lors de l'accès à cette dernière. Ce paramètre est nécessaire lorsque *RDB est indiqué au paramètre Lieu éloigné (RMTLOCNAME).

Description d'unité APPC (DEV)

Indique le nom de la description d'unité APPC du système source utilisée avec la file d'attente de données DDM. Il n'est pas nécessaire que cette description d'unité existe lorsque la file d'attente de données DDM est créée.

*LOC

L'unité associée au lieu éloigné est utilisée. Si plusieurs unités sont associées au lieu éloigné, c'est le système qui détermine l'unité utilisée.

nom

Indiquez le nom d'une unité de communication associée au lieu éloigné. Si le nom d'unité est incorrect pour le lieu éloigné, un message est envoyé lorsque le poste d'unité programme est requis. Pour plus d'informations sur les noms d'unité, consultez le manuel APPC Programming, SC41-5443.

Lieu local (LCLLOCNAME)

Indique le nom du lieu local.

*LOC

L'unité associée au lieu éloigné est utilisée. Si plusieurs unités sont associées au lieu éloigné, c'est le système qui détermine l'unité utilisée.

*NETATR

La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.

nom

Indiquez le nom du lieu local associé au lieu éloigné. Vous devez indiquer ce nom uniquement si vous associez un lieu local spécifique au lieu éloigné. S'il est incorrect pour le lieu éloigné, un message d'arrêt programme est envoyé lors de l'accès à la file d'attente de données DDM.

Pour plus d'informations sur les noms de lieu local, reportez-vous au manuel APPC Programming, SC41-5443.

Mode (MODE)

Indique le nom de mode utilisé avec le nom du lieu éloigné pour communiquer avec le système cible.

*NETATR

Le nom de mode utilisé est celui qui est indiqué dans les attributs de réseau.

nom

Indiquez le nom du mode utilisé pour communiquer avec le système éloigné. S'il est incorrect pour une combinaison de lieux local et éloigné, un message d'arrêt programme est envoyé lors de l'accès à la file d'attente de données DDM.

Pour plus d'informations sur les noms de mode, reportez-vous au manuel APPC Programming, SC41-5443.

ID éloigné réseau (RMTNETID)

Indique l'ID éloigné du réseau sur lequel réside le lieu éloigné, utilisé pour communiquer avec le système cible.

*LOC

L'ID éloigné de réseau associé au lieu éloigné est utilisé. Si plusieurs ID éloignés de réseau sont associés au lieu éloigné, le système détermine lequel d'entre eux est utilisé.

*NETATR

La valeur RMTNETID indiquée dans les attributs de réseau du système est utilisée.

*NONE

Aucun ID éloigné de réseau n'est utilisé.

ID-éloigné-réseau

Indiquez l'ID éloigné de réseau associé au lieu éloigné. Vous devez indiquer cet ID uniquement si vous associez un ID éloigné de réseau spécifique au lieu éloigné. S'il est incorrect pour le lieu éloigné, un message d'arrêt programme est envoyé lors de l'accès à la file d'attente de données DDM.

Pour plus d'informations sur les ID éloignés de réseau, reportez-vous au manuel APPC Programming, SC41-5443.

Texte 'descriptif' (TEXT)

Indique le texte décrivant brièvement la file d'attente de données.

*BLANK

Aucun texte n'est indiqué.

'descriptif'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

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.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifié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.

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

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

Exemple 1 : Création d'une file d'attente de données standard

CRTDTAQ   DTAQ(DEPTADTA)  MAXLEN(100)  AUT(*EXCLUDE)
          TEXT('Données spéciales + fichiers pour DEPTA')

Cette commande crée une file d'attente de données appelée DEPTADTA et la stocke dans la bibliothèque en cours ; le poste le plus long est égal à 100. Etant donné que AUT(*EXCLUDE) est précisé, la file d'attente de données ne peut être utilisée et contrôlée que par l'utilisateur qui a créé la file d'attente et par des utilisateurs qui disposent de droits spécifiques. Les utilisateurs du service A peuvent se voir octroyer le droit d'utiliser cette file d'attente de données à l'aide de la commande GTROBJAUT (Accorder droits sur un objet).

Exemple 2 : Création d'une file d'attente de données DDM pour accéder à une file d'attente de données résidant sur un autre système

CRTDTAQ   DTAQ(SOURCE/SALES)  TYPE(*DDM)
          RMTDTAQ(REMOTE/SALES)  RMTLOCNAME(NEWYORK)

Cette commande crée une file d'attente de données DDM appelée SALES et la stocke dans la bibliothèque SOURCE qui réside sur le système source. Cette file d'attente de données DDM utilise le lieu éloigné NEWYORK pour accéder à une file d'attente de données éloignée appelée SALES stockée dans la bibliothèque REMOTE qui réside sur un système installé à New York.

Exemple 3 : Création d'une file d'attente de données en indiquant des attributs de taille et récupération automatique

CRTDTAQ   DTAQ(MYLIB/MYDTAQ) MAXLEN(80)
          SIZE(*MAX2GB 100)  AUTORCL(*YES)

Cette commande crée une file d'attente de données appelée MYDTAQ et la stocke dans la bibliothèque MYLIB. La longueur maximum d'un poste est de 80 octets et les postes de la file d'attente sont reçus selon le mode FIFO (premier entré - premier sorti). Au départ, la mémoire allouée à la file d'attente de données lui permet de contenir 100 postes. Celle-ci pourra croître jusqu'à atteindre la taille maximale approximative de 2 gigaoctets (Go). Si tous les postes de la file d'attente sont reçus, la mémoire de la file d'attente de données sera récupérée automatiquement.

Messages d'erreur

Messages *ESCAPE

CPF2105

Objet &1 de &2 type *&3 non trouvé.

CPF2108

Objet &1, type *&3, non ajouté à la bibliothèque &2.

CPF2109

NEWOBJ doit être *SAME lorsque le paramètre OBJ est *ALL ou un nom générique.

CPF2110

Bibliothèque &1 non trouvée.

CPF2113

Impossible d'allouer la bibliothèque &1.

CPF2116

DATA(*YES) indiqué, mais *ALL ou *FILE absent de la liste OBJTYPE.

CPF2122

Limite mémoire dépassée pour le profil utilisateur &1.

CPF2123

Aucun objet du nom ou du type indiqué dans la bibliothèque &2.

CPF2130

&1 objet(s) dupliqué(s). &2 objet(s) non dupliqué(s).

CPF2151

Erreur de l'opération sur &2 de &1 type *&3.

CPF2152

Les objets de type *&1 ne peuvent pas être créés dans QTEMP.

CPF2162

Duplication non admise pour tous les objets de la bibliothèque &1.

CPF2176

Bibliothèque &1 endommagée.

CPF2182

Non autorisé à utiliser la bibliothèque &1.

CPF2185

Paramètre TOLIB, TOASPDEV ou NEWOBJ incorrect.

CPF2186

L'objet &1 ne peut pas être créé dans la bibliothèque &2.

CPF2283

La liste d'autorisation &1 n'existe pas.

CPF6565

User profile storage limit exceeded.

CPF9517

Le paramètre SIZE est incorrect.

CPF9518

Le nombre maximal de postes est trop élevé.

CPF980D

Echec de l'opération protégée par disque miroir pour &1 dans &2 type *&3.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9827

L'objet &1 ne peut pas être créé ou déplacé dans la bibliothèque &2.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9870

L'objet &2 de type *&5 existe déjà dans la bibliothèque &3.