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

PIPE EDIT
See also the conversion order for “F2C” on page 113 and the conversion order
for “C2S.”
C2G (conversion order)
Converts fixed-length strings to double-byte (DBCS) character strings by
adding a shift-out character in front of the string and a shift-in after the string.
C2G is the inverse of G2C.
This conversion order is particularly useful when dealing with data interacting
with the SQL pipe stage.
C2GV or C2VG (conversion order)
Converts varying-length strings to double-byte (DBCS) character strings by
adding a shift-out character in front of the string and a shift-in after the string.
The input string must start with a 2-byte length field containing the number of
DBCS characters. The number of data bytes after the length field must be twice
the value of the length field because each DBCS character is represented by
two bytes of data. The length field is not copied to the converted string.
C2GV is the inverse of GV2C.
This conversion order is particularly useful when dealing with data interacting
with the SQL pipe stage.
C2P (conversion order)
Specifies that the input data is converted to displayable floating point notation
of a specified precision. Scale indicates the number of decimal digits retained.
v If scale is 0 (zero), the resulting number is an integer. For example, C2P
0converts the input X'123C' to 123.
v If scale is positive, the resulting number has scale number digits after the
decimal point. For example, C2P 2 converts the input X'123C' to 123.45.
v If scale is negative, the resulting number has scale zeros added to the
number. For example, C2P -1 converts the input X'123C' to 120.
C2P is the inverse of P2C.
C2S (conversion order)
Specifies that the input data is converted to a displayable floating point
notation. The input can be a 2– to 8–byte floating point number. The converted
value is a 14–byte, right-aligned, output string in the form -n.mmmmmE-dd where
the exponent E-dd and the decimal point are included only if required by the
converted number. When the exponent E-dd is not produced, the output is
equivalent to packed decimal.
A maximum of 17 decimal digits are used in the conversion with leading and
trailing zeros stripped. An 18th digit is calculated and used to round the
results. For example, the repeating decimal number 1.9999999... is converted to
2.
See also the conversion order for “F2C” on page 113 and the conversion order
for “C2F” on page 110.
C2V (conversion order)
Specifies that the input data is a variable length string to be converted to a
displayable string. The input data starts with a 2–byte, unsigned length value
indicating the length of the string.
C2V is the inverse of V2C.
This conversion order is particularly useful when dealing with data interacting
with the SQL pipe stage.
Chapter 2. Pipeline Stages and Syntax 111