MicroStrategy ONE

Alter Print Device statement

Modifies the properties of a print device. A print device is used in Distribution Services to automatically print a MicroStrategy report or document on a printer on your network.

Copy 
ALTER PRINTDEVICE "device_name" NAME "new_name" [DESCRIPTION "description"] [PRINTERPATH "location"] [ALLOWUSERINFO (TRUE | FALSE)] [SCALE scale] 
 [PRINTQUALITY "quality"] [PAPERSOURCE "papersource"] [PAPERSIZE "papersize"] [POSTSCRIPTLEVEL level] [EVENODD (EVEN |ODD |BOTH) ] [REVERSEPAGE (TRUE |FALSE)] 
 [APPLICATIONPRIORITY (OTHER | ISERVER) ] [USEBACKUP (TRUE | FALSE) BACKUPTYPE 
 (PRINTER | FILE ) BACKUPLOCATION "location"] [NUMBEROFRETRIES num] [TIMEBETWEENRETRY time] [DELIVERYTIMEOUT time] [WORKLOCATION "worklocation"];

where:

  • PRINTDEVICE "device_name" is the name of the print device to change, of type string.

  • NAME "new_name" is the new name of the print device, of type string.

  • DESCRIPTION "description" is the new description of the print device, of type string.

  • PRINTERPATH "location" is the new location of the printer where the file will print, of type string.

  • ALLOWUSERINFO indicates whether to allow users to specify a printer. If this is TRUE, the printer the user specifies is used as the default location, and any printer location you specify is used as a backup location.

  • SCALE scale is the scale at which you want to print documents or reports using this device, of type numeric.

  • PRINTQUALITY "quality" is the quality at which you want to print documents or reports using this device, of type string.

  • PAPERSOURCE "papersource" is the source of the paper, of type string.

  • PAPERSIZE "papersize" is the size of the paper to use, of type string.

  • POSTSCRIPTLEVEL level is the Postscript level to use for PDF printing, of type numeric.

  • EVENODD is whether to print only even numbered pages, only odd numbered pages, or both in PDF printing.

  • REVERSEPAGE is whether to reverse the page order in PDF printing.

  • APPLICATIONPRIORITY (OTHER | ISERVER) is the application that takes print priority, either ISERVER for Intelligence Server, or OTHER for any other application.

  • USEBACKUP indicates whether you want to save reports or documents to a backup location or print to another printer, if printing on the default printer fails.

  • BACKUPTYPE (PRINTER | FILE) is the type of backup location to use, either a different printer location, or a file location.

  • BACKUPLOCATION "location" is the location of the backup printer or file, of type string.

  • NUMBEROFRETRIES num is the number of times to retry printing to the default location before printing to the backup location, of type numeric.

  • TIMEBETWEENRETRY time is how long, in seconds, to wait between retries, of type numeric.

  • DELIVERYTIMEOUT time is how long, in seconds, if the report or document does not print successfully to the default location before the backup location is used, of type numeric.

  • WORKLOCATION "worklocation" is the location where documents can be saved temporarily during execution, of type string.

Example

Copy 
ALTER PRINTDEVICE "Main Print Device" ALLOWUSERINFO 
 FALSE;