Aller au contenu

Service SQL IBM i (AS/400) · Procédure

SYSPROC.WLM_SET_CLIENT_INFO

Renseigner les informations client d'une connexion

Procédure qui définit les registres spéciaux client de la connexion courante (utilisateur, poste, application, comptabilisation, programme) pour mieux identifier les travaux SQL.

À quoi ça sert

SYSPROC.WLM_SET_CLIENT_INFO modifie les valeurs des registres spéciaux client de la connexion en cours : CLIENT_USERID, CLIENT_WRKSTNNAME, CLIENT_APPLNAME, CLIENT_ACCTSTR et CLIENT_PROGRAMID. Chaque paramètre vaut NULL par défaut. Le paramètre VERBOSE (mode détaillé) vaut 'YES' par défaut.

Cela sert à marquer les connexions : une application Java, PHP ou ODBC peut indiquer qui elle est, depuis quel poste et pour quel programme. L'exploitant retrouve ensuite plus facilement l'origine d'un travail SQL qui consomme beaucoup de ressources.

La procédure ne change que le contexte de la connexion courante. Elle n'a pas de mode aperçu (PREVIEW).

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

CALL SYSPROC.WLM_SET_CLIENT_INFO('DUPONT', 'poste-compta-12', 'Facturation', 'Service comptable', 'FACT001');
VALUES (CURRENT CLIENT_USERID, CURRENT CLIENT_WRKSTNNAME, CURRENT CLIENT_APPLNAME, CURRENT CLIENT_ACCTNG, CURRENT CLIENT_PROGRAMID)

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

00001 00002 00003 00004 00005
DUPONT poste-compta-12 Facturation Service comptable FACT001

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

Marquer les valeurs des registres spéciaux client pour une connexion.

-- Description: Brand the client special register values for a connection 
 CALL SYSPROC.WLM_SET_CLIENT_INFO('db2user','machine.rchland.ibm.com','auditor', 
    'Accounting department', 'MYPGM');

Paramètres

ParamètreTypePar défautSignification
CLIENT_USERID VARCHAR(255) NULL Identifiant utilisateur du client
CLIENT_WRKSTNNAME VARCHAR(255) NULL Nom du poste de travail client
CLIENT_APPLNAME VARCHAR(255) NULL Nom de l'application cliente
CLIENT_ACCTSTR VARCHAR(255) NULL Chaîne de comptabilisation du client
CLIENT_PROGRAMID VARCHAR(255) NULL Identifiant du programme client
VERBOSE VARCHAR(3) 'YES' Mode détaillé