Personnalisation du mappage SQLCODE
Par défaut, DB2 Connect mappe les SQLCODE et les jetons de chaque serveur de
base données grand système IBM vers les SQLCODE DB2 appropriés. Les fichiers
suivants sont des copies du mappage SQLCODE par défaut :
v dcs1dsn.map mappe les SQLCODE DB2 for z/OS.
v dcs1ari.map mappe les SQLCODE DB2 Server for VM and VSE.
v dcs1qsq.map mappe les SQLCODE DB2 for IBM i.
Aucun mappage n'est nécessaire pour DB2 sur les systèmes d'exploitation Linux ou
UNIX.
1. Si vous désirez remplacer le mappage SQLCODE par défaut ou si vous utilisez
un serveur de base de données grand système IBM dépourvu de mappage
SQLCODE (un serveur de base de données non IBM), vous pouvez copier l'un
de ces fichiers et l'utiliser comme base pour votre nouveau fichier de mappage
SQLCODE. En procédant à la copie du fichier au lieu de l'éditer directement,
vous êtes ainsi assuré de toujours pouvoir vous référer au mappage SQLCODE
original, en cas de besoin.
2. Spécifiez le nom de fichier de votre nouveau fichier de mappage SQLCODE
dans la chaîne de paramètres du répertoire DCS.
3. Chaque fichier de mappage est un fichier ASCII créé et édité à l'aide d'un
éditeur ASCII. Lors de l'installation initiale, le fichier est stocké dans le
répertoire map du chemin d'installation.
Le fichier peut contenir les types de ligne spéciaux suivants :
&&
Le début logique d'un fichier. Toutes les lignes situées avant cette
première occurrence && sont considérées comme des commentaires à
format libre et sont ignorées. Si le fichier est vide après les &&, aucun
mappage SQLCODE ne sera effectué. Vous pouvez également
désactiver le mappage SQLCODE à l'aide du paramètre NOMAP,
comme indiqué précédemment.
*
Quand il s'agit du premier caractère d'une ligne, il indique qu'il s'agit
d'un commentaire.
W
Lorsqu'il s'agit du seul caractère indiqué dans une ligne, il indique que
les options d'avertissement doivent à nouveau être mappées. Par
défaut, les options d'avertissement d'origine sont transmises. Le W doit
être écrit en majuscule.
Toutes les lignes situées après les && doivent être vides ou des instructions de
mappage qui ont la forme suivante :
code_entrée
[, code_sortie [, liste_jeton]]
Le code_entrée représente l'un des codes suivants :
sqlcode SQLCODE du serveur de base de données grand système IBM.
Tous les SQLCODE négatifs non définis (ceux qui ne sont pas
U
répertoriés dans ce fichier) sont mappés au code_sortie spécifié. Si aucun
code_sortie n'est spécifié sur cette ligne, le SQLCODE original est utilisé.
Ce caractère doit être indiqué en majuscule.
P
Tous les SQLCODE positifs non définis (ceux qui ne sont pas
répertoriés dans ce fichier) sont mappés au code_sortie spécifié. Si aucun
code_sortie n'est spécifié sur cette ligne, le SQLCODE original est utilisé.
Ce caractère doit être indiqué en majuscule.
Chapitre 2. Référence pour DB2 Connect
55