CDS057

Read / Print / Convert VDT Format

Last Revised: 03/17/05

The purpose of this routine is to read, print, or convert VDT Formats. It is not typically called within an application program. It can be used however to display the specified VDT format.

Called program CDS257 is now used to print window text created with CDS069 using the W{} option. However to retain compatibility, CDS057 will call CDS257 when called referencing a file other than a VDT format file.

In its most complete form, CDS057 is called using the following variables:

Calling Format:

CALL "CDS057", Y$, F0$, F1$, FC2$, STS$, XSIZ, YSIZ, XPOS, YPOS, ATTRB$, ATTRW$, WT$, WA$, PRT$[ALL]

CDS057
Y$ Terminal Control Variable
F0$ Text ID
F1$ title string to be used if the window is to be displayed.
FC2$ text detail file or channel# if pre-opened
STS$(1,1)
STS$ Action Codes
D display only (default if not passed)
d display VDT background only
b return VDT format as Basic print statement
m maintain VDT text
w write VDT format
f return VDT background in WT$
P print to printer
F return array formatted for printer
T return array text only, no attributes
XSIZ window width (data only, not border)
YSIZ window height (data only, not border)
XPOS starting column position of the window
YPOS starting row position of the window
ATTRB$ attribute string containing the mnemonics such as color or 'SB' or 'BR' of the window border
ATTRW$ attributes string containing mnemonics such as color of the window contents
WT$ window text (XSIZ * YSIZ characters)
WA$ window attributes (XSIZ * YSIZ characters)
PRT$[ALL] array formatted for printer is returned when STS$(1,1)="F"