Aller au contenu

QRYDOCLIB

Interroger biblio de documents

En bref

La commande QRYDOCLIB (Interroger la bibliothèque de documents) permet de rechercher des documents dans cette bibliothèque.

QRYDOCLIB se lit QRY (Interroger) + DOCLIB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

QRYDOCLIB

Paramètres

Astuce : dans une session 5250, tapez QRYDOCLIB 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 QRYDOCLIB (Interroger la bibliothèque de documents) permet de rechercher des documents dans cette bibliothèque. Le résultat de la recherche est placé dans une liste de documents. Vous pouvez également copier dans un fichier base de données les informations concernant les documents trouvés en vue de les traiter.

L'exécution de la commande QRYDOCLIB permet de créer une liste de documents. La création de cet objet a lieu même si un fichier de sortie est généré, à moins que l'utilisateur n'affecte la valeur *NONE au paramètre DOCL. La liste de documents peut être utilisée par la commande SAVDLO.

Restrictions :

  • L'utilisateur de cette commande doit avoir le droit de travailler par procuration de l'ID utilisateur indiqué. A cet effet, il doit disposer d'une procuration spéciale accordée via la commande GRTUSRPMN (Accorder une procuration à un utilisateur).
  • Le format du fichier en sortie doit être identique à OSIQDL du fichier système, QSYS/QAOSIQDL.
  • Le nom de liste de documents (paramètre Liste de documents (DOCL)) et le nom de fichier de sortie ou le nom de membre (paramètre Fichier recevant la sortie (OUTFILE)) doivent être différents pour chacune des commandes QRYDOCLIB exécutées simultanément.

Paramètres

Mot-clé Description Valeurs possibles Remarques
QRYDFN Définition d'interrogation Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Option d'interrogation *IF
Élément 2: Critère de recherche Values (jusqu'à 49 répétitions): Liste d'éléments
Élément 1: Profil *ACTDATE, *ALWRPL, *ASP, *AUTHOR, *CHGDATE, *CMPDATE, *CPYLST, *CRTDATE, *DOCCLS, *DOCD, *DOCDATE, *DOCTYPE, *EXPDATE, *FILDATE, *IDXDATE, *KWD, *OWNER, *PROJECT, *REF, *REVDATE, *STATUS, *SUBJECT, *USEDATE
Élément 2: Opérateur relationnel *EQ, *GT, *LT, *NE, *GE, *NL, *LE, *NG, *CT, *BG
Élément 3: Valeur de comparaison Valeur caractère, *YES, *NO
Élément 4: Opérateur logique *AND, *OR
FLR Dans le dossier Valeurs uniques: *ALL
Autres valeurs (jusqu'à 100 répétitions): Valeur caractère, *NONE
Facultatif
SCHSUBFLR Recherche dans sous-dossiers *NO, *YES Facultatif
QRYTXT Texte de recherche Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Option d'interrogation *IF
Élément 2: Critère de recherche Values (jusqu'à 30 répétitions): Liste d'éléments
Élément 1: Expression Valeur caractère
Élément 2: Type de concordance *ALL, *EXACT
Élément 3: Synonymes admis *NO, *YES
Élément 4: Opérateur logique *OR, *AND, *ANDNOT
TXTLANGID Identificateur de langue Valeur caractère, *JOB Facultatif
DOCL Liste de documents Valeur caractère, *DFT, *NONE Facultatif
TEXT Texte Valeur caractère, *BLANK Facultatif
OUTFILE Fichier recevant la sortie Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD
OUTDTATYP Type de données en sortie Valeurs uniques: *DFT, *ALL
Autres valeurs (jusqu'à 21 répétitions): *ACTDATE, *AUTHOR, *CHGDATE, *CMPDATE, *CPYLST, *CRTDATE, *DOCCLS, *DOCD, *DOCDATE, *EXPDATE, *FILCAB, *FILDATE, *IDP, *IDXDATE, *KWD, *PROJECT, *REF, *REVDATE, *STATUS, *SUBJECT, *USEDATE
Facultatif
USRID Identificateur utilisateur Valeurs uniques: *CURRENT
Autres valeurs: Liste d'éléments
Facultatif, positionnel 1
Élément 1: ID utilisateur Valeur caractère
Élément 2: Adresse Valeur caractère
TIMLMT Limite de temps 1-9999, *NOMAX Facultatif
SELLMT Limite de sélection 1-32767, *NOMAX Facultatif
ORDER Tri sur Valeurs uniques: *NONE
Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments
Facultatif
Élément 1: Profil *ACTDATE, *ASP, *AUTHOR, *CHGDATE, *CMPDATE, *CPYLST, *CRTDATE, *DOCCLS, *DOCD, *DOCDATE, *DOCTYPE, *EXPDATE, *FILDATE, *IDXDATE, *KWD, *OWNER, *PROJECT, *REF, *REVDATE, *STATUS, *SUBJECT, *USEDATE
Élément 2: Ordre de sélection *ASCEND, *DESCEND
CMDCHRID ID caractères pour commande Valeurs uniques: *SYSVAL, *DEVD
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Jeu de caractères graphiques Entier
Élément 2: Page de codes Entier

Définition d'interrogation (QRYDFN)

Indique les critères de sélection utilisés dans la définition d'interrogation pour sélectionner les documents. Les valeurs indiquées pour ce paramètre permettent d'effectuer une recherche dans la bibliothèque de documents. Si vous indiquez des valeurs différentes de *NONE pour le paramètre Texte de recherche (QRYTXT) et pour ce paramètre, seuls les documents correspondant à ces deux critères réunis seront sélectionnés. Par contre, si vous entrez la valeur *NONE pour les deux paramètres, tous les documents sur lesquels vous avez des droits seront sélectionnés.

Valeurs uniques

*NONE
Aucune définition d'interrogation n'est utilisée pour le choix des documents.

Elément 1 : Option d'interrogation

*IF
Une définition d'interrogation est utilisée pour le choix des documents.

Elément 2 : Critère de recherche

Un ensemble de valeurs est précisé pour chacune des conditions régissant le choix des documents. Chaque ensemble doit contenir quatre valeurs :

  1. Le nom du paramètre de profil document à comparer (voir liste ci-après).
  2. L'une des valeurs d'opérateur de relation (voir liste ci-après).
  3. La valeur de comparaison.
  4. L'un des opérateurs logiques *AND, *OR ou *ANDNOT.

Les valeurs 1 et 3 sont comparées pour vérifier la relation indiquée par la valeur 2. Chaque ensemble relationnel QRYDFN doit être placé entre parenthèses. Vous pouvez préciser 49 ensembles au maximum.

Elément 1 : Profil

Indique le nom du paramètre de profil de document à comparer.

*ACTDATE
Date limite de traitement
*ALWRPL
Remplacement admis
*ASP
ID pool mémoire secondaire
*AUTHOR
Auteur du document
*CHGDATE
Date de la dernière modification
*CMPDATE
Date de traitement
*CPYLST
Liste des copies
*CRTDATE
Date de création
*DOCCLS
Classe de document
*DOCD
Description de document
*DOCDATE
Date du document
*DOCTYPE
Type de document
*EXPDATE
Date de péremption
*FILDATE
Date de classement
*IDXDATE
Dernière date d'indexation
*KWD
Mot clé
*OWNER
Propriétaire du document
*PROJECT
Projet du document
*REF
Référence
*REVDATE
Dernière date de révision
*STATUS
Etat du document
*SUBJECT
Sujet du document
*USEDATE
Date de dernière utilisation

Elément 2 : Opérateur relationnel

L'opérateur de relation exprime la relation devant exister entre la valeur du profil du document et la valeur de comparaison de la définition d'interrogation, pour que le critère de sélection soit vérifié.

L'opérateur *CT sert à exécuter une recherche de contexte. Il demande au système de déterminer si la chaîne de caractères précisée par la valeur de comparaison apparaît dans le paramètre de profil.

L'opérateur *BG permet d'exécuter une recherche en comparant la valeur de comparaison et le début du paramètre de profil. Ce paramètre est tronqué ou étendu en fonction de la longueur de la valeur indiquée. L'opérateur *BG demande au système de déterminer si la chaîne de caractères précisée par la valeur est incluse dans le début du paramètre de profil.

Certains opérateurs ne sont pas acceptés pour certains paramètres de profil. Dans ce cas, le système envoie un message de diagnostic suivi d'un message d'arrêt programme.

Prenez garde aux cas suivants :

  • La zone *ALWRPL (Remplacement admis) peut prendre la valeur OUI ou NON. *EQ est le seul opérateur accepté avec *ALWRPL.
  • Les opérateurs *CT et *BG ne sont pas admis avec la valeur *ASP ou des valeurs de date telles que *CRTDATE et *EXPDATE.
*EQ
Egal
*GT
Supérieur à
*LT
Inférieur à
*NE
Différent de
*GE
Supérieur ou égal à
*NL
Non inférieur à
*LE
Inférieur ou égal à
*NG
Non supérieur à
*CT
Contient
*BG
Débute

Elément 3 : Valeur de comparaison

Indique la valeur de comparaison à utiliser pour la recherche.

caractère
Indiquez la valeur à comparer avec le contenu du paramètre de profil précisé. La valeur du paramètre doit être indiquée entre apostrophes si elle comporte des blancs ou des caractères spéciaux.

La zone *ALWRPL prend l'une ou l'autre des valeurs *YES et *NO. Lorsque ces valeurs sont indiquées avec *ALWRPL, elles sont remplacées par les valeurs internes correspondantes. Lorsqu'elles sont précisées à la zone de texte, elles sont utilisées telles quelles.

La zone *OWNER correspond à un ID utilisateur de 8 caractères et à son adresse. Veillez donc à insérer des blancs de fin si l'ID utilisateur est inférieur à 8 caractères. Par exemple, si l'ID utilisateur est JMDOE (5 caractères) et que son adresse est SYSTEM1, la demande d'interrogation sera :

(*IF ((*OWNER *EQ 'JMDOE   SYSTEM1'))).

Si l'ID utilisateur est JIMSMITH, la demande d'interrogation sera :

(*IF ((*OWNER *EQ 'JIMSMITHSYSTEM1'))).

Les dates doivent être entrées selon le format de date du système.

Remarque :Si l'un des paramètres de profil date est indiqué et que la valeur de comparaison est ' ' (blanc), cette valeur correspond à 01/01/01 ou à 01/001 pour le numéro du jour.La valeur '/' est modifiée selon la valeur de séparateur système QDATSEP.

La limite de longueur acceptée pour les zones de recherche est fixée par la base de données de recherche de l'architecture d'échange de document. Lorsque la valeur dépasse ce maximum, elle est tronquée et ramenée à la longueur admise. Les longueurs maximales sont :

Valeur
Longueur maximale
*DOCD
44 caractères
*DOCCLS
16 caractères
*SUBJECT
60 caractères
*AUTHOR
20 caractères
*KWD
60 caractères
*CPYLST
60 caractères
*OWNER
16 caractères
*REF
60 caractères
*STATUS
20 caractères
*PROJECT
10 caractères

Pour tous les opérateurs, excepté *CT et *BG, si la valeur indiquée est inférieure à la valeur du paramètre de profil, le système ajoute des blancs à cette valeur indiquée afin qu'elle corresponde à la longueur du paramètre de profil.

La casse (majuscules, minuscules ou mixte) utilisée pour l'entrée de la valeur de paramètre initiale ou pour la valeur de comparaison importe peu. Le système convertit en effet ces deux valeurs en majuscules avant d'effectuer la comparaison.

Elément 4 : Opérateur logique

Les opérateurs logiques servent à grouper des conditions. Le premier opérateur AND rencontré signifie qu'un groupe de conditions commence à la condition précédant immédiatement cet opérateur. Les conditions suivantes sont ajoutées au groupe. La première condition comportant l'opérateur OR (ou la dernière condition de la définition d'interrogation) met fin au groupe.

*AND
Les groupes relationnels précédant et suivant la valeur *AND doivent tous être vérifiés pour qu'un document soit choisi.
*OR
Si l'un des groupes relationnels précédant ou suivant la valeur *OR est vérifié, le document est choisi.

Dans le dossier (FLR)

Indique les dossiers dans lesquels les documents correspondant aux critères indiqués pour les paramètres Définition d'interrogation (QRYDFN) et Texte de recherche (QRYTXT) doivent être recherchés.

*ALL
Pour effectuer la recherche dans tous les dossiers du système.
*NONE
La recherche porte sur les documents ne figurant dans aucun dossier.
nom
Indiquez le nom des dossiers où chercher les documents visés. Ces dossiers sont les seuls qui fassent l'objet de la recherche. Un nom de dossier peut être composé d'une série de noms de dossiers (FLR1/FLR2/etc.) si les documents recherchés se trouvent dans un dossier contenu dans un autre dossier. Vous pouvez indiquer jusqu'à 100 dossiers dont le nom ne doit pas dépasser 63 caractères.

Recherche dans sous-dossiers (SCHSUBFLR)

Indique si les sous-dossiers du dossier désigné dans le paramètre Dans le dossier (FLR) doivent être recherchés.

*NO
Les sous-dossiers ne sont pas recherchés.
*YES
Les sous-dossiers du dossier indiqué sont recherchés.

Texte de recherche (QRYTXT)

Indique les critères de recherche de texte utilisés pour sélectionner des documents. Les valeurs que vous précisez pour ce paramètre servent à effectuer des recherches dans l'index de texte. Si vous indiquez des valeurs différentes de *NONE pour le paramètre Définition d'interrogation (QRYDFN) et pour ce paramètre, seuls les documents correspondant à ces deux critères réunis seront sélectionnés. Par contre, si vous entrez la valeur *NONE pour les deux paramètres, tous les documents sur lesquels vous avez des droits seront sélectionnés.

Valeurs uniques

*NONE
Aucun critère de recherche n'est précisé.

Elément 1 : Option d'interrogation

*IF
Des critères de recherche sont utilisés pour la recherche de document.

Elément 2 : Critère de recherche

Un ensemble de valeurs est précisé pour chacune des conditions régissant le choix des documents. Chaque ensemble doit comporter quatre valeurs :

  1. Une expression ('chaîne') que le système compare aux entrées de l'index de texte utilisé pour la recherche.
  2. Une valeur précisant le type de correspondance.
  3. Une valeur indiquant si les synonymes sont acceptés ou ne le sont pas.
  4. Un opérateur logique.

Vous pouvez indiquer jusqu'à 30 ensembles de valeurs. Chacun de ces ensembles doit être placé entre parenthèses.

Elément 1 : Expression

Indique une expression que le système compare aux entrées de l'index de texte utilisé pour la recherche.

caractère
Indiquez une chaîne constituée d'un ou plusieurs mots. N'utilisez pas de ponctuation. Lorsque vous spécifiez des phrases, vous pouvez :
  • Utiliser un astérisque (*) pour masquer un mot complet à l'intérieur de la chaîne. Par exemple, si vous recherchez des documents faisant référence à divers types de rapports annuels, vous pouvez entrer la chaîne suivante :

       rapport * annuel
    

    Vous localiserez ainsi des documents contenant des chaînes telles que 'rapport budgétaire annuel', 'rapport administratif annuel' ou 'rapport commercial annuel', mais aussi des documents contenant la chaîne 'rapport annuel' sans mot intercalaire.

    Lorsque vous masquez un mot, l'astérisque doit être précédé et suivi d'un terme. Tout astérisque placé au début ou à la fin d'une chaîne est ignoré.

  • Utiliser un astérisque (*) pour masquer une partie d'un mot à l'intérieur d'une chaîne. Vous pouvez masquer le début, le milieu ou la fin d'un mot. Par exemple, si vous recherchez des documents faisant référence à l'édition de texte, vous pouvez entrer la chaîne suivante :

       édit* de texte
    

    Vous localiserez ainsi des documents contenant des chaînes telles que 'édition de texte' ou 'éditeur de texte'.

  • Utiliser un point d'interrogation (?) pour masquer un ou plusieurs caractères à l'intérieur d'un mot. Par exemple, si vous recherchez des documents faisant référence au nom 'Lefebvre' orthographié de plusieurs manières différentes, vous pouvez indiquer la chaîne suivante :

       lef??vre
    

    Vous localiserez ainsi des documents contenant des chaînes telles que 'lefebvre', 'lefabvre', 'lefaivre' ou 'lefeuvre'.

Elément 2 : Type de concordance

Indique le type de valeur de comparaison à utiliser pour la recherche.

*ALL
Il faut que la chaîne fasse partie d'une seule phrase, mais il n'est pas nécessaire que les mots apparaissent dans l'ordre indiqué.
*EXACT
Il faut que la chaîne fasse partie d'une seule phrase et que les mots apparaissent dans l'ordre indiqué.

Elément 3 : Synonymes admis

Indique si des synonymes doivent être utilisés pour la recherche.

*NO
Aucun synonyme n'est accepté.
*YES
Si les différents mots de la chaîne indiquée ont des synonymes, ceux-ci sont également comparés aux entrées de l'index de texte.

Remarque :Une recherche prenant en compte les synonymes peut affecter la performance de la demande, car elle porte sur un nombre de termes plus important et sélectionne un plus grand nombre de documents.

Elément 4 : Opérateur logique

Indique l'opérateur logique à utiliser pour la recherche.

*OR
Si le système trouve la chaîne indiquée à gauche ou à droite de la valeur *OR, le document est sélectionné.
*AND
Si le système trouve les chaînes indiquées à gauche et à droite de la valeur *AND, le document est sélectionné.
*ANDNOT
Si le système ne trouve pas la chaîne indiquée à la suite de la valeur *ANDNOT, le document est sélectionné.

Identificateur de langue (TXTLANGID)

Indique l'identificateur de langue des chaînes mentionnées dans la définition d'interrogation. Ce paramètre est obligatoire en présence du paramètre Texte de recherche (QRYTXT) et n'est pas admis lorsque le paramètre QRYTXT a pour valeur *NONE ou qu'il n'est pas indiqué.

*JOB
L'identificateur de langue indiqué pour le travail à partir duquel cette commande a été entrée est utilisé.
caractère
Indiquez un identificateur de langue. Pour obtenir la liste des identificateurs possibles, appuyez sur la touche PF4 lors de l'activation de la fonction d'invite relative au paramètre Identificateur de langue (TXTLANGID).

Liste de documents (DOCL)

Nom de la liste de documents. Cette liste contient un pointeur pour chaque document de la bibliothèque pouvant faire l'objet de la recherche, et constitue une copie de la bibliothèque au moment de l'exécution de la recherche. Aucune mise à jour ne se fait lorsque des documents sont supprimés de la bibliothèque ou lorsqu'ils y sont ajoutés. Le nom de la liste de bibliothèques de documents est précisé avec celui de l'utilisateur demandant la recherche.

*DFT
Un nom créé par le système est utilisé comme nom par défaut. La liste par défaut correspond à l'ID utilisateur désigné dans le paramètre Identificateur utilisateur (USRID).
*NONE
Aucune liste de documents n'est créée.
caractère
Indiquez le nom de la liste de documents. Vous pouvez utiliser jusqu'à 8 caractères.

Texte (TEXT)

Texte décrivant brièvement l'objet.

*BLANK
Aucun texte n'est indiqué.
caractère
Entrez un maximum de 50 caractères, entre apostrophes.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).

Qualificatif 1 : Fichier recevant la sortie

nom
Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificateur 2: Biblio

*LIBL
Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.
*CURLIB
Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.
nom
Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Remarque :Pour créer un nouveau fichier, le système utilise le fichier QAOSIQDL de la bibliothèque QSYS, et prend pour modèle un nom de format OSQDL.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST
Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.
nom
Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE
Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.
*ADD
Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Type de données en sortie (OUTDTATYP)

Indique que certaines informations sur les documents sélectionnés sont écrites dans le fichier de sortie si une valeur est précisée dans le paramètre Fichier recevant la sortie (OUTFILE).

*DFT
L'enregistrement d'informations sur le document est écrit dans le fichier de sortie. Cela équivaut à indiquer *DOCD. Le code d'enregistrement est 105.
*ALL
Tous les enregistrements d'informations sur le document sont écrits.
*ACTDATE
L'enregistrement de la date d'échéance est écrit (code 135).
*AUTHOR
L'enregistrement de l'auteur est écrit (code 145).
*CHGDATE
L'enregistrement de la date de dernière modification est écrit (code 130).
*CMPDATE
L'enregistrement de la date d'achèvement est écrit (code 140).
*CPYLST
Les enregistrements de liste de copie sont écrits (code 150).
*CRTDATE
L'enregistrement de la date de création est écrit (code 110).
*DOCCLS
L'enregistrement de la classe du document est écrit (code 155).
*DOCD
L'enregistrement de descriptions sur le document est écrit. Le code d'enregistrement est 105.
*DOCDATE
L'enregistrement de la date du document est écrit (code 120).
*EXPDATE
L'enregistrement de la date de péremption est écrit (code 115).
*FILCAB
L'enregistrement de la référence du classeur est écrit (code 160).
*FILDATE
L'enregistrement de la date du fichier est écrit (code 125).
*IDP
L'enregistrement relatif au profil d'échange du document (IDP) est écrit (code 500).
*IDXDATE
L'enregistrement de dernière date d'indexation est écrit dans le fichier de sortie.
*KWD
Les enregistrements de mot clé sont écrits (code 170).
*PROJECT
L'enregistrement relatif au projet est écrit (code 185).
*REF
L'enregistrement de la référence est écrit (code 175).
*REVDATE
La date de dernière révision du contenu du document est écrite dans le fichier de sortie.
*STATUS
L'enregistrement de l'état est écrit (code 180).
*SUBJECT
L'enregistrement du sujet est écrit (code 165).
*USEDATE
L'enregistrement de la date de dernière utilisation est écrit (code 200).

Identificateur utilisateur (USRID)

ID utilisateur et adresse à associer à la demande.

Valeurs uniques

*CURRENT
Vous exécutez la demande pour votre compte.

Elément 1 : ID utilisateur

caractère
Indiquez l'ID d'un autre utilisateur ou le vôtre. Vous devez disposer d'une procuration de cet utilisateur ou du droit spécial *ALLOBJ (tous les objets).

Elément 2 : Adresse

caractère
Indiquez l'adresse d'un autre utilisateur ou la vôtre. Si vous indiquez l'ID d'un autre utilisateur, vous devez avoir une procuration de cet utilisateur ou un droit *ALLOBJ.

Limite de temps (TIMLMT)

Temps alloué pour l'exécution de la recherche.

*NOMAX
Aucune limite de temps n'est fixée pour la recherche. Tous les documents applicables font partie de la recherche.
1-9999
Indiquez le délai maximal d'exécution de la recherche (en minutes). Une limite de deux heures (120 minutes), par exemple, est définie par TIMLMT (120). Si la recherche n'est pas terminée une fois le temps écoulé, elle s'achève avec l'envoi d'un message d'information suivi d'un message d'achèvement. Le fichier en sortie, et la liste de documents si elle est indiquée, contiendront les documents sélectionnés dans le temps imparti.

Limite de sélection (SELLMT)

Nombre de documents pouvant être sélectionnés au cours de la recherche.

*NOMAX
Aucune limite n'est fixée. Tous les documents pouvant être sélectionnés le sont, dans la limite système qui est de 698876. Si plus de 698876 documents sont sélectionnés, un message d'information indiquant que la limite a été atteinte sera envoyé. Dans tous les cas, la liste de documents ne contiendra des informations que pour 32767 documents au maximum.
1-32767
Indiquez le nombre maximum de documents à sélectionner. Si le nombre de documents est supérieur à la limite spécifiée, un message indiquant que la limite a été atteinte s'affichera. Le nombre de documents sélectionnés est indiqué dans le message d'achèvement. Le fichier de sortie contiendra des informations sur les documents sélectionnés jusqu'à cette limite.

Tri sur (ORDER)

Indique que les documents sélectionnés doivent être triés (dans l'ordre croissant ou décroissant) lorsqu'ils sont placés dans la liste de documents créée ou dans le fichier de sortie. Cet ordre est défini pour un maximum de 5 paramètres.

Remarque :Si vous indiquez une valeur différente de *NONE dans le paramètre Texte de recherche (QRYTXT), le tri n'est pas admis.

La demande de tri peut nuire à la performance du système; celui-ci exécute mieux les recherches lorsqu'il n'a pas à trier les documents.

Valeurs uniques

*NONE
Aucun tri particulier pour les documents choisis.

Elément 1 : Profil

*ACTDATE
Les documents présentés sont triés d'après leur date limite de traitement.
*ASP
Les documents présentés sont triés d'après l'ID pool mémoire secondaire (paramètre ASPID).
*AUTHOR
Les documents présentés sont triés d'après leur auteur.
*CHGDATE
Les documents présentés sont triés d'après la date de la dernière modification.
*CMPDATE
Les documents présentés sont triés d'après leur date de traitement.
*CPYLST
Les documents présentés sont triés d'après la liste des copies.
*CRTDATE
Les documents présentés sont triés d'après leur date de création.
*DOCCLS
Les documents présentés sont triés d'après leur classe.
*DOCD
Les documents présentés sont triés d'après leur description.
*DOCDATE
Les documents présentés sont triés d'après la date qui leur a été attribuée.
*DOCTYPE
Les documents présentés sont triés d'après le type de document.
*EXPDATE
Les documents présentés sont triés d'après leur date de péremption.
*FILDATE
Les documents présentés sont triés d'après leur date de classement.
*IDXDATE
Les documents présentés sont triés d'après la dernière date d'indexation. Les services de recherche de texte doivent être installés lorsque cette valeur est indiquée.
*KWD
Les documents présentés sont triés d'après le mot clé.
*OWNER
Les documents présentés sont triés d'après le nom de profil utilisateur de leur propriétaire.
*PROJECT
Les documents présentés sont triés d'après le projet.
*REF
Les documents présentés sont triés d'après la référence.
*REVDATE
Les documents présentés sont triés d'après la dernière date de révision du contenu.
*STATUS
Les documents présentés sont triés d'après leur état.
*SUBJECT
Les documents présentés sont triés d'après leur sujet.
*USEDATE
Les documents présentés sont triés d'après la date à laquelle ils ont été utilisés pour la dernière fois.

Elément 2 : Ordre de sélection

*ASCEND
Les documents présentés sont triés par ordre croissant.
*DESCEND
Les documents présentés sont triés par ordre décroissant.

ID caractères pour commande (CMDCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant aux données saisies comme valeurs des paramètres de la commande. Cet identificateur dépend de l'écran utilisé pour l'entrée de la commande.

Le paramètre CMDCHRID permet de traiter les paramètres énumérés ci-dessous. Il signifie que les données sont converties en une page de codes et un jeu de caractères communs à tous les documents dans la base de données servant à la recherche. La valeur du jeu de caractères et de la page de codes est '697 500', excepté pour le paramètre Identificateur utilisateur (USRID), qui prend la valeur '930 500'.

Les paramètres suivants font l'objet d'une conversion :

  • Identificateur utilisateur (USRID)
  • Liste de documents (DOCL)
  • Définition d'interrogation (QRYDFN)
  • Texte de recherche (QRYTXT)
  • Texte (TEXT)

Valeurs uniques

*SYSVAL
Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.
*DEVD
Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767
Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767
Indiquez la page de codes à utiliser.

Exemples

QRYDOCLIB   USRID(*CURRENT)  OUTFILE(*NONE)  DOCL(MYLIST)
            QRYDFN(*IF ((*DOCD *EQ DOCDESC *AND)
                        (*DOCCLS *BG CLASS *OR)
                        (*FILDATE *LE '06/13/88')))

Cette commande localise les documents remplissant les critères de recherche suivants : description de document égale à DOCDESC et classe de document commençant par CLASS, ou date limite du fichier égale à 06/13/88. Les résultats de la recherche sont enregistrés dans la liste de documents MYLIST.

Messages d'erreur

Messages *ESCAPE

CPF900B
ID util et adresse &1 &2 introuvables dans répertoire système.
CPF900C
L'ouverture de session et la vérification d'inscription de l'util ont échoué.
CPF905C
Erreur lors de la recherche d'une table de conversion.
CPF905D
L'analyse de la bibliothèque de documents a échoué.
CPF9096
Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.
CPF9860
Erreur lors du traitement du fichier de sortie.

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