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

PIPE SQL
222 Programming: Pipes
5 The field length as reported by DB2. This is a single number except for
decimal fields where the precision and scale are reported with a comma
between them. For graphic fields, the length is the number of DBCS
characters and does not include shift-in or shift-out characters.
5 The maximum length of the field in characters, including a halfword
length field if required, computed from the length and field type. This is
the number of bytes SQL SELECT reserves for the field in the output
record from a query, and the number of bytes required in the input record
to SQL INSERT. The length does not include the indicator word. For
graphic fields, the length is the number of bytes of DBCS characters and
does not include shift-in or shift-out characters, but does include 2 bytes
for the length field if the field is variable length.
30 The field name. The record is truncated at the end of the name; the name
field is in the range of 1-30bytes.
Sample DESCRIBE SELECT
/* Describe the result of a query */
’pipe SQL describe select * from jtest | console’
Loading Tables with SQL INSERT
An insert statement with a values() clause or a subquery is executed immediately
without reference to an input stream. A values() clause cannot refer to host
variables. Either a values() clause or a subquery must be used. DB2 does not
provide the ability to insert on a cursor.
Release statement, Set Connection, Set Current Degree, Set
Current Package Set, Set Current Rules, or Send Current SQLID
Definitions of parameters match the SQL language. Because these statements
cannot be executed using dynamic SQL, the NetView program provides explicit
code support for them. These statements can be used in a "PIPE SQL EXECUTE"
on the primary input stream as is done for other functions.
Using SQL LISTREGS
This function, which is provided with the NetView program, lists the values in the
DB2 special registers. It provides the following output:
-------------------------------------
* NTV98 PIPE SQL SSID DB2 LISTREGS | CONS
" NTV98
CURRENT DEGREE=1
CURRENT PACKAGESET=
CURRENT RULES=DB2
CURRENT SERVER=DB2L01
CURRENT SQLID=IBMUSER
USER=IBMUSER
CURRENT TIMEZONE=-50000
CURRENT TIMESTAMP=1998-11-09-09.31.02.048057
---------------------------------------
Using SQL EXECUTE
A statement after EXECUTE is issued first; the primary input stream is then read
and each record is performed. All DB2 statements are performed as a single unit of
work. Most DB2 statements are supported; see the description of the PREPARE
statement in your DB2 documentation for a list of unsupported statements. SQL
processes COMMIT, CONNECT, and ROLLBACK directly; thus, they are also
supported. Unsupported statements are rejected by DB2 with return code -515.
Processing stops as soon as an error is reported by DB2.