EZSPL Config Files

The first thing EZSPL (SPOOL.SBR) does upon being called is look for configuration files. The A-Shell version of the configuration file search path is much more abbreviated than the AMOS version, consisting only of the following:

EZ:<printfilename>.SFL

EZ:<programname>.SPG

EZ:<printername>.SPR

EZ:<termname>.SPL

MEM:SYSTEM.SPL

SYSTEM.SPL[p,pn]

SYSTEM.SPL[p,0]

EZ:SYSTEM.SPL

 

If none of these are found, then printing proceeds as if EZ-SPOOL did not exist. Otherwise, it opens the first file it finds and process the parameters contained within. The parameters supported under A-Shell are:

ASKPRT=<boolean>

AUTOWIDTH=<boolean>

BRIEF=<boolean>

DEFAULT=<default printer name>

EXTOPT=<sum of extended options flags>

MENU=<boolean>

OPTIONS=<boolean>

PRINTER=<forced printer name>

PRTSPL=spooler1,description                (up to 64 PRTSPL statements)

SWITCHES=<sum of spooler switch flags>

TYPE=<boolean>

WAIT=<# seconds>

 

Each of these statements must be in all upper case, with no spaces, except within a description field. (e.g. "MENU = ON" and "menu = On" are invalid). Boolean options are "ON", "OFF", "YES", "NO", "TRUE" and "FALSE".

The lines of the configuration file are scanned from the top. For most parameters, if more than one instance of the parameter is processed, the last instance overrides earlier instances. The main except is the DEFAULT option, which only has an effect if no printer has been set (and no previous DEFAULT option processed). PRTSPL parameters are additive. The file may be broken into sections pertaining to individual users by prefixing the section with a line formatted as [username]. Lines between one [username] header and another are skipped unless the current username matches the name in the header. Two special [username] values may be used: a section with the header [always] is always processed, while a section with the header [default] is only processed if no previous username-specific section has yet been processed. ([always] and [default] don't count as username-specific sections.)

User name is determined by the native operating system logon procedure, and can be seen in the SYSTAT display or retrieved with GETUSN. It is not case sensitive in this context.

See Also

•   EZSPL Config File