DTR (V00275)


I. INTRODUCTION

DTR is privileged program which exerts the DTR modem control signal for a 
specified terminal device.  DTR supports the following terminal devices:

	o DZ-11 and DZV-11

	o DHU-11 and DHV-11

A user must have CMKRNL priviledge to run DTR, consult your system manager 
regarding authorized priviledges.


II. RUNNING DTR

DTR may be used from DCL or BATCH to assert DTR for a specified terminal device.
The terminal device name input to DTR must be in the format "ddcu".  Note, a 
":" (colon) is not required following the terminal device name, and if 
specified, will result in SS$_BADPARAM error.
	
	where: dd	- terminal device name (TT,TX)
		c	- controller number (A,B,...)
		u	- unit number (0-99)

	example:	$ RUN DTR
			$ Terminal device> TTA2

In the above example TTA2's DTR (Data Terminal Ready) modem control signal is 
asserted.

Optionally, the user may define a symbol for DTR to allow him to input the 
terminal device name along with the DCL command line.  If the terminal device 
name is omitted, the user will be prompted for it.

	example:	$ SETDTR :== $device:[directory]DTR
			$ SETDTR TTA2
				  
In the above example TTA2's DTR (Data Terminal Ready) modem control signal is 
set.  In this example the user may specify the terminal device name in the DCL 
command line and is functionally equivalent to the steps performed in the 
previous example.


III. DEVICE SUPPORT

DTR supports the following terminal devices:

	o DZ-11  and DZV-11
	o DHU-11 and DHV-11

Additional terminal device support can be added simply by modifying module 
SET_DTR_KRNL to access the proper CSR bits in order to assert the DTR modem 
signal.


IV. COMPLETION CODES:

The module will complete with one of the following completion codes:

	o SS$_NORMAL	- Success, the operation completed normally
	o SS$_BADPARAM	- Failure, terminal device name input is not valid
	o SS$_DEVOFFLINE- Failure, terminal device is offline (not available)
	o SS$_IVDEVNAM	- Failure, terminal device (e.g., DMF) is not supported
	o SS$_NOPRIV	- Failure, user does not have CMKRNL privilege
	o SS$_NOSUCHDEV	- Failure, terminal device does not exist on this system


V. REBUILDING DTR

DTR is written entirely in MACRO-32.  Therefore, no language compiler is
required to build DTR.  A build file (DTR.COM) is supplied with this module.  
It assembles and links DTR.MAR (this module) and creates a listing and map
file.

DTR should be rebuilt with each major release of VMS to avoid possible 
problems.  


VI. SUPPORT

DTR is experimental software and is as such not supported.  It is fully 
expected that someone else other than the original author will add support 
for other terminal devices and maintain the software.

Note, the SET_DTR_KRNL module will have to be updated to run under V5.0 of 
VMS to run on VAXs with SMP (Symmetrical Multiple Processors).

Click on FTP to download from the FTP archives.

[FTP]