 Windows 95 RAS Dialer Extension for Visual DialogScript
=========================================================

Copyright (c) 1997 JM Technical Services
All rights reserved

This is a FREE extension command for Visual DialogScript
(32-bit version.) It adds a command RAS and a function
@RAS to the vocabulary of VDS. This lets you dial up and
terminate Internet connections that use Windows 95 Dial
Up Networking under control of a DialogScript program.
You still need the Windows scripting tool to handle the
login dialog with your Internet access provider.

This extension is not part of the Visual DialogScript
product and is unsupported.

Instructions
============

Put the file VDSXRAS.DLL in the same directory as DS.EXE
and DSRUN.EXE. To declare it in your program put the
command:

	EXTERNAL VDSXRAS.DLL

Functions
=========

@RAS(ITEM,n)

  where n is a number starting from 0

This function returns the name of a Dial-Up Networking
connection, for example "CIX Internet." To build a list
of connections, call this function with n increasing from
0 until it returns null, and add the result to a string
list.

@RAS(PARAMS,connection-name,flags)

  where connection-name is one of the names returned by
    @RAS(item)

  flags is either or both U and P

This function returns information about the named
connection. It returns the user name if the U flag is
present, and the password (if stored) if the P flag is
present. If two flags are given the information returned
is separated using the field separator "|" so it can be
assigned to different variables using PARSE.

Commands
========

RAS DIAL,connection-name,user-name,password,telephone-no

This command dials the dial-up connection connection-name.
The connection-name parameter must be present. The default
(stored) values of user-name,password and telephone-no are
used, if these parameters are omitted or null.

On completion, OK is true if the connection was made
successfully, false if it failed.

RAS HANGUP

This command hangs up a Dial-Up Networking session if one
is in progress.

Example
=======

The example script RAS Test can be used to try out this
extension.
