DIAGNOSE Code X'58'
--
3270
Virtual
Console Interface
DIAGNOSE Code
X'58'
enables a virtual machine to
communicate with
3270 display stations. Using
DIAGNOSE
Code
X'58',
a virtual machine may:
Display up to a full screen of data using only one write
operation.
• Provide attribute characters along with data
that
is
sent
to the display station.
An
attribute character provides
control information for the data, for example, a request
to intensify the data when it
is
displayed.
• Place a 3270 display station under control of the virtual
machine (full screen mode).
When a virtual machine issues
DIAGNOSE Code
X'58',
the
virtual machine must provide one
or
more channel command
words (CCWs). These
CCWs
specify the 3270 operation
to
be
performed, provide control information for the display
station, and specify the address
of
data to be displayed
during a write operation
or
the address of a buffer where
data
is
to be stored during a read operation.
If
only
one
CCW
is used, the Rx register must contain its address.
If
CCWs
are chained,
the
Rx register must contain the address
of
the first
CCW
in the chain. The
Ry
register must contain
the virtual address
of
the display station where the operation
is to
be
performed. This value must be right-justified.
Displaying Data
To
display up to a full screen
of
data, code a
CCW
using
the
following assembler language instructions:
DS
OD
DC
AL1(CCWCODE),AL3(DATADDR),AL1(FLAGS),AL1(CTL),AL2(COUNT)
Where:
CCWCODE
the command code
X'19'.
A-20
VM/PC
Users Guide