Skip to main content

SETVAR - UNVVTSND configuration option

Set a variable with content from the virtual terminal screen.

UNVVTSND Parameter: SETVAR( [(variable_name output_row output_column value_length variable_type truncation_option)]... )​

  • variable_name - Specifies the name of the variable that will be set.
  • output_row - Specifies the row coordinate for data extraction.
  • output_column - Specifies the column coordinate for data extraction.
  • value_length - Specifies the number of characters to extract from the virtual terminal into the target variable. Valid values for this option are:
    • 1-132 - Explicitly specify the number of characters.
    • *dft - Extract a value from the specified starting location to the first space character.
  • variable_type - Specifies the type of variable to set. Currently, the only supported variable type is *LCL (local). Local variables reside in the local scripting environment.
  • truncation_option - Specifies the truncation option to use for the value that is extracted from the virtual terminal screen. Valid options are:
    • *none - No truncation will be performed on the extracted value.
    • *left - Leading spaces will be truncated from the extracted value.
    • *right - Trailing spaces will be truncated from the extracted value.
    • *all - Both leading and trailing spaces will be truncated from the extracted value.
info

Variables are only supported when UNVVTSND is run in the context of a script executed with the UNVVT script interpreter. See Universal Virtual Terminal Script Interpreter for additional information.