RUNQRY

La commande RUNQRY permet de lancer une analyse existante ou une analyse par défaut si uniquement un nom de fichier est indiqué pour cette commande. L'analyse extrait des informations de la base de données du système, puis génère un état de ces informations. Cet état est créé sous forme détaillée ou récapitulative. La définition de l'analyse peut être imprimée lorsqu'une sortie vers une imprimante ou un fichier base de données est indiquée. Cette sortie est affichée, imprimée ou stockée dans un fichier base de données. La commande permet de lancer les trois types d'analyse suivants : une analyse existante (celle qui a déjà été créée), une analyse existante dont certaines valeurs ont été remplacées par des valeurs spécifiées dans cette commande, ou une analyse par défaut en fonction uniquement des valeurs et des paramètres par défaut indiquées dans cette commande.

• Pour lancer une analyse existante sans modifier le ou les fichiers à analyser, utilisez le paramètre QRY (sans le paramètre QRYFILE) qui permet d'indiquer le nom de l'analyse.
• Pour lancer une version modifiée d'une analyse existante, utilisez le paramètre QRY et les paramètres appropriés permettant de modifier la définition à votre gré. Les valeurs de paramètre indiquées dans cette commande remplacent les valeurs correspondantes de la définition d'analyse existante mais uniquement lors du traitement de la commande. Par exemple, utilisez le paramètre QRYFILE pour indiquer un autre fichier ou une autre liste de fichiers à utiliser dans l'analyse.
• Pour analyser un fichier ne comportant pas de définition d'analyse précédente, utilisez le paramètre QRYFILE afin d'indiquer le fichier à analyser. Vous pouvez indiquer uniquement un nom de fichier pour une analyse par défaut.

Si les paramètres QRY et QRYFILE sont spécifiés, les fichiers indiqués au paramètre QRYFILE remplacent les noms de fichier indiqués dans l'analyse. Par conséquent, si plusieurs fichiers (et membres) sont définis dans la définition d'analyse et que vous souhaitez en modifier un ou deux, indiquez *SAME pour les sélections de fichier non modifiées, puis spécifiez les valeurs des fichiers à remplacer.

Remarques :

1. Lors de l'exécution d'une version modifiée d'une analyse existante, les modifications indiquées dans la commande RUNQRY ne remplacent aucune des valeurs de la définition d'analyse elle-même et n'affectent que les résultats de l'état en cours d'exécution.
2. Si une analyse existante (identifiée au paramètre QRY) est utilisée, *RUNOPT est la valeur par défaut des paramètres non spécifiés ; c'est-à-dire que la même valeur indiquée (ou prise par défaut) dans la définition de l'analyse est utilisée par défaut. S'il s'agit d'une analyse par défaut, la valeur par défaut ne correspond pas à *RUNOPT mais à la valeur prédéfinie suivante répertoriée dans le diagramme de syntaxe.

Paramètres

Analyse (paramètre QRY)

Indique le nom de l'analyse existante à exécuter. Si QRY n'est pas précisé, QRYFILE doit être indiqué.

Les valeurs possibles sont les suivantes :

*NONE

Il n'existe aucune définition d'analyse ; une analyse par défaut sera donc utilisée pour rechercher les informations dans le fichier indiqué au paramètre QRYFILE.

nom-analyse

Indiquez le nom de l'analyse à exécuter.

Si aucune valeur n'est précisée, le ou les fichiers indiqués lors de la définition de l'analyse correspondent aux fichiers à analyser.

Le nom de l'analyse peut être qualifié de l'une des valeurs de bibliothèque 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

La définition d'analyse indiquée est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque qui contient l'analyse.

Fichier à analyser (paramètre QRYFILE)

Indique le ou les fichiers base de données à analyser à titre d'information. Si le paramètre QRY est spécifié, 32 fichiers peuvent être indiqués à ce paramètre à l'aide des noms de fichiers et/ou de la valeur par défaut *SAME relative à un ou plusieurs fichiers. Si le paramètre QRY n'est pas spécifié, uniquement un nom de fichier peut être indiqué à ce paramètre. Si QRYFILE n'est pas précisé, QRY doit l'être.

Si aucune valeur n'est spécifiée, le ou les fichiers indiqués lors de la définition de l'analyse correspondent aux fichiers permettant d'exécuter l'analyse.

Ce paramètre admet des valeurs multiples.

Ce paramètre comporte deux parties.

Elément 1 : Nom de fichier base de données

Les valeurs possibles sont les suivantes :

nom-fichier-base-données

Indiquez le nom d'un ou de plusieurs fichiers base de données contenant les données à partir desquelles le système extrait des informations permettant de générer la sortie. Jusqu'à 32 fichiers peuvent être indiqués.

*SAME

L'ensemble de fichiers est le même que celui indiqué dans la définition d'analyse.

Le nom d'un fichier base de données peut être qualifié de l'une des valeurs de bibliothèque suivantes :

*SAME

La valeur de la bibliothèque, du fichier et du membre reste inchangée pour le fichier dans cette position de la liste. Les valeurs sont les mêmes que celles définies par l'analyse. Toutes les valeurs spécifiées pour la bibliothèque, le fichier et le membre ne sont pas prises en compte.

*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 du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

*RUNOPT

La bibliothèque indiquée lors du choix des fichiers est utilisée.

nom-bibliothèque

Entrez le nom de la bibliothèque dans laquelle se trouve le fichier base de données.

Elément 2: Membre de fichier base de données

Pour les noms de membres, les valeurs possibles sont les suivantes :

nom-membre

Indiquez le nom du membre de fichier à analyser.

*RUNOPT

Le membre indiqué lors du choix des fichiers est utilisé.

*FIRST

Le membre à analyser est le premier du fichier.

*LAST

Le membre à analyser est le dernier du fichier.

*ALL

Le fichier d'entrée est une table partitionnée, dans laquelle tous les éléments du fichier seront analysés.

Type de sortie (paramètre OUTTYPE)

Indique la destination du rapport ou des données en sortie générés par l'analyse. Si une valeur n'est pas précisée dans l'analyse et n'est pas entrée dans la commande, ou si un nom d'analyse n'est pas indiqué, *DISPLAY est pris par défaut.

Les valeurs possibles sont les suivantes :

*RUNOPT

S'il existe une définition d'analyse, le type de sortie obtenu lors de l'exécution de l'analyse est celui indiqué dans cette définition.

*DISPLAY

La sortie générée par l'analyse est envoyée au clavier-écran émetteur de la commande. Si elle est traitée par lots, la sortie est envoyée à l'imprimante.

*PRINTER

La sortie générée par l'analyse est imprimée.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué au paramètre OUTFILE.

Nature de la sortie (paramètre OUTFORM)

Indique la nature de la sortie générée par l'analyse. Si aucune valeur n'a été indiquée, ni dans l'analyse, ni dans la commande, ou si aucun nom d'analyse n'a été précisé, *DETAIL est pris par défaut.

Les valeurs possibles sont les suivantes :

*RUNOPT

Si une définition d'analyse est utilisée, la nature de la sortie utilisée lors de l'exécution de l'analyse est indiquée dans cette définition.

*DETAIL

La nature de la sortie générée par l'analyse est un rapport contenant les enregistrements détail et, le cas échéant, les enregistrements récapitulatifs.

*SUMMARY

La nature de la sortie générée par l'analyse est un rapport contenant uniquement les enregistrements récapitulatifs.

Sélection d'enregistrements (paramètre RCDSLT)

Indique si l'analyse est lancée à l'aide d'un test de sélection au moment de l'exécution.

Remarque :Pour que vous puissiez indiquer *YES, le logiciel sous licence Query for i5/OS doit être installé et l'analyse doit être exécutée en mode interactif.

Les valeurs possibles sont les suivantes :

*NO

L'analyse est exécutée sans que l'écran Choix des enregistrements ne s'affiche.

*YES

La sélection des enregistrements est active, mais ne s'applique qu'à cette exécution. L'écran qui apparaît vous permet de modifier les tests de sélection d'enregistrements définis dans l'analyse ou de les indiquer si aucun nom d'analyse n'a été précisé.

Remarque :Pour la sortie à afficher, l'analyse peut être exécutée de façon itérative.

Impression de la définition (paramètre PRTDFN)

Indique si, lors de l'exécution de l'analyse, la définition doit être imprimée en même temps que le rapport. L'impression de la définition peut s'effectuer lorsque les données en sortie sont imprimées ou stockées dans un fichier base de données, selon la valeur du paramètre OUTTYPE. Si une valeur n'est pas spécifiée dans l'analyse, ni dans ce paramètre, ou si un nom d'analyse n'est pas indiqué, *NO est pris par défaut.

Les valeurs possibles sont les suivantes :

*RUNOPT

S'il existe une définition lors de l'exécution de l'analyse, l'option d'impression utilisée provient de cette définition.

*NO

La définition de l'analyse n'est pas imprimée lors de l'exécution.

*YES

La définition d'analyse est imprimée dans le rapport. Si le paramètre OUTTYPE(*DISPLAY) est indiqué ou pris par défaut, vous ne pouvez pas indiquer *YES.

Unité imprimante (paramètre PRTDEV)

Indique l'unité d'imprimante sur laquelle le rapport est imprimé. Si aucune valeur n'est spécifiée, l'imprimante indiquée lors de la définition de l'analyse est prise par défaut. Si aucune imprimante n'est indiquée dans l'analyse ou à ce paramètre, ou si aucun nom d'analyse n'a été précisé, la valeur *PRINT est prise par défaut.

Remarque :Si le remplacement du fichier imprimante QPQUPRFIL est en vigueur, ce paramètre utilise la valeur indiquée par le remplacement.

Les valeurs possibles sont les suivantes :

*RUNOPT

S'il existe une définition d'analyse, l'imprimante utilisée lors de l'exécution est celle indiquée dans cette définition.

*PRINT

L'imprimante par défaut (définie par QPQUPRFIL) est utilisée lors de l'exécution de cette analyse.

nom-imprimante

Indiquez le nom de l'imprimante à utiliser lors de l'exécution de cette analyse.

Taille de l'imprimé (paramètre FORMSIZE)

Indique la hauteur et la largeur de la page sur laquelle le rapport est imprimé. Si une largeur de page supérieure à 132 est indiquée, l'analyse ouvrira le fichier avec CPI(15) et FONT(*CPI). Si cette analyse ou ce paramètre ne contient aucune valeur ou si aucun nom d'analyse n'est indiqué, la valeur 132 devient la largeur par défaut et la valeur du fichier QPQUPRFIL devient la hauteur par défaut.

Remarque :Si le remplacement du fichier imprimante QPQUPRFIL est en vigueur, ce paramètre utilise la valeur indiquée par le remplacement.

Ce paramètre comporte deux parties.

Elément 1 : Hauteur de page

*RUNOPT

S'il existe une définition d'analyse lors de l'exécution de l'analyse, la taille de l'imprimé utilisée dans la définition d'analyse est utilisée. Si la taille de l'imprimé indiquée dans cette définition est à blanc, la valeur provenant de QPQUPRFIL est prise par défaut.

hauteur-page

Indiquez la hauteur de page à utiliser lors de l'exécution de cette analyse. Vous pouvez entrer une valeur comprise entre 1 et 255.

Elément 2 : Largeur de page

*RUNOPT

S'il existe une définition d'analyse lors de l'exécution de l'analyse, la taille de l'imprimé utilisée dans la définition d'analyse est utilisée. Si la taille de l'imprimé indiquée dans cette définition est à blanc, la valeur provenant de QPQUPRFIL est prise par défaut.

largeur-page

Indiquez la largeur de page utilisée lors de l'exécution de cette analyse. Les valeurs admises sont comprises entre 1 et 378.

Type d'imprimé (paramètre FORMTYPE)

Indique sur quel type d'imprimé la sortie sera générée. Les identificateurs permettant d'indiquer le type d'imprimé sont définis par l'utilisateur ; ils peuvent comporter jusqu'à 10 caractères.

Remarque :Si aucune valeur n'est spécifiée dans l'analyse ou à ce paramètre, ou si aucun nom d'analyse n'est indiqué, la valeur de QPQUPRFIL est prise par défaut. Si le remplacement du fichier imprimante QPQUPRFIL est en vigueur, ce paramètre utilise la valeur indiquée par le remplacement.

Les valeurs possibles sont les suivantes :

*RUNOPT

S'il existe une définition d'analyse, le type d'imprimé utilisé lors de l'exécution est celui indiqué dans cette définition.

type-imprimé

Indiquez le type de papier utilisé lors de l'exécution de cette analyse.

Nombre d'exemplaires (paramètre COPIES)

Indique le nombre d'exemplaires à imprimer.

Remarque :Si aucune valeur n'est spécifiée dans l'analyse ou à ce paramètre, ou si aucun nom d'analyse n'est indiqué, la valeur 1 est prise par défaut pour le nombre d'exemplaires. Si le remplacement du fichier imprimante QPQUPRFIL est en vigueur, ce paramètre utilise la valeur indiquée par le remplacement.

Les valeurs possibles sont les suivantes :

*RUNOPT

S'il existe une définition d'analyse, le nombre d'exemplaires utilisé lors de l'exécution est celui indiqué dans cette définition. Si ce dernier est à blanc, le nombre d'exemplaires indiqué dans QPQUPRFIL est pris par défaut.

nombre-exemplaires

Indiquez le nombre d'exemplaires à imprimer lors de l'exécution de cette analyse. Ce nombre doit être compris entre 1 et 255.

Interligne (paramètre LINESPACE)

Indique l'interligne à utiliser dans le rapport. Vous pouvez préciser un nombre de 1 à 3. Si aucune valeur n'est spécifiée dans l'analyse ou à ce paramètre, ou si vous n'indiquez pas de nom d'analyse, 1 est pris par défaut.

Les valeurs possibles sont les suivantes :

*RUNOPT

S'il existe une définition d'analyse, le nombre de lignes indiqué dans cette définition est utilisé lors de l'exécution de l'analyse.

1

Interligne simple (aucune ligne blanche intercalaire) lors de l'impression de l'analyse.

2

Interligne double (1 ligne blanche intercalaire) lors de l'impression de l'analyse.

3

Interligne triple (2 lignes blanches intercalaires) lors de l'impression de l'analyse.

Fichier de sortie (paramètre OUTFILE)

Indique le nom du fichier base de données (s'il existe) qui reçoit la sortie d'analyse. Si vous n'indiquez aucune valeur, la bibliothèque, le fichier, le membre et l'option définis dans l'analyse sont pris par défaut. Si aucune analyse n'est spécifiée, le fichier QQRYOUT est créé dans la bibliothèque par défaut du fichier en sortie. Cette bibliothèque est définie dans le profil d'analyse ou dans la bibliothèque en cours (*CURLIB) si aucun profil n'existe. Le premier membre (*FIRST) de ce nouveau fichier est utilisé pour la sortie.

Remarque :Si vous n'avez pas indiqué de bibliothèque en cours, QGPL est utilisée.

Si le nom indiqué par le paramètre OUTFILE n'existe pas, le système le crée dans la bibliothèque indiquée.

Ce paramètre comporte trois parties.

Elément 1 : Nom de fichier base de données. Les valeurs possibles sont les suivantes :

nom-fichier-base-données

Indiquez le nom du fichier base de données qui recevra la sortie d'analyse.

*RUNOPT

Le fichier base de données spécifié dans l'analyse permet de recevoir les données en sortie. Le fichier, la bibliothèque, le membre et l'option restent inchangés. Les valeurs indiquées pour ces derniers, à l'exception du fichier, ne sont pas prises en compte.

Le nom du fichier base de données peut être qualifié de l'une des valeurs de bibliothèque suivantes :

*RUNOPT

Les données en sortie sont acheminées vers la bibliothèque désignée, le cas échéant, dans la définition d'analyse.

*CURLIB

Le fichier base de données est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Entrez le nom de la bibliothèque à utiliser.

Elément 2: Membre de fichier base de données

Les valeurs possibles sont les suivantes :

*FIRST

La sortie d'analyse est stockée dans le premier membre du fichier.

*LAST

La sortie d'analyse est stockée dans le dernier membre du fichier.

*RUNOPT

La sortie est stockée dans le membre indiqué dans l'analyse.

*ALL

Le fichier de sortie est une table partitionnée, dans laquelle tous les éléments du fichier sont utilisés pour recevoir le résultat de l'analyse. Lorsque *ALL est indiqué pour l'élément, l'option Élément 3 Data peut être définie uniquement sur *RPLMBR ou sur *ADDMBR. La table partitionnée doit déjà exister au moment où l'analyse est exécutée.

nom-membre

La sortie d'analyse est stockée dans le membre du fichier dont le nom est indiqué.

Elément 3 : Ajout ou remplacement de données

La dernière option indique s'il faut placer les données dans un nouveau fichier base de données, remplacer un fichier base de données existant, ajouter un nouveau membre, remplacer un membre existant ou ajouter des données dans un membre existant. Si aucune valeur n'est spécifiée dans l'analyse ou à ce paramètre, ou si aucun nom d'analyse n'est indiqué, la valeur *NEWFILE est prise par défaut.

*RUNOPT

Si une définition d'analyse est utilisée, le membre indiqué dans cette définition correspond au type utilisé lors de l'exécution de cette analyse.

*NEWFILE

Les données en sortie sont stockées dans un nouveau fichier base de données. Cette option n'est pas valable lorsque le nom d'élément est défini sur *ALL.

*RPLFILE

L'ancien fichier est supprimé, et un nouveau fichier est créé. Cette option n'est pas valable lorsque le nom d'élément est défini sur *ALL.

*NEWMBR

Les données en sortie constituent un nouveau membre. Cette option n'est pas valable lorsque le nom d'élément est défini sur *ALL.

*RPLMBR

Le contenu de l'ancien membre est effacé et remplacé par la sortie de l'analyse.

*ADDMBR

Les données en sortie sont ajoutées à la fin d'un membre existant.

Droits (paramètre AUT)

Indique les droits accordés aux utilisateurs ne possédant pas de droits spécifiques sur le fichier en sortie, ne figurant dans aucune liste d'autorisation ou appartenant à un groupe ne possédant pas de droits spécifiques sur le fichier en sortie. Pour plus d'informations sur ce paramètre, reportez-vous à l'annexe A du manuel CL Reference.

Remarque :Les droits sont accordés uniquement après création ou remplacement du fichier en sortie.

Les valeurs possibles sont les suivantes :

*RUNOPT

Les droits utilisés sont ceux qui figurent, le cas échéant, dans la définition d'analyse.

*LIBCRTAUT

Les droits publics sur le fichier en sortie sont extraits de la valeur précisée au paramètre CRTAUT de la bibliothèque cible (celle qui doit contenir le fichier en sortie). Ces droits publics sont définis dès la création du fichier en sortie. Si après cela, la valeur CRTAUT de la bibliothèque est modifiée, la nouvelle valeur n'affectera aucun des objets existants.

*CHANGE

Vous pouvez effectuer toutes les opérations au niveau du fichier en sortie, à l'exception de celles réservées au propriétaire ou de celles limitées par le droit d'existence et de gestion sur l'objet. Vous pouvez modifier et effectuer des fonctions de base sur le fichier en sortie. Le droit de modification englobe le droit d'opération sur l'objet et le droit sur toutes les données.

*USE

Vous pouvez effectuer des opérations de base sur le fichier en sortie, par exemple, l'exécution d'un programme ou la lecture d'un fichier. Vous ne pouvez pas modifier le fichier en sortie. Le droit *USE englobe le droit d'opération sur l'objet, le droit de lecture et le droit d'exécution.

*ALL

Vous pouvez effectuer toutes les opérations sur le fichier en sortie, à l'exception de celles réservées au propriétaire ou de celles limitées par le droit de gestion de liste d'autorisation.

*EXCLUDE

Vous ne pouvez pas accéder au fichier en sortie.

nom-liste-autorisation

Indiquez le nom de la liste d'autorisation utilisée.

Exemples

Exemple 1 : impression d'enregistrements récapitulatifs uniquement

RUNQRY   QRY(LIBX/QRY1)  OUTTYPE(*PRINTER)
         OUTFORM(*SUMMARY)  COPIES(4)

Cette commande exécute l'analyse QRY1 située dans la bibliothèque LIBX. Le rapport qui est produit et imprimé contient uniquement des enregistrements récapitulatifs. Quatre copies du rapport sont imprimées.

Exemple 2 : exécution d'une analyse par défaut

RUNQRY   QRYFILE((LIBX/FILE2 *FIRST))
         OUTTYPE(*OUTFILE)  OUTFORM(*DETAIL)
         RCDSLT(*YES)  OUTFILE(LIB2/OUT1 MBR4 *NEWMBR)

Cette commande lance une analyse par défaut et extrait les données du premier élément du fichier FILE2 situé dans la bibliothèque LIBX. L'élément MBR4 est créé en tant que nouvel élément dans le fichier OUT1 de la bibliothèque LIB2. Il contient le résultat de l'analyse par défaut. L'écran de sélection d'enregistrements s'affiche pour vous permettre d'indiquer les enregistrements du fichier FILE2 de la bibliothèque LIBX qui doivent être écrits dans le nouvel élément MBR4 du fichier OUT1 de la bibliothèque LIB2. Le résultat contient uniquement les enregistrements de détail.

Messages d'erreur

Aucun