Printer Assignments

Syntax:

Command
Mandatory parameter
Optional parameter
Mandatory keyword
Optional keyword

Description

Assigns properties to a printer ID.

Diagram:

Remarks

info Properties from Text Reports and Graphical Reports can not be mixed. I.e. properties from Text Reports can only be used in Text reports and vice versa.

Parameters

Item

Description

<Output ID>

Logical identifier by which the printer is accessed. Valid names can be found in the Printer table of the Control Center. Mostly the output ID "PROUT" is used as default.

<Property>

Property for the output ID.

There are some properties that are not always available, depending on whether a text or graphical report is concerned. In the list below, all printer ID properties are described. If a property can only be used in a text or a graphical report, this will be indicated below the property name. If not mentioned, the property applies to both text and graphical reports.

ALSOTOPORTS

Prints are sent to multiple printers.

BANNER

(only available in text reports)

Allowed values: 'Y' or 'N'.
When 'Y' the in the Comscript printersettings supplied banner will be printed, when 'N' no banner will be printed.
When no Banner File has been set in the Comscript printersettings, the file Banner.dat will be used that should be placed in the root of the Print Output folder as set in the Control Center.

COPIES

The number of copies to be printed.

DAYSTOKEEP

The number of days that the printfiles are stored. When zero the printfiles will never be deleted.
If multiple print jobs use the same print file, the print file is stored until all the print jobs 'days to keep' have expired.

DONTPRINT

Boolean. If set to true there will be no physical printing of the printfile and the print will be directly moved to the list of completed prints. The used printer does not have to exist.

Defaults to false.

Note: The printfile can be physically printed at a later moment using the printagain option and an existing printer.

DUPLEX

(only available in graphical reports)

One of the following duplex options:

1 Simple one sided printing

2 Two sided printing folding along the vertical side

3 Two sided printing folding along the horizontal side

EMBEDDEDFONTS

(only available in graphical reports)

Embedded fonts are always enabled regardless of the value of this property. Changing this property has no effect.

ENCRYPTIONSTRENGTH

(only available in graphical reports)

One of the following encryption options:

0 Not encrypted

1 40-bit encryption (supported by Acrobat Reader 3.x and 4.x)

2 128-bit encryption (supported by Acrobat Reader 5.x and higher)

FILENAME

The name of the print file (<Name>.prn).

When reading the property value, AMT returns the name of the file before the printing. Before the first PRINT statement, this value is empty. After a PRINT statement, the FILENAME property is set to the current filename.

You may also use this property to assign the name to the print file. The name will then be assigned after the next PRINT statement. If a PRINT statement has already been specified, then the new name is only assigned after a FREEOUTPUT is sent, followed by a new PRINT statement.

So, if a new name for the print file is specified and the filename is read before the output is sent to the printer, the value that is read from FILENAME (current value) will differ from the value that is written into FILENAME (next value).

Note: When setting the file name on a printer object to the same previous value (also ignoring casing) then the print is no longer released but continues just as if the filename was not (re)set.

warning The Actual Filename Of The Print May Differ From The Print Filename Set Depending On Other Settings. E.G. When 'Print File Overwrite' Is Not Set In The Printer Settings, Version Numbers Will Be Added To The Filename To Garantee Unique Filenames (.0000, .0001 Etc.).

Identifier for conditional formatting of the print output. With this option you can assign multiple ID-properties to be used in the same print routine in which the acting depends on the ID-property value. Default value is an empty string. In the example below, the output ids "PROUT" and "PROUT_A" get different values for the ID-property (subsequently "Prt" and "Prt_A"):

prout.id := 'Prt'
prout_a.id := 'Prt_A'

In the example code below, the routine "ROU_X" refers to both output ids:

rou_x (prout)
rou_x (prout_a)

In the exemplary routine below, the print output is made dependent of the ID-property value, e.g.:

routine set_prdetail (varprout printer)

begin_routine

if varprout.id = 'Prt_A'

lay_1.prdetail := 'DETAIL'

varprout.copies := 1

else

lay_1.prdetail := ' '

varprout.copies := 2

endif

end_routine

LINESPRINTED

(only available in text reports)

Contains the number of lines already printed on a page.

MACRO

(only available in text reports)

One or more Printer Macro names separated by commas. The Macro names can be found and set in the Printer Macros tab in the Control Center. The actual hexadecimal macro strings have to be created in the Text Printer Macros tab of the Printers configuration.

MAXLINES

(only available in text reports)

The maximum number of lines to print on a page. When the property LINESPRINTED reaches the value set here, a page break (form feed) will be added and the property LINESPRINTED will be reset to zero. See Printers.

The default value is depending on the "Max lines" setting of the printer that is used (defined in the Control Center).

PAGESCALING

(only available in graphical reports)

One of the following page scaling options:

0 No scaling

1 Fit to paper

2 Shrink large papers

PAGESPRINTED

The number of pages that are printed.

PAPERKIND

The kind of paper to be used. Set a free to choose string to this property, this will group all printfiles under a folder named as that value.

PASSWORD

(only available in graphical reports)

Password used for the encryption of the output.

PORTRAIT

(only available in graphical reports)

From AMT 83 forwards the orientation will be set automatically if set manually before the first page is printed.

Boolean option to determine whether to print in portrait or landscape. If the value for this property is set to "False", then the output will be printed in landscape. Defaults to True.

PRINTER

Logical printername of the printer to use for the output. In the Control Center, the logical printername is assigned to the physical printer.

PRINTPOSITION

(only available in graphical reports)

Returns the vertical position on the current page for the next print command in pixels.

TITLE

Title of the document to be printed.

UNICODE

Boolean. When set to true, unicode characters will be used for printing.

USER

The owner of the print. This is not always the same user as the person that gives the print task.

Printer Assignments

Syntax:

Description

Diagram:

Remarks

Parameters

Example: