Device Queue (ttaad3120s000)

Use this session to maintain the printer-queue data.

The output requests for all devices are kept in a queue, except when the Device Type is Direct.

When a print job is finished, the print request status changes to Done. When the delete-delay time has passed, the temporary file in ${BSE_TMP} is removed by the printer daemon. Although the request status is changed to Removed, the request is not deleted from the printer queue table. However, a print request with the Removed status cannot be displayed or reprinted.

The printer-queue data consists of two parts divided over two tabs. The General tab shows who made the request, the contents of the request, and the selected device. The Details/status tab shows print details, such as the print date/time, the paper type, and the print request’s status.

For more information on print job statuses, see the online help of the Status field.

Depending on the status, you can change the information in the second part of the printer-queue data.

  • If the status is Error, you can change the paper type and set the status to Waiting or Active to repeat the request.
  • If the status is Waiting, Active, or Done, you can change the status to Preserved.
Note: You cannot use this session to delete requests from the printer queue. To do this, you must use the Purge Device Queue (ttaad3221m000) session.

Field Information

User

The user who has started the print job.

User

The name of the user.

Sequence Number

The sequence number used to distinguish different requests from the same user.

Company

The company number in which the request was made.

Company

The company's name.

Session

The package code of the session in which the report was created.

Session

The module code of the session in which the report was created.

Session

The session code of the session in which the report was created.

Report

The package code of the report.

Report

The module code of the report.

Report

The report code.

Output File

The file (including the path) containing the report output.

Note: The Device Type must be Append to file or Rewrite file.
Error Message

If the print job fails, an error message is displayed here.

Device

The device to which the output must be sent.

Driver

The ${BSE}/lib/printinf directory contains the subdirectories in which the device drivers are defined. The device driver names consist of the first letter of the device in question.

Example

You can find the device driver of a Mannesmann Tally 910 printer under the ${BSE}/printinf/m directory in the mt910 file.

In the above example, you must enter mt910 as the name of the device driver in the Driver field. The file contains information on Esc/Ctrl codes for fonts, reverse, underline, bold, and so on.

Device Type

The output device type.

Print Date/Time

The date on which the report must be sent to the device.

/

The time the report must be sent to the device.

Paper Type

The paper type on which the output file must be printed.

Note: You can define paper types in the Paper Types (ttaad3110m000) session.
Printer

The client printer. This field is only visible in case of a Window Server Printer placeholder device for client printers (see Device Data (ttaad3500m000)).

Font

The font that is selected for the paper type.

Number of Copies

The number of copies of the print job that was requested by the user.

From/To Page

The first page to be sent to the device.

From/To Page

The last page to be sent to the device.

Delete Delay

the time (in hours) between handling a print request and deleting the temporary file that stored the print request.

Note: You can specify a delete-delay time for each user in the User Data Template (ttams1110m000) session.
Left Margin

Shows the left margin for reports that are sent to a physical printer.

If a left margin is defined for the report in the Reports (ttadv3130s000) session, then the total size of the left margin is the value entered in this field plus the value entered in the Reports (ttadv3130s000) session.

Priority

The print job’s priority status.

Status

The print-request status.

Allowed values

Premature

The request is being created.

Waiting

The request has been created and is waiting to be printed.

Being converted

The printer daemon is converting the print file to a temporary file, which is suitable for a specific printer.

Active

The request is being executed.

Canceled

The request with status Being converted or Active or Waiting has been canceled in the Cancel Device Requests by User (ttaad3220m000) session or in the Cancel Device Requests by Device (ttaad3230m000) session.

Error

An error has occurred during the print, for example, during the conversion of the print file. The reason is displayed in the Error Message field in the Device Queue (ttaad3120s000) session. For more details about the error, see the printer daemon log file in the ${BSE}/log directory.

Done

The request has been executed. You can reprint the request through the Device Queue (ttaad3520m000) session.

The request's print file is removed automatically when the delete delay time has passed. The request's status changes to Removed. To prevent the file from being removed, “preserve” your request through the Device Queue (ttaad3520m000) session.

Removed

The request's print file is removed because the delete delay time has expired. The request stays in the printer queue table but cannot be reprinted.

Preserved

The request's print file will not automatically be removed when the delete delay time has expired. Use the Device Queue (ttaad3520m000) session to change the request status to Preserved, and to reprint the file.

Paper Error

A paper error occurred during the print of the print request.

Killed

The print request is terminated.

Canceled by

The code of the user who canceled/killed the request.

Canceled [Dt/Tm]

The date on which the request was canceled/killed.

/

The time at which the request was canceled/killed.