DB2 Report Broker

DB2 Report Broker est une fonction de DB2 Web QUERY permettant de gérer :

• le traitement asynchrone de requêtes trop "gourmandes"
• la planification de rapports
• la distribution de rapports

Utiliser l'option Report Broker

lancez la console depuis QWQADMIN par "Administration/Console d'administration"

Ensuite à l'aide de l'option "Configuration", paramétrez le produit

particulièrement le serveur de messagerie à utiliser pour les envois de mail

(mettez ici, les mêmes pages de code que le serveur d'application)

Les autres options permettent

• de voir si Report Broker est démarré
• de le démarrer le cas échéant
    en mode commande utilisez STRWEBQRY START(*DSTSRV)
• de lancer une trace

Ensuite lancez la console Report Broker dans Outils/Console Report Broker

Vérifiez que le serveur est démarré

Les options proposées

• État des travaux
    Supervision des tâches en cours
• Journaux des tâches
    Historique
• Dates d'interruption
    personnalisation du calendrier
• Gestion de changement
    transfert de données web broker (planning et liste de distribution) entre environnements
• Mise à jour globale
    lancement d'une mise à jour (adresse mail modifiée, par exemple) sur l'ensemble des tâches

Commençons par planifier une tâche (ceci peut aussi être fait directement sur un rapport)

re-loggez vous avec un profil "normal" , puis sur un rapport

Allez dans "Planification" et choisissez une destination

• Email
  -> Envoi par mail à un ou plusieurs destinataires
  
  
• FTP
  -> placement par FTP sur un serveur
  
  
• Imprimante
  -> impression
  
  
• DB2 Web Query
  -> placement dans un dossier local (pour consultation du résultat)
  
  
  

Vous pouvez aussi préciser :

• des valeurs pour les paramètres en entrée du rapport (Paramètres)
• le format de sortie (Format du rapport)
  • Html, Ahtml, archive html (.mht)
  • PDF, PDF actif
  • Postscript
  • Excel
  • Doc
  • Flash (flex), Flash Actif
  • etc ...

Répétition affiche le planning

indiquez l'intervalle

• une fois, soumission de la tâche, sans répétition.
• toutes les n minutes.
• toutes les n heures.
• tous les jours à une certaine heure.
• toutes les semaines à un ou plusieurs jours.
• tous les ans à une date donnée.
• personnalisé : à certaines dates (le 15 Avril ET le 1er septembre, par exemple).

Tous les jours à 20h00 :

la liste déroulante à droite de la date, permet de faire apparaître un calendrier

la case à cocher "Répéter le planning tous les" permet d'avoir plusieurs exécutions à partir de 20h00

Toutes les semaines (ici le Mardi à 10h03) :

Suivant la destination (Distribution)

• email
  • individuelle
  • liste de distribution
• Imprimante (pour le format Postscript)
• DB2 Web Query (placement dans un dossier de DB2 Web Query)

Distribution par mail

Serveur FTP


Le bouton Serveur FTP (haut à droite) permet de paramétrer la connexion
     

Distribution dans un dossier

Notification permet d'avoir un retour suite à l'exécution d'une tâche

• Jamais
• Toujours
• En cas d'erreur

N'oubliez pas d'indiquer une description, puis cliquez sur Enregistrer

-> La tâche, une fois enregistrée peux aussi être exécutée par commande CL : RUNBRSCHED

Liste de distribution

La liste peut être

• public (utilisable par tous)
• privée (utilisable par le créateur uniquement)

Elle peut contenir

• une série d'adresse mail
• une série de serveur FTP
• une série de nom d'imprimante
  
  

Adresse mail :

• vous pouvez indiquer une adresse mail par ligne (envoi de plusieurs mails à destinataire unique)

• plusieurs adresse mails séparées par , ou ; (envoi d'un seul mail à destinataires multiples)

• enfin vous pouvez indiquer une valeur segmentée, il s'agit d'une valeur de rupture (Burst en angl.)

• La zone de tri vertical dans un rapport
• la zone de changement de graphe
  
  (mot-clé BY dans le code source)
  
  Par exemple, pour une rupture par département
  
  
  • 44 -> michel@entreprise.com
  • 75 -> sophie@entreprise.com
  • 31 -> khadija@entreprise.com
  • etc....

-> provoquera un rapport par département, envoyé aux personnes concernées.

Vous avez le droit à des caractères "joker" comme

• * est toujours vrai (outt élement)
• ? replace un caractère 4? est vrai piuyr 41,42,43, ...
• \ est un caractère d'échapement pour * et ?

• Avec le niveau de correctif de Juillet 2015 (version 2.10 et2.11), vous pouvez faire appel à une procédure stockée
  
  
  
  • pour une liste de destinataires qui retourne un série de valeurs ->DEST CHAR(50)
    
    Indiquez DYNLIST SQLPROC = BIB/PROC1
    
    
    
    
  • pour des valeurs segmentées, qui retourne deux champs
    • VALUE CHAR(30) pour le segment, '  ' = tout segment (comme * avec une liste statique)
    • DEST CHAR(50) pour le destinataire
      
      

  Indiquez DYNBURST SQLPROC = BIB/PROC2
  
  
  
  Exemple de procédure segmentée

  CREATE PROCEDURE QGPL.RTVDESTSEG( ) RESULT SETS 1 LANGUAGE SQL SPECIFIC RTVDESTSEG P1: BEGIN DECLARE C1 CURSOR WITH RETURN FOR SELECT CAST(DEPART AS CHAR(30)) AS VALUE , EMAIL AS DEST FROM GESCOM.GESTIONAIR; OPEN C1; END P1 --ensuite rendez QWQADMIN propriétaire de la procédure

  
  

Historique d'exécutions (retournez à la console Report Broker)

Administration

• Gestion des changements : répercussion d'un paramétrage vers un autre serveur (Test vers Prod, par ex.)
  
  Vous devez faire cette action sur le système cible (la Prod) en indiquant la source (le système de Test)
  
  
  
• Changement global : modification d'une valeur dans les tables de DB2 Web Broker (mail, serveur smtp, propriétaire)
  
  
  Par exemple, ici, un utilisateur a changé d'adresse mail.