Sending Documents to a WebSphere MQ

Complete this procedure to define WebSphere MQ destinations. Documents routed to this destination will be sent as WebSphere MQ messages.

A WebSphere MQ client must be installed separately before you can use this destination.

WebSphere MQ is a message queuing system designed by IBM that runs on many platforms such as Windows, Unix, Linux, and z/OS. Output Manager provides an interface into that queuing system. Output Manager can then communicate (send and receive messages) with other applications using WebSphere MQ.

  1. In the Destinations tree, the destination group (folder) where you want to add destinations, right-click the destination group (folder) where you want to add destinations and click New Destination.
    This opens the Add Destination dialog box.
  2. In the Type list, select WebSphere MQ.
  3. Next to Add new devices, enter the number of destinations you want to create.
    You can create a single destination or create multiple destinations and configure them simultaneously.
  4. Click OK.
  5. Configure the general settings.
    For multiple destination configuration, this is configured on the General tab.
    1. Enter the destination Name.
    2. In the Server list, click the Output Manager server where the Output Manager Output Service is located for this destination.
      The destination does not have to be on the same server as the Output Manager Output Service.
    3. Enter any Comments or Location information for the destination.
    4. Optional: To change the large destination image that displays when configuring a single destination, you can click Select Image and choose the appropriate image file (BMP, JPEG, or PNG).
      The selected image will be compressed and scaled to 96x96 pixels. Changing this image will not change the smaller image that displays or the image that displays in the source tree. To change the image back to the default, click Reset Image.
  6. Configure the WebSphere MQ settings.
    Configuration Method
    Single destination configuration Use the WebSphere MQ settings tab.
    Multiple destination configuration Use the WebSphere MQ settings (Bulk Configuration) tab.
    1. In the Queue manager box, enter the name of the queue manager.
      This must match the queue manager specified in WebSphere MQ.
    2. In the Queue name box, enter the queue name where messages sent to this destination will be stored.
      This must match the queue name specified in WebSphere MQ.
    3. In the Channel name box, enter the channel configured for TCP/IP.
      You can get this name from the WebSphere MQ list of channels.
      CAUTION:
      Make sure the SSL certificate required option is not selected in WebSphere MQ. Output Manager does not support this at this time.
    4. In the Connection name box, enter the IP address and port or DNS name for the server to which you are attempting to connect.
      Messages are transferred over the connection and placed in the queue.

    You can configure a default value and a dynamic override value for most options. Default values are used to manage the documents as they are being sent to the destination. You can choose to dynamically override the default values using document properties and functions. To insert document properties, right-click in the dynamic box and click Insert Document Property. A menu containing all of the available properties displays. You can select a property in the list or type the property name. If a property is selected and it contains a value, that value is processed instead of the default value. To insert functions, right-click in the dynamic box, click Insert Function, and choose the appropriate function. Review the Using Output Manager Functions help topic for information on configuring functions.

  7. Configure options on the More settings tab.
    Configuration Method
    Single destination configuration Use the More settings tab.
    Multiple destination configuration Use the More settings (Bulk Configuration) tab.
    1. Select the printing cost per page for black and white and color documents.
    2. Select the appropriate Printer family.
      Printer families are used to configure commands for print languages and map them to destinations based on their capabilities. You can select an existing printer family in the list or create one in the Printer Family Profile dialog box. To create a printer family during single destination configuration, click New. To create during multiple destination configuration, click the Browse button.
    3. Optional: If you select a Printer family, you can configure Destination specific capabilities.
      These options determine which print preferences/document properties are supported by the destination. To configure destination specific capabilities, click Configure to open the Destination Capabilities dialog box. All of the document properties available to this destination are listed and grouped into categories. Expand the appropriate category by clicking the arrow next to the category name. Select the check boxes for properties you want to be available for configuration throughout Output Manager. Clear the check boxes for properties you do not want to be available. If a property is configured by selecting from a list of options, those options will display beneath the property. Select and clear the check boxes to determine the choices that will be available when those properties are configured. Repeat this step until all properties are configured, and then click OK.
    4. Select the appropriate Output process. You can select an existing process in the list or create one using the Process Designer.
      • To create a process during single destination configuration, click New.
      • To create during multiple destination configuration, click the Browse button.
      Output processes can be created to impact documents as they are being sent to a destination. The processes contain a set of actions which could be used for search and replace, setting finishing options, editing PJL commands, inserting overlays, and so on.
    5. Determine if you want to override the output process assigned to the document and use the selected destination output process.
    6. Select the appropriate Failover profile. You can select an existing profile in the list or create one in the Failover Profile dialog box.
      • To create a profile during single destination configuration, click New.
      • To create during multiple destination configuration, click the Browse button.
      Failover profiles specify what should happen to documents when they are sent to inaccessible destinations (they are not able to receive documents).
    7. Determine if you want to override the failover profile assigned to the document and use the selected destination failover profile.
  8. On the Error handling tab, configure the error handling options.
    Configuration Method
    Single destination configuration Use the Error Handling tab.
    Multiple destination configuration Use the Error Handling (Bulk Configuration) tab.
    1. Select the appropriate Error handling profile. You can select an existing profile in the list, or create one in the Error Handling Profile dialog box. To create a profile during single destination configuration, click New. To create during multiple destination configuration, click the Browse button.
      Error handling profiles specify what should happen to destinations when an error is detected via SNMP or during transmission of a document.
    2. Choose the Default failover destination.
      This specifies what should happen to documents when they are sent to inaccessible destinations (they are not able to receive documents). You can choose to route the documents to a parent group or a specific destination or group. The parent group where the destination currently resides is selected by default.
  9. Click OK.