Put text to the active screen buffer
The PutScreen tag will replace text in the active screen buffer at row, column with the contents of text.
If you are working with attribute-based protocols (3270, 5250), remember to include any attribute bytes (to give bolding, for example). A list of attribute bytes may be found in the Map Tag section
There is a 4000 character "scratch area" for each session that is initialized to nulls at the start of each session. You can write to the scratch area using the PutScreen tag by specifying a row that is less than 0 (-1 for example). The scratch area is not affected by any screen read/write operations so the contents will remain throughout a session. This allows you to use the scratch area as a storage area for variable data. The IfScreen tag can read the Session scratch area using the same technique (negative row number).
Attributes:
Attribute |
Default / Required |
Description |
row |
1 |
Row number (1..maximum rows), or -1..-maximum. If row number is negative, the text is put to the scratch area rather than the active screen (see above). |
column |
1 |
Column number (1..maximum columns) |
text |
required |
Text to put to the screen at row, column |
PutScreen has no children.
Example:
<IfScreen row="12" column="21" text="bozo">
<Else/>
<PutScreen row="12" column="31" text="}You must enter Bozo!]"/>
<SetCursor row="12" column="21"/>
</IfScreen>
