HyperScript
Command Line
The HyperScript application has a number of command line options to control how it is executed.
Entering the following command at the UNIX or VMS prompt:
hs -h
prints out the list of options:
usage: -c (compile only)
-i (interactive mode)
-q (quiet mode)
-v (echo input stream)
-g (parse cgi POST or GET)
-s stream (input from 'stream' instead of stdin)
-f file (input from 'file' instead of stdin)
-e method (enable 'method' to receive messages)
-t [instance].object (set target name of program)
-l log (output to 'log' instead of stdout)
-d mask (debug mask: OR of {1,2,4,8,..,512} )
-h (print this help)
[arg1 [arg2 [arg3 [...]]]]
where hs is the name of the HyperScript application, and -h is the command line option that tells HyperScript to print a help message.
The command line options are fully explained below.
No Options
With no options specified, HyperScript will enter interactive mode with time stamp logging turned on, where it will parse and execute commands typed by the user. The date, time, and HyperScript object name is pre-pended to all output, and can be turned off or on with the timestamp method.
-c
The -c option means to compile (parse) the HyperScript commands without executing them. It can be used with the -f option to check a HyperScript program file for errors.
-i
This option puts HyperScript into interactive mode with time stamp logging turned off. Commands typed by the user will be parsed and executed.
-q
Runs HyperScript quietly, without the usual output messages. The -q option should be specified whenever the -g option is used to run HyperScript as a cgi script.
-v
The input commands are printed to the output, along with the line number.
-g
Use this option when HyperScript is executed as a cgi script, called by a web server in response to the POST or GET http method (usually issued by a form control in a web page). The name/value pairs are extracted into HyperScript variables, which can be accessed in a HyperScript program. The -q (quiet) option should be specified with -g.
-s stream
Take the input commands from stream. For example:
hs -s 'put ( "Hello World" );'
causes HyperScript to execute the put method.
-f file
Specifying the -f file option causes HyperScript to execute commands from a file. HyperScript will then exit, unless the idle method was called.
-e method
The -e method option will enable the method for execution by an incoming EVENT or QUERY message.
-t [instance].object
Normally, the target name of the HyperScript application is set to the process name (VMS) or the login name (UNIX). This option allows you to specify the target name. The object part of the name is the class name. If a unique instance of the class name is required, then it can be specified with the -t option. (See the instantiate method.)
-l log
This option causes all output normally printed to stdout to go to a file called log.
-d mask
HyperScript has a number of debug modes that can be toggled on with a mask. Use this option to turn on various debug modes. (See the debug method.)
-h
HyperScript prints out a help message describing the command line options, then exits.