Receiving messages from WebSphere MQ

Sources

Complete the following steps to create WebSphere MQ sources. WebSphere MQ is a message queuing system designed by IBM that runs on many platforms such as Windows, Unix, Linux, and z/OS. Barr EOM provides an interface into that queuing system. Barr EOM can then communicate (send and receive messages) with other applications using WebSphere MQ.

This source will receive WebSphere MQ messages.

  1. From the Sources tree, select the source group (folder) where you want to add sources. Right-click and select New Source. The Add Source dialog box displays.

  2. In the Type list, select WebSphere MQ.

  3. Next to Add new devices enter the number of sources you want to create. You can create a single WebSphere MQ source or create multiple WebSphere MQ sources and configure them simultaneously.

  4. Click OK. The configuration tab pages that display are shown differently depending if you chose to create a single source or multiple sources.

  5. Single source configuration - Configuration options are listed on the tab pages.

  6. Multiple source configuration - Sources are configured in grid format on each tab page. The sources you chose to create are displayed as rows in the grids. The configuration options are listed as the column headings. You will need to configure the options for each source row. To configure multiple sources simultaneously, select the check boxes for the appropriate source rows and make the necessary configuration changes. The changes will be applied to all selected rows. You can add and remove sources by clicking Add and Remove below the grid. You can also select sources and click Copy to create copies.

  1. Configure the general settings. For multiple source configuration, this is configured on the General tab.

  1. Enter the source Name.

  2. In the Server list, click the Barr EOM server where the Barr EOM Input Service is located for this source. The source does not have to be on the same server as the Barr EOM Input Service.

  3. Enter any Comments or Location information for the source.

  4. If desired, you can change the large source image that displays when configuring a single source. To do so, click Select Image and choose the appropriate image file (.bmp, jpg, 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.

  1. Configure the WebSphere MQ settings. For single source configuration, use the WebSphere MQ settings tab. For multiple source configuration, use the WebSphere MQ settings tab (Bulk Configuration).

  1. Enter the Queue manager name. This must match the queue manager specified in WebSphere MQ.

  2. Enter the Queue name where received messages will be stored. This must match the queue name specified in WebSphere MQ.

  3. In the Channel name field, enter the channel configured for TCPIP. You can get this name from the WebSphere MQ list of channels.

Make sure the SSL certificate required option is not selected in WebSphere MQ. Barr EOM does not support this at this time.

  1. In the Connection name field, 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.

  1. Configure the document properties that will be applied to all documents received by the source. For single source configuration, use the Document properties tab. For multiple source configuration, use the Document properties tab (Bulk Configuration).

Determine if you want to use advanced document properties. Advanced document properties facilitate the setting of document properties from multiple sources. This is a complex feature that only advanced users and professional service engineers should configure.

  1. Configure the following configuration options. For single source configuration, use the More settings tab. For multiple source configuration, use the More settings tab (Bulk Configuration).

  1. Determine if you want all documents received by this source to be in the Hold state as they enter the EOM Console. This option is disabled by default.

  2. Determine if you want to disable business rule processing for all documents received by this source as they enter the EOM Console. This option is disabled by default.

  3. Use the following options to determine if you want to analyze documents as they are received by a source and enter the EOM Console. Selecting these options may cause performance degradation. These options are disabled by default.

  1. Select the file store that will be used for all documents received by this source as they enter the EOM Console. The default file store is selected by default. Administrators define file stores and select the default in the Set General Preferences Utility. If the default file store is changed in the Set General Preferences Utility, all sources using the default will be automatically updated.

  2. Assign a document folder for all documents received by this source as they enter the EOM Console. The default document folder is Un-Filed Documents.

  3. Select the printing cost per page for black and white and color documents.

  4. Determine if you want to send a notification when a document arrives, prints successfully, prints on failover destination, or is in error state. The notification can be sent as an email message or pop-up. You can select an existing profile in the list or create one from the Notification Profile dialog box. To create a profile during single source configuration, click New. To create during multiple source configuration, click the Browse button.

  1. Configure the following output settings. For single source configuration, use the Output settings tab. For multiple source configuration, click in the grid on the Output settings tab (Bulk Configuration).

  1. Use the Schedule output option to specify the date and time all documents received by this source will print. You can choose to print the documents today, on a specific day, or in the future. You can also choose to print as soon as possible, at a specific time, or in the future.

  2. Use the Route to destination option to specify a destination where all documents received by this source can be routed. Click the Browse button to select one or more destinations in the tree. Use the SHIFT and CTRL keys to select multiple destinations. Destination groups cannot be selected. This option is set to Unrouted by default.

  3. To override the default retain settings for all documents received by this source select the Override default retain settings check box and configure the retain options as necessary.

  4. Select the appropriate output process. 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. You can select an existing process in the list or create one using the Process Designer. To create a process during single source configuration, click New. To create during multiple source configuration, click the Browse button.

  5. Select the appropriate failover profile. Failover profiles specify what should happen to documents when they are sent to inaccessible destinations (they are not able to receive documents). You can select an existing profile in the list or create one from the Failover Profile dialog box. To create a profile during single source configuration, click New. To create during multiple source configuration, click the Browse button.

  1. Click OK.

See also: