IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice
IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice
IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Using <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> SQL Stages <strong>for</strong> Access to DB2<br />
334 <strong>Programming</strong>: <strong>Pipes</strong><br />
SUBSYSTEM=DB2<br />
The SUBSYSTEM definition identifies which DB2 is the <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong><br />
default. The DB2ACESS definition sets which DB2 interface is used <strong>for</strong> the <strong>Tivoli</strong><br />
<strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> program unless the DB2SEC statement in the CNMSTYLE<br />
member is set to RRS or CAF. In either case, the setting is applied the first time<br />
either definition is processed, and the interface is not changed while the <strong>Tivoli</strong><br />
<strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> program is running.<br />
v The <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> SQL stage must be defined to DB2. The <strong>Tivoli</strong><br />
<strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> SQL stage is defined once in a process called binding the<br />
plan. Sample CNMSJSQL contains a sample installation job to per<strong>for</strong>m this<br />
process. In the following sample job, the name of the library on the SYSUT2 JCL<br />
statement must match the name specified in the BIND statement in the second<br />
step of the job. The sample uses the name USER2.DBRMLIB, which you can<br />
modify to suit your system:<br />
//SYSUT2 DD DSN=USER2.DBRMLIB(DSISQLDO),DISP=SHR<br />
The following sample shows the BIND statement:<br />
BIND PACKAGE(DSISQL04) MEM (DSISQLDO) ACT(REF) -<br />
ISOLATION(CS) LIB(’USER2.DBRMLIB’) OWNER(USER2)<br />
BIND PACKAGE(DSISQL14) MEM(DSISQLDP) ACT(REF) -<br />
ISOLATION(CS) LIB(’USER2.DBRMLIB’) OWNER(USER2)<br />
BIND PLAN(DSISQL04) ACT(REF) -<br />
PKLIST(DB2L01.DSISQL04.DSISQLDO,DB2l01.DSISQL14.DS<br />
ISQLDP) ISOLATION(CS) OWNER(USER2)<br />
DSISQL04, DSISQLDO and DSISQLDP are <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> names that do not<br />
change. Change <strong>IBM</strong>USER to a value suitable to your installation to identify the<br />
<strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> system that is using SQL. In general, the <strong>Tivoli</strong><br />
<strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> plan name is DSISQLnn where nn is changed because of<br />
service or future releases. The CNMSJSQL sample is reshipped when a change to<br />
the DSISQLDO and DSISQLDP programs causes the plan to be incompatible.<br />
To run CNMSJSQL, the job user ID must have BINDADD privilege.<br />
v The <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> job must access DB2 load libraries. Sample<br />
CNMSJ009 contains comments, in the STEPLIB DD statements, to help you<br />
modify your production procedure.<br />
v If you use Distributed Relational Database Access (DRDA ® ), ensure that all other<br />
systems know about <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> SQL stages. Unload the plan from<br />
the system where you have installed <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> SQL stages and<br />
bind it to the other systems.<br />
v You must be registered as a DB2 user to query a table. Contact your database<br />
administrator to determine whether you are registered. When you have connect<br />
authority, you can query tables.<br />
v To create tables, you must have a TABLESPACE or write privileges to a space<br />
owned by another user. Your database administrator can allocate space.<br />
v You can define the level of DB2 access with the DB2SEC statement in the<br />
CNMSTYLE member.<br />
If DB2SEC is set to RRS, the <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> program loads the RRS<br />
interfaces and you have operator-level security checking. You can then access<br />
multiple DB2 subsystems on your system.<br />
If DB2SEC is set to CAF, the <strong>Tivoli</strong> <strong>NetView</strong> <strong>for</strong> z/<strong>OS</strong> program loads the CAF<br />
interfaces. You do not have operator level security, but you can continue to<br />
access multiple DB2 subsystems on your system.<br />
When the RRS or CAF interfaces are loaded, tasks can access DB2 directly<br />
without needing the DSIDB2MT task. DSIDB2MT must remain active <strong>for</strong> tasks<br />
that access the DB2 subsystem that DSIDB2MT accesses. When starting the