User Interface: Jobs

You can use Jobs in Status Status to view the status of print jobs and search for print jobs with specific characteristics.

Ribbon Commands

Icon	Command	Description
	New	Open a new job search tab.
	Open	Open an existing job search.
	Save	Save the search that is currently displayed. You can change the name of this search by typing a different name in the Search Name field.
	Delete	Close and delete the current search.

File Menu

Command	Description
Close	Close the current search.
Close All	Close all searches that you have open.
Save	Save the search that is currently displayed. You can change the name of this search by typing a different name in the Search Name field.

Search Criteria

You can enter search criteria to filter the list of jobs What is submitted for processing. A job is separated into print jobs and print job details based on the processing rules. A job defines which processes to use. or job details A digital representation of a label generated by a print job. Job details can be altered during the print job by using Formula data sources, Script data sources, and business rules. displayed. You can limit the jobs or job details displayed to only those with specific IDs, names, or statuses, submitted by a particular user, for a particular label template, or assigned to a particular target device. You can also limit the jobs or job details based on when they were last modified, whether they included successes, or whether they included failures.

Click Search to display the list of jobs or job details filtered by the entered criteria.

Search Tips

Successes and Failures

You can limit the jobs displayed to include only those that included successes, did not include successes, included failures, or did not include failures. To filter the list of jobs based on whether successes and failures did or did not occur, configure the three-position check boxes.

Successes/ Failures	Description
	Show jobs regardless of the value of this property.
	Show jobs for which the value is true. For Successes, this indicates that the job included successes. For Failures, this indicates that the job included failures.
	Show jobs for which the value is false. For Successes, this indicates that the job did not include successes. For Failures, this indicates that the job did not include failures.

Successes/

Failures

Description

Show jobs regardless of the value of this property.

Show jobs for which the value is true.

For Successes, this indicates that the job included successes.

For Failures, this indicates that the job included failures.

Show jobs for which the value is false.

For Successes, this indicates that the job did not include successes.

For Failures, this indicates that the job did not include failures.

Date Range

You can limit the jobs displayed to include only those that were last modified within a specific time range, before a specific time, or after a specific time.

To view all jobs that were last modified within a time range, enter that range in the From and To fields.
To view all jobs that were last modified after a specific time, enter the time in the From field. Leave the To field blank.
To view all jobs that were last modified before a specific time, enter the time in the To field. Leave the From field blank.

Job Search

Toolbar

The following commands are available in the job search toolbar.

	Command	Effect
	Open Job Search	Open a new Job Details Search tab filtered to the selected Job ID.
	Inspect Job	If a job is selected, display Job Inspector information about any errors and about the data processed.
	Download Results	Download the search results for the current search to a comma-delimited text file (CSV). You can view this file in a spreadsheet application such as Microsoft Excel.
	Cancel Job	Cancel the job currently running on the device.

Properties

The following are the properties of print jobs What is submitted for processing. A job is separated into print jobs and print job details based on the processing rules. A job defines which processes to use. . These properties are displayed in the results of searches, and you can search for specific jobs based on most of these criteria.

Tip: You can click a table header to sort the table by that column. Also, for any table column for which a search box is displayed, you can enter search text to filter the results displayed in the table.

Property	Description
Status icon	Indicates the current state of a job: Job contains successes and no failures. Job contains successes and failures. Job contains failures and no successes.
ID	A unique identifier for a print job.
Name	An identifier for a print job provided by the integration that initiated the job. On-demand print jobs and previews do not have job names.
Status	The current state of a print job. Running: The print job is being prepared for processing. Processing: The print job is being processed, which includes being printed. Errored: An error occurred during processing. Done: The print job has finished processing. Paused: The print job has been halted but may be continued. Suspended: The print job has been halted but may be continued. Canceled: The print job has been halted and cannot be continued.
Location	The name of the facility from which the print job was submitted, or Local if the print job was submitted at headquarters. Note: This property is displayed only if you have a multi-site license for Spectrum and you are logged on to the headquarters site.
Submitter	The user name of the person who submitted a print job or the user account used to submit the job. For a print job submitted via an integration, this is the Run As user for the integration.
Submitted Date	The date and time when a print job was submitted to the device queue.
Modified Date	The date and time when a print job was most recently changed.

Job Details Search

Toolbar

The following commands are available in the job details search toolbar.

	Command	Effect
	Open Job Search	Open a new Job Details search tab filtered to the selected Job ID.
	Reprint	Reprint a recently printed job or range of labels within the job. A dialog box allows you specify the range of labels within the job, the quantity, and the device to use. Note: To use this command, you must have Reprint permission for the relevant objects. Object-based and role-based Reprint permissions are required.
	Inspect Job	If a job is selected, display Job Inspector information about any errors and about the data processed.
	Download Results	Download the search results for the current search to a comma-delimited text file (CSV). You can view this file in a spreadsheet application such as Microsoft Excel.

Properties

The following are the properties of print job details A digital representation of a label generated by a print job. Job details can be altered during the print job by using Formula data sources, Script data sources, and business rules.. These properties are displayed in the results of searches, and you can search for specific job details based on most of these criteria.

Property	Description
Status icon	Indicates the current state of a job detail: Job detail completed printing. Job detail failed.
Job ID	A unique identifier for a print job.
Job Detail ID	A unique identifier for the print job detail provided by the integration that initiated the job. On-demand print jobs and previews do not have job detail IDs.
Print Job ID	An identifier for the collection of print job details submitted in the job.
Job Name	An identifier for a print job provided by the integration that initiated the job. On-demand print jobs and previews do not have job names.
Job Detail Name	An identifier for a print job detail provided by the integration that initiated the job. On-demand print jobs and previews do not have job detail names.
Document	The path and name of the label template being used to print a label or labels, followed by the version number if applicable. !INLINE_DOCUMENT! is displayed for a pass through file.
Device	The device that received and processed a print job.
Status	The current state of a job detail. Submitted: The print job has been posted, but is not yet in the device queue. Queued: The print job is in the device queue. Paused: The print job has been halted but may be continued. Printing: The print job is being printed. Completed: The print job finished successfully. Errored: An error occurred. Canceled: The print job has been halted and cannot be continued. Completed Errored: An error occurred after this job detail was completed, but before the entire job was completed. Errored Completed: An error occurred before this job detail was sent to the device. The job may or may not have been printed. Printing Errored: The print job is being printed, but an error has occurred. After the print job is complete, its status changes to Errored Completed. Web Printing: The print job has been submitted to Spectrum Remote Print. The Spectrum Remote Print client must be connected for the job to be forwarded to the local device. Web Print Requested: The print job has been submitted to Spectrum Remote Print. The Spectrum Remote Print client accepted the job, but has not printed to the local device.
Location	The name of the facility from which the print job was submitted, or Local if the print job was submitted at headquarters. Note: This property is displayed only if you have a multi-site license for Spectrum and you are logged on to the headquarters site.
Submitter	The user name of the person who submitted a print job or the user account used to submit the job. For a print job submitted via an integration, this is the Run As user for the integration.
Submitted Date	The date and time when a print job was submitted to the device queue.
Modified Date	The date and time when a print job was most recently changed.

Job Inspector

You can select a job or job detail and click Inspect Job to display the Job Inspector window.

Job

The following is displayed in the Job panel of the Job Inspector for a print job or print job detail.

Property	Description
ID	A unique identifier for the print job.
Name	An identifier for the print job provided by the integration that initiated the job. On-demand print jobs and previews do not have job names.
Action	Whether the print job is a test print. RUN: The print job is not a test print. TEST RUN: The print job is a test print.
Status	The current state of the print job. Running: The print job is being prepared for processing. Processing: The print job is being processed, which includes being printed. Errored: An error occurred during processing. Done: The print job has finished processing. Paused: The print job has been halted but may be continued. Suspended: The print job has been halted but may be continued. Canceled: The print job has been halted and cannot be continued.
Location	The name of the facility from which the print job was submitted, or Local if the print job was submitted at headquarters. Note: This property is displayed only if you have a multi-site license for Spectrum and you are logged on to the headquarters site.
Target Folder	The folder that contains status information about the print job.
Batch Count	The number of batches of print jobs created for the job.
Process Count	The number of processes created for the job.
Audit Level	The Audit Mask set on the print job during the printing process. The Audit Mask is whether to save data from the label, the print stream, an image of the label, a PDF of the label, or the data from the label in XML format to an audit table in Spectrum. Note: The Audit Level of the print job can be defined during the printing process and may be different from the Audit Mask on the job process.
Client Code	A unique identifier for the print job provided by the client that generated the job.
Created By	The user name of the person who submitted the print job or the user account used to submit the job. For a print job submitted via an integration, this is the Run As user for the integration.
Created On	The date and time when the print job was submitted to the device queue.
Modified By	The user name of the user who most recently made changes to the print job.
Modified On	The date and time when the print job was most recently changed.
Successes	Whether successes have occurred during processing.
Failures	Whether failures have occurred during processing.
Error Code	The error code value for the reason the job failed. This is an internal identifier, but may help with problem resolution.
Processing Time (ms)	The job processing time in milliseconds. One second is equivalent to 1000ms.

Job Detail

In addition to the Job properties, the following is displayed in the Job Detail panel of the Job Inspector for a print job detail.

Property	Description
Job Detail ID	A unique identifier for the print job detail provided by the integration that initiated the job. On-demand print jobs and previews do not have job detail IDs.
Print Job ID	An identifier for the collection of print job details submitted in the job.
Status	The current state of the job detail. Submitted: The print job has been posted, but is not yet in the device queue. Queued: The print job is in the device queue. Paused: The print job has been halted but may be continued. Printing: The print job is being printed. Completed: The print job finished successfully. Errored: An error occurred. Canceled: The print job has been halted and cannot be continued. Completed Errored: An error occurred after this job detail was completed, but before the entire job was completed. Errored Completed: An error occurred before this job detail was sent to the device. The job may or may not have been printed. Printing Errored: The print job is being printed, but an error has occurred. After the print job is complete, its status changes to Errored Completed. Web Printing: The print job has been submitted to Spectrum Remote Print. The Spectrum Remote Print client must be connected for the job to be forwarded to the local device. Web Print Requested: The print job has been submitted to Spectrum Remote Print. The Spectrum Remote Print client accepted the job, but has not printed to the local device.
Name	An identifier for a job detail provided by the integration that initiated the job. On-demand print jobs and previews do not have job detail names.
Device Group	The device that received and processed the print job.
Batch	The unique identifier of the print job batch that the print job detail belongs to.
Priority	The number of the job detail in the device queue. The number of the order the job detail is processed in the device queue.
Quantity	The number of labels printed by the job detail.
Copies	The number of copies printed by the job detail.
Total Print Time (ms)	The print job time in milliseconds. One second is equivalent to 1000ms.
Created By	The user name of the person who submitted the job detail or the user account used to submit the job detail. For a print job submitted via an integration, this is the Run As user for the integration.
Created On	The date and time when a print job was submitted to the device queue.
Modified By	The user name of the user who most recently made changes to the job detail.
Modified On	The date and time when the print job detail was most recently changed.
Error Reason	The reason provided by a user for changing the status of the print job to Errored, if applicable. Point to the icon to display the full text.