Category : BBS Programs+Doors
Archive   : VBBS61A2.ZIP
Filename : VSCRIPT.DOC

 
Output of file : VSCRIPT.DOC contained in archive : VBBS61A2.ZIP







ÛÛ¿ ÛÛ¿ ÛÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛÛ¿ ÛÛÛÛÛÛÛ¿
ÛÛ³ ÛÛ³ ÀÛÛÚÄÄÛÛ³ ÀÛÛÚÄÄÛÛ³ ÛÛÚÄÄÄÄÙ
ÛÛ¿ ÛÛÚÙ ÛÛÛÛÛÛÛ³ ÛÛÛÛÛÛÛ³ ÛÛÛÛÛÛÛ¿
ÛÛ¿ÛÛÚÙ ÛÛÚÄÄÛÛ³ ÛÛÚÄÄÛÛ³ ÀÄÄÄÄÛÛ³
ÛÛÛÚÙ ÛÛÛÛÛÛÛÛ³ ÛÛÛÛÛÛÛÛ³ ÛÛÛÛÛÛÛ³
ÀÄÄÙ ÀÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÙ
*

The Virtual BBS/NET
Version 6.10

(C) Roland De Graaf 1990, 1991, 1992, 1993

4246 Elisabeth Ave.
Holland, MI 49424

*

ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
VBBS VSCRIPT Documentation
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Written By: Tom Hightower, aka "Baloo"
1@1806000 VirtualNET
Kevin Klunk, aka "Lord Doomslayer"
2@1508000 VirtualNET
Format By: Sam Fleming, aka "O. F."
1@1205500 VirtualNET
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ



TABLE OF CONTENTS

(1) General VSCRIPT Information
1.1 - Script Language Introduction
1.2 - General Restrictions
1.3 - Script Compiler (VCOM.EXE)
1.4 - Command Format
1.5 - Special Variables/Constants
1.6 - Interfacing with VBBS
1.7 - Prepackaged Scripts

(2) Number and String Handling
2.1 - Numeric Operators
2.2 - Numeric Functions
2.3 - String Operators
2.4 - String Functions
2.5 - String Alterations

(3) Display and I/O Commands
3.1 - Reading Input
3.2 - Showing Line Output
3.3 - Colorization
3.4 - Other Display Commands

(4) Database & Message Commands
4.1 - Database Selection
4.2 - LOAD Related Commands
4.3 - Editing Commands
4.4 - Viewing & Writing
4.5 - E-mail Functions

(5) Buffer Operation & Use

(6) File Commands
6.1 - Information Commands
6.2 - Transfer Commands
6.3 - File Editing

(7) Control Commands
7.1 - General Redirection
7.2 - Loops & Comparisons
7.21 - DO Loops
7.22 - IF/IFVAL Structures
7.23 - TEST/TESTVAL Commands
7.3 - Passing Control

(8) Miscellaneous Commands
8.1 - Visual/Interactive
8.2 - User Modifiers
8.3 - Real Miscellany

APPENDIX A - VGIX Commands
APPENDIX B - Programmer's Reference Guide
APPENDIX C - Script/Function Block Commands
APPENDIX D - Common Script Examples



VSCRIPT Documentation -- 1


ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º (1) GENERAL VSCRIPT INFORMATION º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ

1.1 - Script Language Introduction
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ

One of the features that makes VBBS unique is its script
language compiler - VCOM.EXE. Along with the built-in command
interpreter in VBBS, it allows you to make changes to your BBS
quickly and easily. The scripts are nothing more than a series
of commands listed in a plain ASCII text file, and you don't
even need to be a programmer to write one. All you need to cre-
ate scripts are a text editor or word processor that allows you
to save in ASCII format (see your word processor documentation
for more info) and a little patience. In no time, you will be
writing up scripts and swapping them with other VBBS sysops like
a pro.


1.2 - General Restrictions
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ

The VBBS script language has only one major restriction:
there can only be a total of 7 'tokens' on a line. A token is
defined as either a single unspaced series of characters (for
example, a command or a number) or any group of characters and
spaces surrounded by single or double quotes (also called a
"string".) The script language is NOT case-sensitive; any
capitalization used in this text is not required and is done
only for clarity.

All the scripts that you create should be placed into your
scripts directory as defined in VCONFIG - PATHS Configuration;
see VBBS.DOC for more information on setting your paths.

The only other restrictions pertain to names. All of your
script files MUST have the extension .V and all of your names
for variables must begin with a '$', e.g., $variable.


1.3 - Script Compiler (VCOM.EXE)
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ

The program VCOM.EXE is the compiler that prepares your
script file for use by VBBS's interpreter. It takes the script
file that you have created and builds the two files that VBBS
actually uses from it. These two files have the same name as
the script file but have .LIT and .COD as their extensions.

Compilation of a script is accomplished by changing to
your scripts directory and executing the command line:

VCOM