Exemple de travail JCL : AOCDDL

Vous pouvez utiliser un exemple de travail JCL AOCDDL pour activer des fonctions d'optimisation des requêtes avancées sur un sous-système sous-système DB2 for z/OS.

Les exemples de travail JCL AOCDDL sont extraits sur le sous-système DB2 lorsque vous effectuez l'installation de bande magnétique SMP/E. Vous pouvez également les trouver dans le sous-répertoire \serverconfig\ZOS\numéro_version_et_mode_z/OS du répertoire d'installation du client sur le système client.

Six versions de l'exemple de travail AOCDDL sont disponibles :

Sous-système Fichier de travail JCL
DB2 Version 10 for z/OS mode nouvelle fonction AOCDDL10
DB2 Version 10 for z/OS mode de conversion à partir de la version 9 AOCDDLX9
DB2 Version 10 for z/OS mode de conversion à partir de la version 8 AOCDDLX8
DB2 Version 9.1 for z/OS AOCDDL9
DB2 for z/OS Version 8 mode nouvelle fonction AOCDDL8N
DB2 for z/OS Version 8 mode de compatibilité AOCDDL8C

L'exemple suivant illustre le prologue de l'exemple de travail AOCDDL pour les sous-systèmes DB2 Version 9.1 for z/OS.

//*********************************************************************
//*  Nom = AOCDDL
//*
//*  Nom descriptif =
//*    DB2 Installation Job Stream
//*
//*     Eléments sous licence - Propriété d'IBM
//*     5655-V81
//*     COPYRIGHT 2010 IBM Corp.  All Rights Reserved.
//*
//*     STATUT = Version 9
//*
//*  Fonction = Création d'objets requis par IBM Optim Query
//*             Tuner (QT)
//*
//*  Pseudocode =
//*    Etape     AOCICU   Supprimer les routines, la base de données et
//*                       le groupe de stockage QT (facultatif)
//*    Etape     AOCIAS   Créer les groupes de stockage et bases de données QT
//*    Etape     AOCEXP   Créer des modèles d'objets explain pour un utilisateur spécifique
//*                       (la valeur par défaut est SYSADM). Permet de modifier, effectuer
//*                       une modification de SYSADM vers l'ID souhaité.
//*                       Cette étape comporte deux espaces table LOB,
//*                          AOCULTS1 et AOCULTS2
//*                       qui doivent être uniques pour chaque utilisateur. Modifiez le
//*                       nom pour vous assurer qu'il est unique.
//*    Etape     AOCAPCSA Créer des objets de profil QT SA et
//*                       des objets de comparaison de plan
//*    Etape     AOCTPRO  Créer des objets de profil OQT
//*    Etape     AOCWCC   Créer des objets QT WCC
//*    Etape     AOCWSA   Créer des objets QT WSA
//*    Etape     AOCWIA   Créer des objets QT WIA
//*    Etape     AOCWQA   Créer des objets QT WQA
//*    Etape     AOCBIND  Lier des modules QT
//*    Etape     AOCTJRT  Créer le fichier d'options d'environnement LE pour
//*                       l'environnement WLM utilisé pour exécuter la procédure mémorisée
//*                       SYSPROC.OPT_EXECUTE_TASK
//*    Etape     AOCGRT   Accorder l'accès à des objets créés par ce travail,
//*                       ajouter l'accès au module
//*
//*
//*  Dépendances =
//*
//*  Remarques =
//*    AVANT D'EXECUTER CE TRAVAIL, personnalisez-le sur votre système :
//*    (1) Ajoutez une carte de travail valide
//*    (2) Localisez et modifiez toutes les occurrences des chaînes suivantes,
//*        comme suit :
//*        (A) Remplacer le nom de sous-système '!DSN!' par le nom de votre DB2
//*        (B) Remplacer 'DSNTIA!!' par le nom de plan de DSNTIAD sur votre DB2
//*        (C) Remplacer 'DSNC!!0' par le VCAT des espaces table QT
//*        (D) Remplacer '!DSNV01!' par l'ID de série du volume pour la base de données QT
//*        (E) Remplacer 'DSN!!0' par le préfixe de la bibliothèque cible de DB2
//*        (F) Remplacer '!AOCPREFX!' par le préfixe de la bibliothèque cible de QT
//*        (G) Remplacer '!USERID!' par l'ID UTILISATEUR qui accorde une autorisation aux modules.
//*    (3) Consultez et éventuellement mettez à jour les paramètres du pool de mémoire tampon dans les
//*        instructions CREATE DATABASE et TABLESPACE traitées par
//*        ce travail.
//*    (4) Consultez et éventuellement mettez à jour les noms d'environnement WLM
//*        spécifiés dans les instructions CREATE PROCEDURE traitées
//*        par les étapes du travail AOCBIND.
//*    (5) Dans l'étape de travail AOCTJRT, consultez et éventuellement mettez à jour le nom
//*        du fichier comportant les options d'environnement LE pour les
//*        procédures mémorisées SYSPROC.OPT_EXECUTE_TASK et.
//*        Ce fichier doit être attribué
//*        par la définition de données JAVAENV de la procédure d'espace adresse pour
//*        l'environnement WLM pour l'exécution de SYSPROC.OPT_EXECUTE_TASK.
//*        Voir ci-dessous pour un exemple de la
//*        procédure d'espace adresse et de sa personnalisation pour votre site.
//*        Dans l'étape AOCTJRT, consultez et éventuellement mettez à jour
//*        les chemins java suivants :
//*            (a) CLASSPATH est le chemin dans lequel le fichier JAR
//*                de la procédure mémorisée Java est placé.
//*                  Exemple : /usr/lpp/db2910_base/classes/
//*            (b) JCC_HOME est le chemin d'accès au pilote jcc.
//*
//*                  Exemple : /usr/lpp/db2910_jdbc
//*            (c) JAVA_HOME est le chemin d'accès au JDK.
//*                  Exemple : /usr/lpp/java140/J1.4
//*    (6) Dans l'étape de travail AOCGRT, consultez et éventuellement mettez à jour
//*        les instructions GRANT conformément aux règles d'autorisation appliquées
//*        sur votre site.  Remarques particulières :
//*        - Dans l'instruction GRANT EXCECUTE de SYSPROC.OPT_RUNSQL,
//*          remplacez !GRANTEE! par un ou plusieurs identificateurs utilisateur qui
//*          ont besoin d'utiliser des procédures mémorisées afin de fermer toutes les instructions
//*          dans le cache d'instruction dynamique et de capturer des charges de travail
//*          à partir du cache d'instruction dynamique.
//*
//*    L'exemple suivant illustre une procédure JCL pour l'espace adresse de
//*    l'environnement WLM nécessaire pour exécuter les procédures mémorisées
//*    SYSPROC.OPT_EXECUTE_TASK :
//*
//*    //procName PROC  DB2SSN=ssnm,NUMTCB=1,APPLENV=wlmEnvName
//*    //TCBNUM1  EXEC  PGM=DSNX9WLM,TIME=1440,
//*    //             PARM='&DB2SSN,&NUMTCB,&APPLENV', 
//*    //             REGION=0M 
//*    //STEPLIB   DD DISP=SHR,DSN=ceepre.SCEERUN   <- LE runtime lib 
//*    //          DD DISP=SHR,DSN=dsnpre.SDSNEXIT  <- DB2 exit lib 
//*    //          DD DISP=SHR,DSN=dsnpre.SDSNLOAD  <- DB2 runtime lib 
//*    //          DD DISP=SHR,DSN=dsnpre.SDSNLOD2  <- JDBC/SQLJ DLL lib 
//*    //JAVAENV   DD DISP=SHR,DSN=prefix.JSPENV    <- JSP runtime opts 
//*    //JSPDEBUG  DD SYSOUT=A                      <- debugging output 
//*    //CEEDUMP   DD SYSOUT=A                      <- LE dump output 
//*    //SYSPRINT  DD SYSOUT=A                      <- diagnostics 
//*    //JAVAOUT   DD pathname                      <- output file path 
//*    //JAVAERR   DD pathname                      <- error file path 
//* 
//*    où : 
//*    - wlmEnvName est le nom de l'environnement WLM où exécuter 
//*      SYSPROC.OPT_EXECUTE_TASK 
//*    - procName est le nom de la procédure associée à l'env WLM 
//*    - ssnm est le nom du sous-système DB2 
//*    - NUMTCB doit être défini sur 1 
//*    - ceepre est le préfixe de la bibliothèque d'exécution 
//*      IBM Language Environment (LE). 
//*    - dsnpre est le préfixe de vos bibliothèques d'exécution DB2 for z/OS 
//*    - prefix.JSPENV indique le fichier contenant les options d'exécution LE 
//*      pour l'exécution des procédures mémorisées SYSPROC.OPT_EXECUTE_-
//*      TASK. Ce fichier est créé à l'étape de travail 
//*      AOCGRT. Pour plus d'informations sur la définition de données JAVAENV, consultez 
//*      le manuel DB2 for z/OS Application Programming Guide and Reference 
//*      for Java. 
//*    - JAVAOUT et JAVAERR spécifient un chemin pour les fichiers de sortie des 
//*      procédures mémorisées Java.  Vous pouvez indiquer un emplacement 
//*      disponible où DB2 possède un droit en écriture sur les fichiers de sortie 
//*      et où un utilisateur DB2 peut lire ces fichiers de sortie.  Utilisez 
//*      la commande des services système UNIX 
//*        chmod -R +rw pathname 
//*      pour ajouter les privilèges d'écriture requis. 
//* 

Commentaires