PublisherQueues

The PublisherQueues are created for use by Visualization Services to manage the publishing and printing of visualization data, as well as related engineering calculations, such as interference detection. Additionally, when content synchronization is needed during the package zip process, Windchill Packages adds entries to PublisherQueues as described later in this topic.

Typically for Visualization Services, CAD data is published following a checkin. As a result, many customer sites use these queues heavily to execute jobs that run for a long time (possibly hours). Each PublisherQueue follows a naming convention of either PublishQueue<queueset>L/M/H or PublishQueue<queueset>N, where L/M/H stand for low/medium/high priorities and N is a sequential integer starting at 1. Queues with the same queueset are termed as a queue set. A default queue set, with an empty string as the name, always exists; all addition queue sets must be declared by the publish.publishqueue.setnames property in wvs.properties. The following queue sets and queues are created out-of-the-box:

All submitted WVS jobs are added to the priority queues (names ending in L, M, or H), depending on the job type, the way the job was submitted, and the type of data. This process is controlled by property settings in wvs.properties. For details, see the following properties in wvs.properties.xconf:

Beginning at Windchill 10.2, PTC has changed the location of the wvs.properties and wvs.properties.xconf files. These files have been moved from the $WT_HOME/codebase directory to the $WT_HOME/codebase/WEB-INF/conf directory. Be sure to make any necessary changes to your code to reflect this location change.

The executing job in an L, M, or H priority queue is looking for an available number queue (names ending with a sequential number N) in the same queue set. If it finds one, it submits the WVS job to that queue, which immediately executes it. By default, only one number queue is created for each queue set. Additional publish queues (for example, PublisherQueue2, PublisherQueue3, PublisherQueueCLASH2, and so on) can be created with the Windchill Queue Management utility for scalability.

The objects stored in the queue entries are com.ptc.wvs.server.publish.PublishJob, com.ptc.wvs.server.publish.ClashJob, or com.ptc.wvs.server.publish.PrintJob objects. You can view details of these WVS jobs from the WVS Job Monitor. If a job has failed, use the log information of the queue entry (shown in the WVS Job Monitor) to investigate why it failed. After fixing the problem, resubmit the job.

The submission of print, publish, and interference detection jobs from L, M, or H queues to the numbered processing queues are supported when those numbered queues are in different background method servers.

When exporting and zipping Windchill Packages, entries can be added to one of the default PublisherQueues, such as PublisherQueue1. The purpose of these entries is to update any CAD content being exported to include any Windchill metadata changes related to that content.

To use queues for CAD content synchronization when exporting and zipping packages, specific package preferences must be set. For preference details, see Setting Package Preferences.

When package preferences are set to enable the use of queues, the queue processing used is the same processing that is used by the Visualization Services when it generates representations. The objects stored in package queue entries are com.ptc.wvs.server.publish.PublishJob objects. Therefore, the Windchill Package queue entries have the same attributes as entries from Visualization Services. Similarly, you can view details of these jobs from the WVS Job Monitor. If a job has failed, use the log information of the queue entry (shown in the WVS Job Monitor) to investigate why it failed. After fixing the problem, repeat the package export.