CRTQMQRY

Créer une requête QM

En bref

La commande CRTQMQRY permet de créer une requête QM à partir d'un membre de fichier source donné.

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

Syntaxe minimale

CRTQMQRY QMQRY(…)

Paramètres

QMQRY Requête QM obligatoire
SRCFILE Fichier source
SRCMBR Membre source
TEXT Texte 'descriptif'
SRTSEQ Séquence de tri
LANGID Identificateur de langue
AUT Droits
REPLACE Remplacer objet

Astuce : dans une session 5250, tapez CRTQMQRY 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 CRTQMQRY permet de créer une requête QM à partir d'un membre de fichier source donné. Le source d'une requête est une instruction SQL unique pouvant contenir des valeurs de substitution variables et des commentaires. Cette instruction peut représenter plusieurs enregistrements d'un membre de fichier source.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
QMQRY	Requête QM	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Requête QM	Nom
	Qualificatif 2: Biblio	Nom, *CURLIB
SRCFILE	Fichier source	Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1: Fichier source	Nom, QQMQRYSRC
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCMBR	Membre source	Nom, *QMQRY	Facultatif, positionnel 3
TEXT	Texte 'descriptif'	Valeur caractère, SRCMBRTXT, BLANK	Facultatif
SRTSEQ	Séquence de tri	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Séquence de tri	Nom, SRC, JOBRUN, JOB, HEX, LANGIDSHR, LANGIDUNQ
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
LANGID	Identificateur de langue	Valeur caractère, SRC, JOBRUN, *JOB	Facultatif
AUT	Droits	Nom, USE, CHANGE, ALL, EXCLUDE, *LIBCRTAUT	Facultatif
REPLACE	Remplacer objet	YES, NO	Facultatif

Requête QM (QMQRY)

Indique la requête QM à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Requête QM

nom: Indiquez le nom de la requête à créer.

Qualificatif 2 : Biblio

*CURLIB: La requête est créée dans la bibliothèque en cours pour le travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque contenant la requête.

Fichier source (SRCFILE)

Indique le fichier source contenant la source de la requête créée. Cette dernière est identifiée par le nom indiqué au paramètre QMQRY.

Qualificatif 1 : Fichier source

QQMQRYSRC: Le fichier source IBM QQMQRYSRC contient la source de la requête à créer.
nom: Indiquez le nom du fichier contenant le source de la requête à créer.

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: Le système effectue la recherche dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Membre source (SRCMBR)

Indique le membre de fichier source contenant la source de la requête à créer.

*QMQRY: Le nom du membre est identique au nom de requête indiqué au paramètre QMQRY.
nom: Indiquez le nom du membre contenant le source de la requête.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement la requête QM.

*SRCMBRTXT: Le texte descriptif associé à l'objet en cours de création est le même que celui du membre source. Si aucun texte descriptif n'a été indiqué pour le membre source ou s'il s'agit de blancs, TEXT(*BLANK) est pris par défaut.
*BLANK: Aucun texte n'est indiqué. Lorsque l'exécution d'une commande entraîne le remplacement d'un objet, le texte descriptif associé à cet objet est remplacé par des blancs.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum. Les apostrophes ne sont pas comprises dans la chaîne de 50 caractères.

Séquence de tri (SRTSEQ)

Définit la table de séquence de tri à utiliser pour les comparaisons de chaîne de caractères.

Remarque :Paramètre à utiliser pour créer une requête. Non valable pour créer un FORMAT.

Qualificatif 1 : Séquence de tri

*SRC: Le membre du fichier source contient la séquence de tri à utiliser pour créer la requête.
*JOBRUN: La valeur SRTSEQ (séquence de tri) est utilisée dans chaque requête.
*JOB: La valeur SRTSEQ (séquence de tri) est utilisée pour chaque création de requête.
*HEX: Les valeurs hexadécimales des caractères servent à définir la table de tri. Or, il n'y a pas de table de tri.
*LANGIDUNQ: La table de tri à poids unique correspondant à la langue indiquée au paramètre LANGID est utilisée.
*LANGIDSHR: La table de tri à poids partagé correspondant à la langue indiquée au paramètre LANGID est utilisée.
nom: Précisez le nom de la table de séquence de tri à utiliser pour la création de cette requête.

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: Le système effectue la recherche dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Identificateur de langue (LANGID)

Précisez l'identificateur de langue à utiliser si SRTSEQ(*LANGIDUNQ) ou SRTSEQ(*LANGIDSHR) apparaissent.

*SRC: Le membre du fichier source contient l'identificateur de langue à utiliser pour créer la requête.
*JOBRUN: La valeur LANGID du travail est déterminée lors du lancement de la requête.
*JOB: La valeur LANGID du travail est déterminée lors de la création de la requête.
langage-ID: Précise l'identificateur de langage à utiliser dans la requête.

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.

Remplacer objet (REPLACE)

Indique si l'objet généré par la commande va remplacer un objet de même nom et de même type existant éventuellement dans la bibliothèque utilisée pour la sauvegarde.

*YES: L'objet existant sera remplacé par l'objet généré par la commande.
*NO: L'objet existant ne sera pas remplacé par l'objet généré par la commande.

Exemples

CRTQMQRY   QMQRY(NEWQRY)  SRCFILE(RPTLIB/QRYSRC)

Cette commande permet de créer une requête appelée NEWQRY dans la bibliothèque en cours. La source de la requête est dans le membre NEWQRY, qui se trouve dans le fichier source QRYSRC de la bibliothèque RPTLIB.

Messages d'erreur

Messages *ESCAPE

QWM2701: La commande &1 a échoué.
QWM2703: La commande &1 a été interrompue.
QWM2705: Fichier source &1 de &2 non disponible.
QWM2706: &1 de &2 non remplacé.