QSYS2.OVERRIDE_QAQQINI

À quoi ça sert

Cette procédure modifie, pour le travail en cours, les options de l'optimiseur normalement lues dans le fichier QAQQINI. Elle ne change pas le fichier : la substitution disparaît avec le travail.

Le paramètre OVERRIDE_OPTION choisit l'opération. L'exemple d'IBM l'appelle avec 1 pour établir la substitution temporaire (les valeurs courantes du travail servent de valeurs initiales), puis avec 2, un nom d'option (OPTION_NAME) et une valeur (OPTION_VALUE) pour modifier une option, par exemple UDF_TIME_OUT à *MAX.

C'est l'équivalent SQL d'un réglage ponctuel qu'on ferait avec CHGQRYA, sans toucher aux autres travaux.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

CALL QSYS2.OVERRIDE_QAQQINI(1, '', '');
CALL QSYS2.OVERRIDE_QAQQINI(2, 'UDF_TIME_OUT', '*MAX');
SELECT QQPARM, QQVAL FROM QTEMP.QAQQINI WHERE QQPARM IN ('UDF_TIME_OUT', 'QUERY_TIME_LIMIT', 'PARALLEL_DEGREE')

Ce que l'IBM i a renvoyé le 01/10/2026 (3 lignes au plus) :

Données anonymisées : les noms de système, de profils, de bibliothèques, de postes et les adresses IP ont été remplacés. Les objets du schéma JOBISQL sont des objets de démonstration créés pour ce site.

L'exemple d'IBM

Établir la substitution temporaire de QAQQINI, puis substituer temporairement l'option de délai d'expiration des fonctions utilisateur (UDF_TIME_OUT).

-- Description: Establish the temporary override for QAQQINI. 
 -- The current QAQQINI values for the job will be used as the initial values. 
 CALL QSYS2.OVERRIDE_QAQQINI(1, '', ''); 
    -- Description: Temporarily override the UDF timeout QAQQINI option. 
 CALL QSYS2.OVERRIDE_QAQQINI(2, 'UDF_TIME_OUT', '*MAX');

Paramètres