STRQMPRC

La commande STRQMPRC (Démarrer une procédure QM) permet d'exécuter une procédure QM sauvegardée comme membre d'un fichier source.

Paramètres

Membre source (SRCMBR)

Indique le membre du fichier source contenant la procédure QM à exécuter.

Ce paramètre est obligatoire.

nom

Indiquez le nom du membre.

Fichier source (SRCFILE)

Indique le fichier source contenant la procédure QM à exécuter.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier source

QQMPRCSRC

Le fichier source IBM QQMPRCSRC est utilisé.

nom

Indiquez le nom du fichier source.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système effectue la recherche dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Base de données relationnelle (RDB)

Indique la base de données relationnelle utilisée lors du traitement de la commande.

*NONE

La base de données locale est utilisée. Si l'utilisateur est connecté à une base éloignée, la connexion locale est rétablie jusqu'à la fin du traitement de la commande.

*CURRENT

La base utilisée est la base de données relationnelle à laquelle l'utilisateur est connecté.

nom

Indiquez le nom de la base de données relationnelle à utiliser. Cette base doit être définie dans le répertoire des bases de données relationnelles.

Méthode de connexion (RDBCNNMTH)

Indique la méthode de connexion à utiliser.

*DUW

Les connexions à plusieurs bases de données relationnelles sont admises. L'exécution consécutive d'instructions CONNECT sur des bases de données relationnelles supplémentaires ne provoque pas l'arrêt des connexions précédentes.

*RUW

Une seule connexion à une base de données relationnelle peut être effectuée. L'exécution consécutive d'instructions CONNECT provoque l'arrêt des connexions précédentes avant l'établissement d'une nouvelle connexion.

Utilisateur (USER)

Indique le nom d'utilisateur envoyé au système éloigné lors du démarrage de la conversation.

*CURRENT

Le nom d'utilisateur associé au travail en cours est utilisé.

nom

Indiquez le nom d'utilisateur utilisé pour le travail demandeur d'application.

Mot de passe (PASSWORD)

Indique le mot de passe à utiliser sur le système éloigné.

*NONE

Aucun mot de passe n'est envoyé. Le nom d'utilisateur indiqué au paramètre USER est incorrect si cette valeur est précisée.

valeur-alphanumérique

Indiquez le mot de passe associé au nom d'utilisateur indiqué au paramètre USER.

Convention d'appellation (NAMING)

Indique la convention d'appellation utilisée pour les objets.

*SYS

La convention d'appellation système (nom/nom-objet) est utilisée.

*SQL

La convention d'appellation SQL (nom-base-de-données.nom-objet) est utilisée. Lorsque NAMING(*SQL) est indiqué, CMDSRCFILE(*LIBL) n'est pas admis et ne peut pas être précisé pour localiser l'un quelconque des objets indiqués dans d'autres paramètres de cette commande.

*SAA

La convention d'appellation SQL (nom-base-de-données.nom-objet) est utilisée. Lorsque NAMING(*SAA) est indiqué, CMDSRCFILE(*LIBL) n'est pas admis et ne peut pas être précisé pour localiser l'un quelconque des objets indiqués dans d'autres paramètres de cette commande.

Admettre infos de QRYDFN (ALWQRYDFN)

Indique si les informations relatives à la requête ou au format sont extraites d'un objet QRYDFN (définition d'analyse) lorsque aucun objet QMQRY (requête QM) ou QMFORM (format QM) ne peut être localisé à l'aide du nom d'objet indiqué. Toutes les informations ainsi dérivées sont supprimées une fois la commande CPI (Interface commune de programmation) de la procédure exécutée. Aucun objet QM n'est créé.

*NO

Les informations ne sont pas extraites d'un objet QRYDFN.

*YES

Les informations sont extraites d'un objet QRYDFN lorsque l'objet QMQRY or QMFORM indiqué n'est pas trouvé.

*ONLY

Des informations peuvent être dérivées uniquement d'un objet QRYDFN. Les objets QM sont ignorés.

Fichier de commandes source (CMDSRCFILE)

Indique le fichier de commandes source que la gestion de requêtes utilise pour exécuter une procédure de commandes. Cette dernière ne peut comporter que des commandes QM permettant de définir des variables d'application ou des variables QM qui commencent par 'DSQ'.

Les variables DSQ supportées sont les suivantes :

• DSQCMTLV
• DSQCONFIRM
• DSQOAUTH
• DSQSDBNM
• DSQSRUN

valeurs uniques

*NONE

Aucun fichier de commandes source n'est utilisé. Le paramètre CMDSRCMBR n'est pas pris en compte.

Qualificatif 1 : Fichier de commandes source

nom

Indiquez le nom du fichier de commandes source.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système effectue la recherche dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Membre source (CMDSRCMBR)

Indique le fichier de commandes source que la gestion de requêtes utilise pour exécuter une procédure de commandes. Cette dernière ne peut comporter que des commandes QM permettant de définir des variables qui commencent par 'DSQ'.

*FIRST

Le premier membre est utilisé.

nom

Indiquez le nom du membre de commandes source.

Affichage d'écrans (ALWDSPLAY)

Indique si des écrans de dialogue sont affichés ou non. La session QM passe en mode interactif si ALWDSPLAY(*YES) est indiqué, ou en mode par lots si vous précisez ALWDSPLAY(*NO). Dans un environnement de traitement par lots, le mode correspondant est automatiquement sélectionné.

*YES

Des écrans de dialogue sont affichés au cours de la session interactive. L'utilisateur peut ainsi intervenir sur le déroulement de la procédure.

*NO

Aucun écran de dialogue n'est affiché.

Exemples

Exemple 1 : Exécution d'une procédure de gestion de requête

STRQMPRC   SRCMBR(MYPROC)  SRCFILE(RPTLIB/PROCFILE)

Cette commande lance la procédure de gestion de requête stockée comme membre appelé MYPROC dans le fichier source PROCFILE de la bibliothèque RPTLIB.

Exemple 2 : Extraction d'informations d'objets QRYDFN

STRQMPRC   SRCMBR(MYPROC)  SRCFILE(PROCFILE)
           ALWQRYDFN(*YES)  ALWDSPLAY(*NO)

Cette commande lance la procédure de gestion de requête stockée comme membre appelé MYPROC dans le premier fichier appelé PROCFILE de la liste des bibliothèques de ce travail. Les données de formulaire et de requête peuvent être extraites, au besoin, des objets QRYDFN lorsque les instructions de procédure sont traitées. Aucun rapport n'est affiché mais ils peuvent être imprimés si l'utilisateur indique une requête d'impression. Les objets sont remplacés sans confirmation si l'utilisateur ne la requiert pas. La procédure prend fin avec des erreurs si le traitement repère une variable globale qui n'est pas définie ou si la confirmation a été requise avant de remplacer des objets qui existent déjà.

Messages d'erreur

Messages *ESCAPE

QWM2701

La commande &1 a échoué.

QWM2703

La commande &1 a été interrompue.

QWM2707

*LIBL non admis avec la convention d'appellation SQL.

QWM2709

Utilisateur ou mot de passe incompatible avec valeur BD relationnelle.

QWM2710

Mot de passe *NONE admis uniquement avec utilisateur *CURRENT.

QWM2712

Caractère incorrect dans le nom d'utilisateur.