Skip to content

PRINT SCREEN

FUNCTION

PRINT SCREEN can display or clear a logical screen, display or clear data in the screen data fields, or display or clear multiple lines on the screen.

SYNTAX

PRINT SCREEN screen-name [CLEAR] [data-options]
[LINE OFFSET IS numeric-value]
data-options:
DATA | DATA-NAME LIST data-name [, data-name ...]
FORMULAS
screen-name
the name of a screen defined in Dictionary-IV.
numeric-value
a numeric data name, variable, constant, or expression that results in an integer.

NOTES

  • For more information on screens see the Dictionary-IV Developer Guide.
  • PRINT SCREEN does not collect data; use INPUT SCREEN for data entry.
  • If no options are specified, PRINT SCREEN prints the logical screen without data. For a window type screen, PRINT SCREEN creates a window without data.
  • The data-options are mutually exclusive. They enable you to select in which fields the command will display or clear data. The data comes from the data names defined in the screen.
  • The DATA option prints all data fields on the screen.
  • The DATA-NAME LIST option prints the specified data name(s).
  • The FORMULAS option prints only the results of the formulas defined in the screen.
  • The LINE OFFSET option is used with a data-option to specify an offset position for printing or clearing the specified data fields. If LINE OFFSET is not specified, the data-option uses the default line position for the data fields defined in the screen, which is equivalent to a line offset of 0. If LINE OFFSET specifies a positive integer, the data-option adds the offset to the default line position.
  • The CLEAR option, when no data-options are used, clears the entire logical screen area specified in the screen definition. For a window type screen, CLEAR deletes the window.
  • The CLEAR option, when used with a data-option, clears the specified data fields.
  • The CLEAR option, when used with a data-option and the LINE OFFSET option, clears the specified data fields at the specified line offset.

EXAMPLES

PRINT SCREEN 4SBOTSCR
PRINT SCREEN 4SBOTSCR LINE-OFFSET L0-1
DATA-NAME LIST ITEM-CODE
PRINT SCREEN 4SBOTSCR CLEAR DATA

SEE ALSO

INPUT SCREEN, SN

From the Script-IV Language Reference, version 8.9.1. Open this page in the PDF