Visara Master Console Center Scripting Guide - Manual (Page 79)

Chapter 5 Script Commands
Scripting Guide 79
ASCRN
Syntax:
ASCRN( $Array, %Port)
Description:
Fill an array with the full text of a console screen.
Action: Each row (or line) on the console screen becomes an element in
$Array.
Parameters:
$Array. Normal string array. The array to populate with the screen
rows of text. Each array element will contain one row of text—
element one will hold the text from screen row one, element two will
hold the text from screen row two, and so on.
%Port. Numeric expression. The assigned OS port number for the
console. Refer to Ports on page 24 for more information.
Returns:
N/A.
Notes:
ASCRN() is not for capturing the printer console text. Use the
QREAD() command for reading the printer console instead.
Example:
// Sample ASCRN call
%PortID := PORT( OS, “System3”)
ASCRN( $ScreenContents, %PortID)
See Also: SCRIPTCANCEL