# EZSPL New Format

> [HTML Version](ezsplnewformat.htm)

_Reviewed and revised April 2024_

**xcall EZSPL (or SPOOL), file, table**

**Parameters:**

_file _ ([String](string.md))  \[in\]

File specification for the file to print

_table _ ([Structure](structure.md)) \[in\]

Multiple options arranged per the following. Items marked with an asterisk are ignored by all A-Shell platforms.

MAP1 TABLE

MAP2 PRINTER,S,64             \! spooler name (was 6 under AMOS)

MAP2 CPU,F,6                  \!\*CPU id

MAP2 SWITCHES,F,6             \! option switches

MAP2 COPIES,F,6               \! copies to spool

MAP2 BANNER,S,50              \!\*banner

MAP2 LPP,F,6                  \!\*lines per page

MAP2 WIDTH,F,6                \!\*columns per page

MAP2 FORMS,S,6                \! printer form

MAP2 PRI,F,6                  \!\*priority

MAP2 ADATE,B,4                \!\*spool after date

MAP2 ATIME,B,4                \!\*spool after time

MAP2 RESTART,F,6              \!\*restart

MAP2 START,F,6                \!\*start page

MAP2 FINISH,F,6               \!\*finish page

MAP2 LIMIT,F,6                \!\*limit form feeds

MAP2 OPTIONS,F,6              \! (EZ-SPOOL) options

MAP2 SEQNO,F,6                \!\*(EZ-SPOOL) sequence #

MAP2 COUNT,F,6                \!\*(EZ-SPOOL) # blocks queued

MAP2 ITCERR,F,6               \!\*(EZ-SPOOL) ITC error

MAP2 NONITC,F,6               \!\*(EZ-SPOOL) spooler

MAP2 FILERR,F,6               \!\*(EZ-SPOOL) file error code

MAP2 EXTOPT,F,6               \! (EZ-SPOOL) extended options

MAP2 PREFIX,S,28              \! (A-Shell) prefix file

MAP2 SUFFIX,S,28              \! (A-Shell) suffix file

MAP2 HOSTROWS,F,6             \! (A-Shell) number of rows reserved for host in EZTYP

MAP2 EZCOLORS                 \! User-defined color scheme

   MAP3 EZFG'TXT,B,1          \! text colors

   MAP3 EZBG'TXT,B,1          \!

   MAP3 EZFG'BDR,B,1          \! border colors

   MAP3 EZBG'BDR,B,1          \!

   MAP3 EZFG'CMD,B,1          \!

   MAP3 EZBG'CMD,B,1          \! command colors

   MAP3 EZFG'STS,B,1          \!

   MAP3 EZBG'STS,B,1          \! status colors

   MAP3 EZFG'HLP,B,1          \!

   MAP3 EZBG'HLP,B,1          \! help colors

   MAP3 EZFG'HLT,B,1          \!

   MAP3 EZBG'HLT,B,1          \! highlight colors

   MAP3 EZFG'MNU,B,1          \!

   MAP3 EZBG'MNU,B,1          \! menu colors

   MAP3 EZFG'BRF,B,1          \!

   MAP3 EZBG'BRF,B,1          \! brief colors

MAP2 OVERLAY,S,28             \! overlay file

MAP2 TOTPAGES,F,6             \! total pages



The fields marked (EZ-SPOOL) were not part of the original AMOS specification and were added by EZ-SPOOL (as developed for AMOS). The fields marked (A-Shell) are A-Shell extensions that were not part of either the original AMOS or EZ-SPOOL specifications. All of the fields for both types of extensions are optional under A-Shell.

The PRINTER field was 6 bytes under AMOS but expanded to 64 in the A-Shell implementation to allow for the possibility of using Unix and especially Windows printer names. If you use the 64 byte version of the PRINTER field, then you MUST specify all of the other fields—even the ones which we just got through saying were optional. A-Shell can only determine which version of PRINTER you used by considering the total size of the TABLE parameter.



The EZCOLORS fields, if specified, will override the normal default color scheme used by EZ-SPOOL. The only exceptions to this are that they will be ignored if they are ALL ZERO, and that that can be overridden themselves by the EZCLR section of the INI.CLR file. For information on the color configuration file format, see [Color Configuration](color_configuration.md) and [MX\_INICLR](mx_iniclr.md).  

The OPTIONS_ _parameter above may be set to any combination of the values in the following table. Values that are ignored by A-Shell have been omitted (which is why there are gaps).

| **Value** | **Meaning** |
|------|------|
| \&h00000001 | PRINTER selection menu on |
| \&h00000002 | PRINTER selection menu off |
| \&h00000004 | OPTION menu on (questions at bottom of PRINTER menu) |
| \&h00000008 | OPTION menu off |
| \&h00000010 | TYPE (preview) allowed (by selecting printer X) |
| \&h00000020 | TYPE (preview) not allowed |
| \&h00020000 | ASKPRT on (Prompt to confirm user wants to print the file) |
| \&h00040000 | ASKPRT off |
| \&h02000000 | BRIEF on (single line printer selection prompt) |
| \&h80000000 | Preview file only (same as xcall EZTYP) |


[Hex-Decimal Values](hex-decimalvalues.md)



The EXTOPT_ _parameter above may be set to any combination of the values in the following table. These may also be set via the EXTOPT=### parameter in the EZSPL configuration file. Values that are ignored by A-Shell have been omitted (which is why there are gaps).

| **Value** | **Meaning** |
|------|------|
| \&h0004 | Disable screen save/restore |
| \&h0020 | Allow exit from EZVUE with Left-arrow |
| \&h0040 | Allow exit from EZVUE with Tab |
| \&h0080 | Allow exit from EZVUE with F1-F16 |
| \&h0100 | Do not ask questions on PRINT from within EZVUE |
| \&h0200 | Hitting Home when already at the top of the file in EZVUE acts like the PRINT command. |


[Hex-Decimal Values](hex-decimalvalues.md)



**Notes**

The PRINTER, SWITCHES, COPIES, FORMS, LPP, WIDTH, PREFIX, SUFFIX, OVERLAY, and TOTPAGES fields are interpreted in the same way as the individual parameters of the same names in XCALL SPOOL.