Digital PDFs

AN-003

October 2000

2 pages

Original

18.7kB

Document:	Connecting CHARON-VAX to a host application
Order Number:	AN-003
Revision:	0
Pages:	2
Original Filename:	AN-003.pdf

OCR Text

CHARON-VAX application note
AN-003: Connecting CHARON-VAX to a host application
Author: Software Resources International

Date:

9 Oct 2000

CHARON-VAX is a software emulator capable of executing unmodified VAX operating system and
application code. CHARON-VAX is also designed to add or modify functionality even if it is impossible
or undesirable to modify the original VAX code. A flexible and powerful way of achieving this is the use
of sockets.
On the Windows platform, an emulated VAX serial line is represented by a socket. Usually, the
emulator connects these sockets to the physical serial I/O ports of the host system, with for example
the following entry in the configuration file:
load
set

DHV11 YVA
YVA
line[1]=”COM1:”

Serial lines

CHARON-VAX
Serial
I/O
devices

VAX
environment

Host system

CHARON-VAX accepts also a process name in the line assignment. This is the way the internal
CHARON-VAX terminal emulator is used:
load
set

DHV11 YVA
YVA
line[1]=”run terminal”

Serial lines

CHARON-VAX
Terminal
window on
host display

VAX
environment

Serial
I/O
devices

Host system

©2000 Software Resources International. This document is provided for information only and is not a legally binding offer.
Software Resources International reserves the right to change the product specifications without prior notice or retire the
product. The CHARON name and its logo are a registered trademark of Software Resources International. For further
information: www.charon-vax.com, Email: vaxinfo@vaxemulator.com

CHARON-VAX application note AN-003
It is equally possible to specify a user written task in the line assignment, if this task connects to the
provided socket. The CHARON-VAX emulator automatically invokes such task during the scanning of
the configuration file:
load
set

DHV11 YVA
YVA
line[1]=”run c:\my_application.exe”

CHARON-VAX

Serial lines
My
application

VAX
environment
Host system

Serial
I/O
devices

Programming example
The programming example VAXPRINT is a print utility to send data from a CHARON-VAX serial line to
the default printer (using its default page settings) of a Windows NT/2000 host system by using the
following entry in a configuration file:
load
set

DHV11 YLA
YLA
line[1]=”run vaxprint”

The VAXPRINT source code and the executable for Windows can be downloaded as VAXPRINT.ZIP
and VAXPRINT.EXE respectively from the “downloads” area of the CHARON-VAX web site at
http://www.CHARON-VAX.com. The source code is provided as a programming example for other
applications.

Page 2 of 2