8.2 Email Printing Commands

You can print the body of the email and the attachments by using a few simple print commands in the subject line of your email.

8.2.1 Basic Print Commands

help

Provides information on email printing commands.

list printers

To get the names of the available printers, send an email to the iPrint server address (for example, iprint@novell.com) with the subject line list printers.

print printer=<printer_name>

Prints your email and its attachments to the specified printer. For example, print printer=hp#Test Mail.

If you print to a specific printer by using the printer’s email address, the print printer command is ignored.

hold printer=<printer_name>

Queues your email along with its attachments and sends you the job ID as acknowledgement.

resume

Resumes the printing of a job that you put on hold. There are two ways to print a job on hold:

  • Send an email with subject resume followed by the job ID. For example, resume 10

  • Send an email with the original subject line prefixed with resume. For example, resume#Test Mail

cancel

Cancels a job that you put on hold. There are two ways to cancel a job on hold:

  • Send an email with subject cancel followed by the job ID. For example, cancel 10

  • Send an email with the original subject line prefixed with cancel. For example, cancel#Test Mail

status

Displays the status of a job. There are two ways to check the status of a job:

  • Send an email with subject status followed by the job ID. For example, status 10

  • Send an email with the original subject line prefixed with status. For example, status#Test Mail

move

Moves a job to a new printer. There are two ways to move a job to a new printer:

  • Send an email with subject move, the job ID, and the name of the new printer. For example, move 10 printer=<PrinterName>

  • Send an email with the original subject line prefixed with move, the name of the new printer, and #. For example, move printer=<PrinterName>#Test Mail

list jobs

Lists the details of the held jobs.

default printer

Displays the default printer.

default printer=<PrinterName>

Sets a particular printer as your default printer. After you set the default printer, you do not need to include the printer name while printing to the default printer. You only need to use the print command followed by the email subject. For example, print#Test Mail.

NOTE:If a printer name contains spaces, enclose the printer name within double (") or single (') quotes. For example, print printer='HP PRINTER'.

NOTE: To separate the email subject from the command, use #. For example, print printer=hp#Test Mail.

8.2.2 Additional Print Commands

In addition to the basic print commands listed above, you can use these commands to refine your printing:

portrait [portrait=yes/portrait=y (or) portrait=no/portrait=n]

Prints your email content in portrait orientation. For example, print printer=hp portrait=y#Test Mail

landscape [landscape=yes/landscape=y (or) landscape=no/landscape=n]

Prints your email content in landscape orientation. For example, print printer=hp landscape=y#Test Mail

color [color=yes/color=y (or) color=no/color=n]

Prints your email content in color. For example, print printer=hp landscape=y color=y#Test Mail.

pages

Prints a given range of pages in your email. For example, the command print printer=hp landscape=y color=y pages=1-3#Test Mail prints pages 1, 2, and 3.

copies

Prints the specified number of copies of your email and its attachments. For example, the command print printer=hp landscape=y color=y pages=1-3 copies=5#Test Mail prints 5 copies of pages 1, 2, and 3.

duplex [duplex=yes/duplex=y (or) duplex=no/duplex=n]

Prints your email and its attachments on both sides of the printing paper. For example, the command print printer=hp landscape=y color=y pages=1-3 copies=5 duplex=y#TestMail prints 5 copies of pages 1, 2, and 3 in duplex mode.

media

Prints your email and its attachments with the specified paper type. The default paper type is “LETTER.” You can change the default paper type by using the iPrint Appliance Management Console. The other available print paper types are A3, A4, and other common paper types. For example, the command print printer=hp landscape=y color=y pages=1-3 copies=5 duplex=y media=A3#Test Mail prints 5 copies of pages 1, 2, and 3 in duplex mode, on an A3 size paper.

mailbody [mailbody=yes/mailbody=y (or) mailbody=no/mailbody=n]

Prints either your email and its attachments or only the attachments from your email without the email body. For example, using the command print printer=hp landscape=y color=y mailbody=n#Test Mail prints only the email attachments in landscape mode.

NOTE:If you do not specify any of the additional commands, your print job is carried out according to the default preferences set by your administrator.

IMPORTANT:When printing to a specific printer using the printer’s private email address, you do not need to specify the printer’s name in the command. You can also leave the subject line empty. Printing is carried out according to the default print options set by the administrator.

However, you must specify the print command in the following scenarios:

  • The administrator changes the subject_optional_for_printer_specific_emails to False in the iPrint Appliance Server Configuration file located at /etc/opt/novell/iprintmobile/conf/iprintmobile.conf.

  • If you want to customize the print options, you must specify the print command, along with the required print options. For example, print landscape=y color=y pages=1-3 copies=5 duplex=y media=A3#Test Mail.