IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

Using Tivoli NetView for z/OS SQL Stages for Access to DB2
In this example, SSID DB2 defines the DB2 subsystem named DB2 as the subsystem
this task references.
Creating, Loading, and Querying a Table
336 Programming: Pipes
Use SQL to query and maintain DB2 tables. The following examples show two
ways to create a table. In the first example, a single DB2 statement is issued; in the
second example, SQL EXECUTE reads statements from its primary input stream.
The following example shows that you can supply multiple DB2 statements to a
single invocation of the SQL stage:
pipe SQL execute create table jtest (kwd char(8), text VARCHAR(80))
in netview.xmydb | cons
’pipe lit /create table ktest (kwd char(8), ’ ,
’ text VARCHAR(80)) in netview.xmydb/’,
’ | SQL execute ’,
’ | cons ’
/* Insert lines in a table */
signal on novalue
"PIPE",
"lit /AAA Automated Banking System/",
"| lit /BBB Network Program/",
"| lit ’CCC TIVOLI NetView for OS/390 Automation’",
"| edit /insert into jtest (kwd, text) values(’/ 1 ",
"1.8 next /’, ’/ next 9.* next /’)/ next",
"|SQL execute",
"|CONS"
exit RC
Note: You receive error messages from SQL if you do not enter the names of the
columns, even when you are setting all of them.
The following example shows how to use SQL DESCRIBE SELECT to see the
format of the input record or the result of a query:
pipe SQL SSID DB2 describe select * from jtest | console
453 CHAR 8 8 KWD
449 VARCHAR 80 82 TEXT
In the previous example, each line describes a column in the table. The first
column of the record is the numeric DB2 field code. The field code is decoded in
the next column. A third column is the length (or precision) of the field as
perceived by DB2. The fourth column is the number of characters required to
represent the field when loading with SQL INSERT and when queried with SQL
SELECT. Note that the varying character field has two bytes reserved for the
length prefix. Finally, the name of the column is shown. SSID DB2 defines that DB2
is the name of the DB2 subsystem to access. Subsequent SQL requests access that
DB2 unless the keyword SSID is used.
The following is an example of an SQL SELECT query:
pipe SQL select * from jtest | console
""CCC """"TIVOLI NETVIEW FOR OS/390 AUTOMATION
""BBB """"NETWORK PROGRAM
""AAA """"AUTOMATED BANKING SYSTEM
The double quotation marks represent unprintable binary data. The first two
positions of each column contain the DB2 indicator word that specifies whether the