对 DB2 UDB z/OS 版版本 8 启用 DB2 Web Services Consumer UDF 和 DB2 XML Extender

本主题描述在使用“Web Service 用户定义的函数”向导来创建可以访问 Web Service 的操作的 DB2® 用户定义的函数(UDF)之前必须完成的一些任务。
必备软件:

DB2 通用数据库™ z/OS 版版本 8

DB2 Web Services Consumer UDF 包和 DB2 XML Extender 是随 DB2 通用数据库 z/OS 版版本 8 一起提供的。请遵循随这些包一起提供的指示信息来将它们安装在系统上。

IBM XML Toolkit for z/OS 库

C++ Edition 1.6 和 1.8

要启用 DB2 Web Services Consumer UDF 和 DB2 XML Extender:

  1. 为 XML Extender UDF 创建 WLM AE:
    1. 在 PROCLIB 中创建 WLM 启动过程。STEPLIB 并置应包含下列库:
      • XML Extender 装入库:hlq.SDXXLOAD
      • DB2 装入库:hlq.SDSNLOAD
      • IBM XML Toolkit for z/OS, C++ Edition 1.6 库:hlq.SIXMMOD1
    2. 为 DB2 Web Services Consumer UDF 创建 WLM 应用程序环境,并对此应用程序指定启动过程。 以下是一个样本 WLM 启动过程:
      //V81AWLM1 PROC  DB2SSN=V81A,NUMTCB=1,APPLENV=WLMENV1    
      //TCBNUM1  EXEC  PGM=DSNX9WLM,TIME=1440,                 
      //             PARM='&DB2SSN,&NUMTCB,&APPLENV',           
      //             REGION=0M                                 
      //STEPLIB   DD    DSN=USER.RUNLIB.LOAD,DISP=SHR          
      //          DD    DSN=CEE.SCEERUN,DISP=SHR               
      //          DD    DSN=USER.TESTLIB,DISP=SHR              
      //          DD    DSN=DB2A.UTLIB,DISP=SHR                
      //          DD    DSN=DB2A.TESTLIB,DISP=SHR              
      //*** XML EXTENDER LOAD LIB                              
      //          DD DSN=DSN810.DB2COMP.SDXXLOAD,DISP=SHR      
      //*** XML TOOLKIT 1.6 FOR XML EXTENDER                   
      //          DD DSN=DB2XML.XMLTK.V1R6.SIXMLOD1,DISP=SHR   
      //          DD    DSN=DB2A.SDSNLOAD,DISP=SHR             
      //          DD    DSN=CEEA.SCEERUN,DISP=SHR              
      //**SYSEXEC   DD    DSN=USER.PRIVATE.PROCLIB,DISP=SHR    
      //CEEDUMP   DD    SYSOUT=A   
  2. 为 SOAP UDF 创建 WLM AE:
    1. 在 PROCLIB 中创建 WLM 启动过程。STEPLIB 并置应包含下列库:
      • XML Extender 装入库:hlq.SDXXLOAD
      • DB2 装入库:hlq.SDSNLOAD
      • 辅助 DB2 装入库:hlq.SDSNLOD2
      • IBM XML Toolkit for z/OS, C++ Edition 1.8(使用了 XPLINK 的版本)库:hlq.SIXMMOD1
    2. 为 DB2 Web Services Consumer UDF 创建 WLM 应用程序环境,并对此应用程序指定启动过程。 以下是一个样本 WLM 启动过程:
      //V81AWLM1 PROC  DB2SSN=V81A,NUMTCB=1,APPLENV=WLMENV1    
      //TCBNUM1  EXEC  PGM=DSNX9WLM,TIME=1440,                 
      //             PARM='&DB2SSN,&NUMTCB,&APPLENV',           
      //             REGION=0M                                 
      //STEPLIB   DD    DSN=USER.RUNLIB.LOAD,DISP=SHR          
      //          DD    DSN=CEE.SCEERUN,DISP=SHR               
      //          DD    DSN=USER.TESTLIB,DISP=SHR              
      //          DD    DSN=DB2A.UTLIB,DISP=SHR                
      //          DD    DSN=DB2A.TESTLIB,DISP=SHR              
      //*** XML EXTENDER LOAD LIB                              
      //          DD DSN=DSN810.DB2COMP.SDXXLOAD,DISP=SHR      
      //*** XML TOOLKIT 1.6 FOR XML EXTENDER                   
      //          DD DSN=DB2XML.XMLTK.V1R6.SIXMLOD1,DISP=SHR   
      //          DD    DSN=DB2A.SDSNLOAD,DISP=SHR             
      //          DD    DSN=CEEA.SCEERUN,DISP=SHR              
      //**SYSEXEC   DD    DSN=USER.PRIVATE.PROCLIB,DISP=SHR    
      //CEEDUMP   DD    SYSOUT=A   
  3. 对 DB2 UDB z/OS 版版本 8 添加 XML Extender UDF。请遵循 SDSNSAMP 中定制作业 DXXGPREP 的作业序言中的建议。此作业将在安装后设置 XML Extender UDF。此作业的一部分复制相同内容。 可忽略下列警告:
    • 对于绑定,未定义过程
    • 对于 DBRM DSNCLIF4 绑定,未定义 SYSIBM.SYSLOCATIONS
  4. 对 DB2 UDB z/OS 版版本 8 添加新的 Web Services Consumer UDF。
    • 请遵循 SDSNSAMP 中定制作业 DSNTIJWL 的作业序言中的建议。此作业将在安装后执行链接编辑以创建 UDF 装入模块。
    • 请遵循 SDSNSAMP 中定制作业 DSNTIJWS 的作业序言中的建议。此作业将对 DB2 定义 UDF。
  5. 授予对 WLM 所使用的 DSNR 资源类的 RACF 许可权。 以下是一个样本 JCL:
    //* Add any other needed userids below                            
    //STEP2   EXEC PGM=IKJEFT01,DYNAMNBR=20                           
    //SYSPRINT DD SYSOUT=A                                            
    //SYSTSPRT  DD SYSOUT=*                                           
    //SYSTSIN  DD *                                           
    PERMIT  V81A.WLMENV.WLMENV1 CLASS(DSNR) ID(OEUSR01) ACCESS(READ)  
    PERMIT  V81A.WLMENV.WLMENV1 CLASS(DSNR) ID(OEDFLTU) ACCESS(READ)  
    PERMIT  V81A.WLMENV.WLMENV1 CLASS(DSNR) ID(SYSADM)  ACCESS(READ)  
    PERMIT  V81A.WLMENV.WLMENV1 CLASS(DSNR) ID(DB2XML) ACCESS(READ)   
    SETROPTS RACLIST(DSNR) REFRESH                                    
    PERMIT  V81A.BATCH          CLASS(DSNR) ID(OEUSR01) ACCESS(READ)  
    PERMIT  V81A.DIST           CLASS(DSNR) ID(OEUSR01) ACCESS(READ)  
    PERMIT  V81A.BATCH          CLASS(DSNR) ID(OEDFLTU) ACCESS(READ)  
    PERMIT  V81A.DIST           CLASS(DSNR) ID(OEDFLTU) ACCESS(READ)  
    //**                   
  6. 为将代表客户机来调用 UDF 的 Unix System Services 用户标识的用户授权。
    //GRANT    JOB ('DWB'),MARICHU,                           
    //         MSGCLASS=H,                                    
    //         MSGLEVEL=(1,1),                                
    //         TIME=NOLIMIT,                                  
    //         CLASS=A,                                       
    //         REGION=0K,                                     
    //         USER=SYSADM,PASSWORD=N1CETEST                  
    //GRANPL EXEC TSOBATCH,DB2LEV=DB2A,COND=(8,LT),REGION=5M  
    //SYSTSIN  DD *                                           
      DSN SYSTEM(V81A)                                        
      RUN  PROGRAM(DSNTEP2) PLAN(DSNTEP81)                    
      END                                                     
    //SYSIN    DD *                                           
       GRANT SYSADM TO OEUSR01;                               
       GRANT SYSADM TO OEDFLTU;                               
       GRANT SYSADM TO DB2XML;                                
    /*                      
现在,已经启用了 DB2 Web Services Consumer UDF 和 DB2 XML Extender,因此可以开始运行 Web Service UDF 向导了。
相关任务
启用 DB2 Web Services Consumer UDF 和 DB2 XML Extender
创建 DB2 用户定义的函数以访问 Web Service

反馈