Jive Operation

Jive operates both as a command line (console) program and as a web server cgi-bin program. Jive reads input data in HTML Form Input format from the standard input device - stdin. It produces output on the standard output device - stdout. For web server operation, this output is normally HTML text.

Jive processes an ASCII file containing embedded Jive commands. The name of this file is normally specified on the Jive command line but can be overridden by HTML Form Input.

After HTML Form Input from stdin has been processed, the Jive command line is also processed as Form Input. Any command line arguments containing an equal sign (=) are assumed to be in Form Input format.

If the first command line argument does not contain an equal sign (=), it is used as the file name for Jive input and execution of embedded code. The file name can be overridden with 'page=' in the Form Input or the command line.

The processing of the Jive input file is described in HTML Processing.

Calling Jive Scripts from HTML

Jive scripts are normally called as part of Form Input but may also be executed with a hot link.

In the examples below, the Jive Interpreter and its scripts are assumed to be in the scripts subdirectory off the root. It can be accessed with the short hand,

/scripts/jive2.exe

In all the examples below, full qualification could be used. For example,

http://www.myurl.net/scripts/jive2.exe

Calling Jive with a Hot Link

A Jive script can be executed through a hot link from a HTML page. Any input values including the script name must be specified following a question mark (?). For example,

/scripts/jive2.exe?startup.jiv&mode=new

This executes the Jive interpreter using the Jive script - startup.jiv, passing the input name, mode, with the value - 'new'.

As a hot link,

<a href="/scripts/jive2.exe?startup.jiv&mode=new">Let's Jive!</a>

Calling Jive through Form Input

More commonly, a Jive script is called from Form Input. For example,

<form method=post action=/scripts/jive2.exe?startup.jiv>
<input type=checkbox name="mode" value="new">
<input type=submit value="Do It">
</form>

An alternate technique is to pass the script name using the 'page=' override with a hidden variable,

<form method=post action=/scripts/jive2.exe>
<input type=checkbox name="mode" value="new">
<input type=hidden name="page" value="startup.jiv">
<input type=submit value="Do It">
</form>

Or 'page=' can be used in the submit button,

<form method=post action=/scripts/jive2.exe>
<input type=checkbox name="mode" value="new">
<input type=submit name="page=startup.jiv" value="Do It">
</form>

'page=' is also used for method=get,

<form method=get action=/scripts/jive2.exe>
<input type=checkbox name="mode" value="new">
<input type=submit name="page=startup.jiv" value="Do It">
</form>