QAQQINI: Modifier les attributs de requête en V4R4

BoTTom |    Changer de couleur
 
il est possible de modifier les attributs des requêtes à venir dans une
 session interactive par la commande CHGQRYA.
 
mais cela est difficile en batch, en client serveur, etc...
 
La V4R40 apporte une solution par le biais d'un fichier QAQQINI.
 
ce fichier est fourni dans la bibliothèque QSYS, mais vous devez
  dupliquer ce fichier dans votre biblitohèque base de données.
 
CRTDUPOBJ OBJ(QAQQINI) FROMLIB(QSYS) OBJTYPE(*FILE) TOLIB(ma-bib)
 DATA(*YES) [il faut dupliquer car il y a un trigger d'associé]
 
puis vous indiquez la version du fichier à utiliser par CHGQRYA
 
 CHGQRYA  QRYOPTLIB(ma-bib)  QUSRSYS par défaut.
 
ce fichier est structuré comme suit :
  QQPARM CHAR(256)       le paramètre à modifier
  QQVAL  CHAR(256)       la valeur à attribuer
  QQTEXT CHAR(1000)      commentaire


|    Changer de couleur
 
 +---------------------------------+--------------------------------------+
 ! paramètre (QQPARM)              ! valeurs possibles (QQVAL)            !
 +---------------------------------+--------------------------------------+
 !                                 !                                      !
 ! MESSAGES_DEBUG                  ! *YES | *NO                           !
 !                                 !                                      !
 !                                 ! affiche dans la log les messages de  !
 !                                 ! l'optimiseur (comme avec STRDBG)     !
 !                                 !                                      !
 !---------------------------------!--------------------------------------!
 ! QUERY_TIME_LIMIT                ! *NOMAX | *SYSVAL | nb-de-secondes    !
 !                                 !                                      !
 !                                 ! temps maxi de requête admis          !
 !                                 !                                      !
 !---------------------------------!--------------------------------------!
 ! PARALLEL_DEGRE                  ! *NONE| *SYSVAL| *IO| *OPTIMIZE| *MAX !
 !                                 !                                      !
 !                                 ! traitement parallèle(voir QQRYDEGREE)!
 !                                 !                                      !
 !------------------------------------------------------------------------!
 


|    Changer de couleur
 
 +---------------------------------+--------------------------------------+
 ! FORCE_JOIN_ORDER                ! *YES | *NO                           !
 !                                 !                                      !
 !                                 ! avant la V4R40, lors d'un :          !
 !                                 !  select * from                       !
 !                                 !   fichera inner join ficherb         !
 !                                 ! l'optimiseur réalisait votre jointure!
 !                                 ! selon l'ordre d'écriture.            !
 !                                 !                                      !
 !                                 ! maintenant il réalise la jointure    !
 !                                 !  selon l'ordre qui lui semble le plus!
 !                                 !  efficace sauf à mettre *YES dans    !
 !                                 !  ce paramètre.                       !
 +---------------------------------+--------------------------------------+
 ! PARAMETER_MARKER_CONVERSION     ! *YES | *NO                           !
 !                                 !                                      !
 !                                 ! indique si l'optimiseur transforme   !
 ! ce paramètre n'est lu qu'une    !  vos constantes en paramètres comme  !
 !  fois en début de job           !  variables [représentés par ?]       !
 !---------------------------------!--------------------------------------!
 


|    Changer de couleur
 
 +---------------------------------+--------------------------------------+
 ! OPTIMIZE_STATISTIC_LIMITATION   ! *DEFAULT | *NO | *PERCENTAGE pp      !
 !                                 ! *MAX_NUMBER_OF_RECORD_ALLOWED mm     !
 !                                 !                                      !
 !                                 ! autorisez vous l'optimiseur à        !
 !                                 !  collecter des statistiques sur les- !
 !                                 !  index examinés.                     !
 !                                 ! ces collectes peuvent être           !
 !                                 !  pénalisantes sur des grosses tables.!
 !                                 !                                      !
 !                                 ! *NO , vous n'autorisez pas.          !
 !                                 ! *PERCENTAGE pourcentage de l'index   !
 ! ce paramètre était avant        !              à examiner              !
 !  implémenté sous forme d'une    ! *MAX_NUM... nombre de lignes maxi    !
 !  data area QQQOPTIONS                          de la table pour accord !
 +---------------------------------+--------------------------------------+
 ! UDF_TIMEOUT                     ! *MAX | nb-secondes                   !
 !                                 !                                      !
 ! (abandonné en V5)               ! indique le temps maxi d'exécution    !
 !                                 !  d'une fonction.                     !
 +---------------------------------!------------------------------------- !


|    Changer de couleur
 
 +---------------------------------+--------------------------------------+
 ! APPLY_REMOTE                    ! *NO | *YES                           !
 !                                 !                                      !
 !                                 ! ces paramètres s'appliquent-ils      !
 !                                 !  localement(dft) ou sur la base      !
 !                                 !  éloignée (DRDA)                     !
 +---------------------------------+--------------------------------------+
 ! ASYNC_JOB_USAGE                 ! *LOCAL | *NONE |*ANY | *REMOTE       !
 !                                 !                                      !
 !                                 ! indique si des jobs asynchrones      !
 !                                 !  peuvent être utilisés               !
 +---------------------------------!------------------------------------- !
 ! FULL_DEPTH_ESTIMATE             ! *YES | *NO                           !
 !                                 !                                      !
 !                                 ! *NO indique que l'on doit rester sur !
 !                                 !  les premiers noeuds de l'index lors !
 !                                 !  des sondages(plus rapides, mais     !
 !                                 !  moins exacts), *YES on fait des son-!
 !                                 !  dages sur la totalité de l'index.   !
 +---------------------------------+--------------------------------------+
 


|    Changer de couleur
 
 +---------------------------------+--------------------------------------+
 ! COMMIT_CONTROL_LOCK_LIMIT       ! *DEFAULT | un nbr entre 1/500.000.000!
 !                                 !                                      !
 !                                 ! indiaque le nombre maximal de lignes !
 !                                 !  pouvent être verrouillées pendant   !
 !                                 !  une transaction.                    !
 +---------------------------------+--------------------------------------+
 ! OPEN_CURSOR_THRESOLD            ! *DEFAULT (=0)| un nbr                !
 !                                 !                                      !
 !                                 ! nombre de curseur maxi fermés en     !
 !                                 !  "pseudo close"                      !
 !                                 ! pas de vrai fermeture lors d'un CLOSE!
 +---------------------------------!------------------------------------- !
 ! OPEN_CURSOR_CLOSE_COUNT         ! *DEFAULT (=0) | un nbr               !
 !                                 !                                      !
 !                                 ! nombre de curseurs à fermer vraiement!
 !                                 !  (hard-close) lors que le seuil pré- !
 !                                 !  cédent est atteint.                 !
 !                                 !  (le nombre doit être inférieur au   !
 !                                 !    seuil d'alerte).                  !
 +---------------------------------+--------------------------------------+


|    Changer de couleur
 
 +---------------------------------+--------------------------------------+
 ! OPTIMIZATION_GOAL               ! *DEFAULT | *FIRSTIO | *ALLIO         !
 !                                 !                                      !
 !                                 ! objectif d'optimisation.             !
 !                                 !                                      !
 !                                 !  *DEFAULT : respecter la clause      !
 !                                 !             Optimize For xx Rows     !
 !                                 !                                      !
 !                                 !  *FIRSTIO : réaliser le plus rapide- !
 !                                 !   ment possible la première IO       !
 !                                 !                                      !
 !                                 !  *ALLIO : privilégier le temps de    !
 !                                 !   traitement global.                 !
 +---------------------------------!------------------------------------- !
 ! REOPTIMIZE_ACCESS_PLAN          ! *NO | *YES | *FORCE | *ONLY_REQUIRED !
 !                                 !                                      !
 !                                 !  faut-il forcer la reconstruction    !
 !                                 !  du plan d'accès.                    !
 !                                 !  (par défaut, seulement si c'est     !
 !                                 !    obligatoire).                     !
 +---------------------------------+--------------------------------------+


|    Changer de couleur
 
 
 de nouveaux paramètres peuvent arriver en cours de version, via PTF.
 
 exemple d'utilisation
 
 Update QGPL/QAQQINI set QQVAL = '*YES'
 
                     where QQPARM = 'MESSAGES_DEBUG'
 
 
 
 Operation navigator (Client Access Express)
 
   vous offre une interface graphique de gestion de ces paramètres
 
 
 
 1/ choisissez l'option base de données
 
 
 2/ cliquez avec le bouton droit, puis "modification attributs de requêtes"


|    Changer de couleur
 
 
 3/ indiquez    -le/les job(s) concerné(s)
 
                -la bibliothèque où se trouve le fichier QAQQINI
 
                -Operation navigator vous affiche le contenu du fichier
 
 







©AF400