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
-
QRYDFNDéfinition d'interrogation -
FLRDans le dossier -
SCHSUBFLRRecherche dans sous-dossiers -
QRYTXTTexte de recherche -
TXTLANGIDIdentificateur de langue -
DOCLListe de documents -
TEXTTexte -
OUTFILEFichier recevant la sortie -
OUTMBROptions pour membre de sortie -
OUTDTATYPType de données en sortie -
USRIDIdentificateur utilisateur -
TIMLMTLimite de temps -
SELLMTLimite de sélection -
ORDERTri sur -
CMDCHRIDID caractères pour commande
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 :
- Le nom du paramètre de profil document à comparer (voir liste ci-après).
- L'une des valeurs d'opérateur de relation (voir liste ci-après).
- La valeur de comparaison.
- 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 :
- Une expression ('chaîne') que le système compare aux entrées de l'index de texte utilisé pour la recherche.
- Une valeur précisant le type de correspondance.
- Une valeur indiquant si les synonymes sont acceptés ou ne le sont pas.
- 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
- 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'.
- 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 :
Indique une expression que le système compare aux entrées de l'index de texte utilisé pour la recherche.
-
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.