QRYDST

La commande QRYDST (Interroger les distributions) vous permet de demander des informations sur les distributions pour votre compte ou par procuration d'un autre utilisateur.

Restrictions :

1. Pour demander des informations sur les distributions d'un autre utilisateur, celui-ci doit vous avoir accordé, à l'aide de la commande GRTUSRPMN, une procuration vous permettant de travailler pour son compte.
2. Si USRID(*ALLAUT) est indiqué, et que vous n'ayez pas de procuration, le système fournira uniquement les informations relatives aux distributions qui vous sont destinées.
3. Le demandeur de la commande doit être inscrit dans le répertoire de distribution du système. Un demandeur ne peut recevoir de distribution personnelle lorsqu'il travaille par procuration.
4. Le paramètre DLTSTS ne peut pas être utilisé pour les distributions entrantes. Le système ignore ce paramètre lorsque OPTION (*IN) est indiqué.
5. Le demandeur qui travaille pour le compte d'un autre utilisateur n'a pas accès à la distribution personnelle.

Paramètres

Entrante ou sortante (OPTION)

Type de distribution dont les informations sont fournies.

*IN

Les informations fournies portent sur la distribution entrante.

*OUT

Les informations fournies portent sur la distribution sortante. L'état sortant est attribué par le système à une distribution envoyée à un ou plusieurs utilisateurs, qui doivent fournir un accusé de réception.

Identificateur utilisateur (USRID)

ID utilisateur et adresse associées à la demande.

*CURRENT

Les informations relatives à vos distributions sont fournies.

*ALLAUT

Les informations relatives à vos distributions et à celles de tous les utilisateurs qui vous ont donné une procuration, sont fournies.

ID-utilisateur

Indiquez l'ID de l'utilisateur dont les informations sur les distributions doivent être fournies. Vous devez avoir une procuration de cet utilisateur si l'ID précisé n'est pas le vôtre.

adresse-ID-utilisateur

Indiquez l'ID et l'adresse de l'utilisateur dont les informations sur les distributions doivent être présentées. Vous devez avoir une procuration de cet utilisateur si l'ID et l'adresse précisées ne sont pas les vôtres.

Supprimer état (DLTSTS)

Indique si l'état des distributions sortantes doit être supprimé du système.

*NO

L'état des distributions n'est pas supprimé du système.

*YES

L'état des distributions est supprimé si tous les destinataires ont traité leurs distributions.

Remarque :Les informations d'état sont utilisées par d'autres produits. Faites en sorte de ne pas effacer les informations qu'utilisent ces produits pour assurer le suivi de leurs distributions.

Fichier recevant la sortie (OUTFILE)

Nom du fichier base de données dans lequel la sortie est envoyée. Si ce fichier n'existe pas, le système en crée un dans la bibliothèque précisée. Si le fichier est créé par cette fonction, sa description se lit comme suit : 'SORTIE DE QRYDST', et le droit accordé à tous les utilisateurs sans droits spécifiques est le même que le droit pour objets crées de la bibliothèque dans laquelle le fichier est créé. Ce droit peut être affiché à l'aide de la commande DSPLIBD (Afficher une description de bibliothèque).

Pour créer un nouveau fichier alors que *IN est indiqué à l'invite Entrante ou sortante (paramètre OPTION), le système utilise le fichier modèle QAOSILIN de la bibliothèque QSYS, avec un nom de format OSLIN.

Pour créer un nouveau fichier alors que *OUT est indiqué à l'invite Entrante ou sortante (paramètre OPTION), le système utilise le fichier modèle QAOSILOT de la bibliothèque QSYS, avec un nom de format OSLOUT.

*NONE

La sortie n'est pas envoyée dans un fichier base de données. Si *NONE est indiqué, la sortie résultant de cette commande est un message d'achèvement indiquant le nombre de distributions figurant dans l'index du répertoire de distribution (*DRX) DIA pour l'option, l'ID utilisateur et l'adresse précisées.

Lorsque *IN est indiqué à l'invite Entrante ou sortante (paramètre OPTION), le nombre total de distributions nouvelles et anciennes est présenté. Chaque fois que la commande QRYDST est exécutée, le courrier qui était à l'état nouveau passe à l'état ancien.

Remarque :OfficeVision/400 ne tient en fait pas compte de l'état ; il traite tout le courrier comme s'il était nouveau.

nom-du-fichier-base-de-données

Indiquez le nom du fichier base de données et de la bibliothèque qui recevront la sortie affichée.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*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 fichier base de données est recherché dans la bibliothèque en cours pour ce travail. Si aucune bibliothèque en cours ne figure dans la liste des bibliothèques, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque où se trouve le fichier base de données.

Options pour membre de sortie (OUTMBR)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

Les valeurs possibles pour le membre recevant la sortie sont les suivantes :

*FIRST

Le premier membre du fichier reçoit la sortie. Si ce membre n'existe pas, le système en crée un du nom du fichier indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

nom-du-membre

Indiquez le nom du membre de fichier recevant la sortie. Si ce membre n'existe pas, le système le crée. S'il existe, le système ajoute à la fin les nouveaux enregistrements ou le met d'abord à blanc avant d'y ajouter les enregistrements.

Les valeurs possibles pour l'ajout ou le remplacement sont les suivantes :

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

Etat (STATUS)

Etat du courrier pour la distribution sur laquelle vous demandez des informations. Ce paramètre n'est admis que si *IN est indiqué à l'invite Entrante ou sortante (paramètre OPTION) et qu'un nom de fichier de sortie soit précisé à l'invite Fichier recevant la sortie (paramètre OUTFILE).

*ALL

Le système présente les informations relatives aux distributions, peu importe l'état du courrier qu'elles contiennent.

*NEW

Le système présente uniquement les informations relatives aux distributions dont le courrier porte l'état NOUVEAU.

*OLD

Le système présente uniquement les informations relatives aux distributions dont le courrier porte l'état ANCIEN, ce qui indique que la distribution a fait l'objet d'une demande qui n'a pas encore été traitée.

*OPENED

Le système présente uniquement les informations relatives aux distributions dont le courrier porte l'état OUVERT.

*UNOPENED

Le système présente uniquement les informations relatives aux distributions dont le courrier porte l'état NOUVEAU ou ANCIEN.

*LOCAL

Le système présente uniquement les informations relatives aux distributions dont le courrier porte l'état LOCAL, ce qui indique que la distribution a été classée sur le système local.

*REMOTE

Le système présente uniquement les informations relatives aux distributions dont le courrier porte l'état ELOIGNE, ce qui indique que la distribution a été classée sur un système éloigné.

*FILEPND

Le système présente uniquement les informations relatives aux distributions dont l'état est EN SUSPENS, ce qui indique qu'elles sont en cours de classement sur le système local ou sur un système éloigné, mais que l'opération n'est pas terminée.

*DELETED

Le système présente uniquement les informations relatives aux distributions dont l'état est SUPPRIME, ce qui indique que le document auquel fait référence la distribution a été supprimé.

*DAMAGED

Le système présente uniquement les informations relatives aux distributions dont l'état est ENDOMMAGE, ce qui indique que le document auquel fait référence la distribution est endommagé.

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.

La valeur indiquée à l'invite Identificateur utilisateur (paramètre USRID) est convertie en jeu de caractères et page de codes '930 500'.

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

QRYDST   USER(*CURRENT)  OPTION(*IN)
         OUTFILE(*CURLIB/MYFILE)  OUTMBR(*FIRST *ADD)

Cette commande permet de demander des informations concernant les distributions entrantes pour l'utilisateur en cours de la commande. La sortie est dirigée vers le fichier de base de données MYFILE dans la bibliothèque en cours de l'utilisateur. Elle est ensuite ajoutée au premier membre de ce fichier.

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.

CPF907C

&1 distribution(s) effectuée(s), mais sans accusé de réception.

CPF9096

Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.

CPF9097

La demande d'interrogation de distribution a échoué.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9860

Erreur lors du traitement du fichier de sortie.