PRINT

Read syntax diagramSkip visual syntax diagram
Syntax

>>-PRINT(record,format)----------------------------------------><

Prints the record string in the specified format. The print output destination is determined as follows:

Procedure invocation Print output destination
From an online panel Determined by the value of the PRINTOUT field on the Set Print Processing Options panel.
From a batch job SYSPRINT
From REXX program Determined by the PRINTOUT parameter of the SET function.
Returns
0
Function was successful.
4
Function was unsuccessful and the record is not printed because either:
  • A format of SNGL or TABL was specified and Z Data Tools cannot determine the record type.
  • A template has been specified and the record did not pass the selection criteria.
12
Function was unsuccessful and the record is not printed because either:
  • You did not provide parameters.
  • A format of SNGL or TABL was specified, but no template or copybook was provided
record
Any string or variable representing a string can be used, however, INREC or OUTREC are most commonly used in this function.
format
Can be CHAR, HEX, SNGL or TABL. If you specify TABL or SNGL format:
  • On the function or panel that you are enhancing, you must specify a copybook or template that describes the record type to be printed.
  • Z Data Tools determines the type of the record to be printed by comparing its length with the record types in the template, and also by using any record identification criteria in the template.
  • If you are using PRINT with DSC or the Copy Utility (option 3.3) and you have specified both an input and an output copybook or template, the copybook or template used to format the printed record is determined as follows: if the value of the record to be printed matches the input record (INREC variable), the input copybook or template is used; otherwise, the output copybook or template is used.

    Ensure that the record value matches the template that Z Data Tools uses to print the data set.

  • Only those fields that have been selected in the template are printed.
  • If the record has been reformatted by template processing, the variable INREC contains the input record value and OUTREC contains the reformatted output record.
Note: Avoid using PRINT in a REXX procedure for a:
  • DSP function
  • FCH function
  • Print Utility (option 3.2)
because output from PRINT is interspersed with their normal output, which can be confusing. Using PRINT in a REXX procedure that runs from the Find/Change Utility panel (option 3.6), does not result in this problem, because the report produced by the panel is sent to a data set, separate from print output.

Example 1

Print the first hundred records.
If PRTCOUNT() < 100 Then PRINT(inrec,'CHAR')

Example 2

Print the current input record in TABL format.
rc = PRINT(inrec,'TABL')