Running SirForms

Separate parameters with slashes ( / ) or spaces.

Execution parameters

COMPILE | CMP = filename with source text
EDIT = YES | NO
ERRORFILE = filename for any compilation errors
EXPERT
FORM | FRM = filename of compiled form
GRPNAM = groupname
GRPPAS = password
LISTING = filename
NOEXECUTE
NUMSCR = n
PREFIX = database path
PRINT = filename
PS = n
PW = database password
RS = read password
TMPLTSCR = filename
USRNAM = username
USRPAS = password
WD = n
WS = write password

CENY=yyyy

Sets the year used for calculation of the default century when two digit years are input. When a two digit year is input, the system compares the input year with this parameter. If the parameter is less than the input, the century is set to the specified century. If the parameter is greater than or equal to the input, the century is set to the specified century plus 1.

The default is 1920.

To illustrate the calculation, assume the default setting of 1920. Then any input year in the range 00 - 19 is assigned a century of 20nn; any input year in the range 20 - 99 is assigned a century of 19nn.

All variables defined as dates are held internally as a number of days since the start of the Julian calendar on Oct 15 1582.

Specifies an input file to compile. CMP is the abbreviation.

Specifies whether fields can be edited character by character (=YES) or whether a complete field must be re-entered (=NO). YES is the default

Specifies the name of the file to contain any errors found in compilation. If an OUT= is specified, errors are written to that along with other messages. If neither parameter is specified and compilation errors occur, messages are written to SirForms.err.

Disables the listing of expanded error messages and warnings during form compilation.

Specifies the name of the file containing the compiled version of the form. If this parameter is specified together with the COMPILE parameter, the form is saved in compiled format on the file specified.

If the FRM parameter is used without the CMP parameter, the file specified is accessed and executed. If neither FRM nor CMP is specified, SirForms prompts for the file name of the source file. FRM is the abbreviation.

Specifies the GROUP NAME. If the form has group names specified and GRPNAM is not supplied, it is prompted for.

Specifies the password assigned to the group name specified with the GRPNAM parameter.

Specifies the file where the output listing is written. If LISTING = is not specified, error messages are written to the error file or to the screen depending on whether these are compile or run time errors. LIST and OUT are alternates.

Specifies that the form is not executed after compilation.

Specifies the maximum number of screens to be held in the screen cache. The default value for "n" is 4. Use the PRELOAD and KEEP clauses on the screen commands (MENU, RECORD, TABLE, and HELP) to control screen caching.

Specifies a file for output from the user PRINT command. If the user then issues a PRINT command, all pages in the current screen are written to this file as text.

Specifies the database prefix which is the full path pointing to the location of the database.

Specifies the database password.

Specifies the READ security level password.

Specifies the template scratch file. Specify a scratch file to avoid conflicts with other SIR2002 modules which use a template scratch file.

Specifies a user name defined within the group specified with the GRPNAM parameter.

Specifies the user password assigned to the user name specified with the USRNAM parameter.

Specifies the WRITE security level password.

Examples of running SirForms

SirForms CMP=MYFORM.cmp LISTING=OUTPUT.LST
This compiles a form from MYFORM.cmp, produces a listing on OUTPUT.LST and executes the compiled form if there are no errors.

SirForms CMP=MYFORM.cmp FRM=MYFORM.frm NOEXECUTE
This compiles a form, stores a compiled version of the form on MYFORM.frm and does not execute the form.

SirFormsFRM=MYFORM.frm
This executes a previously compiled and saved form from MYFORM.frm.