Information icon IBM Information Server, Version 8.1
Feedback

UPRINT statement

Syntax

UPRINT [ ON print.channel ] [ print.list ]

Description

In NLS mode, use the UPRINT statement to print data that was mapped to an external format using OCONV mapname. The UPRINT statement subsequently sends the mapped data to the screen, a line printer, or another print file with no further mapping.

The ON clause specifies the logical print channel to use for output. print.channel is an expression that evaluates to a number from -1 through 255. If you do not use the ON clause, logical print channel 0 is used, which prints to the user's terminal if PRINTER OFF is set (see the PRINTER statement). If print.channel evaluates to the null value, the PRINT statement fails and the program terminates with a run-time error message. Logical print channel -1 prints the data on the screen, regardless of whether a PRINTER ON statement has been executed.

You can specify HEADING, FOOTING, PAGE, and PRINTER CLOSE statements for each logical print channel. The contents of the print files are printed in order by logical print channel number.

print.list can contain any BASIC expression. The elements of the list can be numeric or character strings, variables, constants, or literal strings; the null value, however, cannot be printed. The list can consist of a single expression or a series of expressions separated by commas ( , ) or colons ( : ) for output formatting. If no print.list is designated, a blank line is printed.

Expressions separated by commas are printed at preset tab positions. The default tab stop setting is 10 characters. For information about changing the default setting, see the TABSTOP statement. Use multiple commas together for multiple tabulations between expressions.

Expressions separated by colons are concatenated. That is, the expression following the colon is printed immediately after the expression preceding the colon. To print a list without a LINEFEED and RETURN, end print.list with a colon ( : ).

If NLS is disabled, the UPRINT statement behaves like the PRINT statement.

For more information about maps, see WebSphere DataStage National Language Support Guide.


PDF This topic is also in the IBM WebSphere DataStage BASIC Reference Guide.

Update icon Last updated: 2008-09-30