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

PIPE SQL
Performing a Query with SQL SELECT
The argument specifies a complete SELECT statement. One record is written for
each row of the result of the query. By default, each column is preceded by a
2-byte indicator word specifying whether the column has a null value or contains
data. Use NOINDICATORS to suppress this field in the output record.
In an indicator word, binary zero indicates that the column has a value; a negative
indicator word indicates that the column is null. A positive value in the indicator
word means that the column is truncated; this cannot occur, because each column
has as many positions reserved as SQL DESCRIBE reports for the table. Blanks or
zeros, as appropriate to the field format, are stored in the unfilled positions of
columns that contain a null value and columns that have variable length. When the
last field has variable length, the record is truncated to the end of the data present.
/* Query a table, save results in a stem variable */
’pipe SQL select * from jtest |$stem results.’
’pipe $stem results. | cons’
The above example shows how $STEM saves the message colors in the "results."
array as well as saving the data.
The results of the queries are written to the primary output stream, and are
color-coded green. Output data is written using NetView message type double
quotation mark (HDRTYPEK).
If the secondary output stream is defined and connected, any error messages are
written there. If a secondary stream is not defined, error output is not sent to the
primary stream, but escapes to the parent pipe or is displayed instead. Error
messages are also color-coded in red. Error messages are written with the NetView
message type apostrophe (HDRTYPEJ).
If the third output stream is defined and connected, additional return code
information is provided. The output consists of the following items:
v A plus (+) sign or minus (−) sign
v A 10-digit decimal SQL value, including leading zeros
v A blank space
v The input text of the SQL statement that ran.
This stream is useful for monitoring end of file conditions, reported by SQLCODE
+0000000100. The stream is color-coded in green and the NetView message type is
double quotation mark (HDRTYPEK).
Diagnostic messages (from the SQL TEST or DIAGNOSE options) are color-coded
yellow, and are written to the secondary stream. Diagnostic messages are written
with the NetView message type apostrophe (HDRTYPEJ).
Performing a Query with DESCRIBE SELECT
The argument is a query to be described. One record is written for each field of the
query. See the description of the SQLDA in your DB2 documentation for more
information.
Each record has five blank-delimited fields of fixed length:
3 The decimal number defining the field type.
16 The field type is decoded or Unknown if the field type is not recognized by
NetView SQL Stages. The first four positions have the word LONG if the
field is a long character or graphics field.
Chapter 2. Pipeline Stages and Syntax 221