An IQUEUE definition defines the input queue on which Event Replicator for Adabas should listen for requests from webMethods EntireX and WebSphere MQ targets. At least one definition is required for every webMethods EntireX or WebSphere MQ target you intend to use.
You can create webMethods EntireX and WebSphere MQ input queue definitions using Event Replicator Administration. This document covers the following topics:
To use Event Replicator Administration to list the IQUEUE definitions stored in the Replicator
system file:
Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.
Click and expand Replication Definitions in tree-view under the selected database.
Click on Input Queues in the tree-view under Replication Definitions.
A table listing the IQUEUE definitions in the Replicator system file appears in detail-view.
Prior to using webMethods EntireX as the messaging subsystem, be sure to read Using webMethods EntireX as the Messaging System, in Event Replicator for Adabas Administration and Operations Guide provided with your Event Replicator Administration documentation.
To use Event Replicator Administration to add a webMethods EntireX IQUEUE definition to the
Replicator system file:
List the IQUEUE definitions in Event Replicator Administration, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed in detail-view.
Right-click on Input Queues in the tree-view under Replication Definitions.
A drop-down menu appears.
Click on Create New EntireX Broker Input Queue Definition in the drop-down menu.
A blank EntireX Broker Input Queue panel appears in detail-view.
Fill in the fields in Value columns of the detail-view table as described below:
| Parameter Name | Specify | Default |
|---|---|---|
| Input Queue Name (IQUEUE NAME) | A unique name for the IQUEUE definition. The name must use alphanumeric characters and be between one and 8 characters long. | --- |
| Broker ID (IQETBBROKERID) | The webMethods EntireX Broker ID you want used
for this IQUEUE definition. For the valid values of this parameter, check with
your webMethods EntireX Broker development staff and the webMethods EntireX
Broker documentation. A maximum of 32 characters can be specified.
Broker IDs come in two formats: one for TCP/IP communications and one for Adabas SVC communication. For TCP/IP communications, the format is: ip-address:port-number:TCP In this case, the ip-address setting is the TCP/IP IP address and the port-number setting should match the webMethods EntireX PORT parameter. For Adabas SVC communications, the format is: 'broker-id:SVCnnn:NET' In this case, the broker-id setting should match the webMethods EntireX BROKER-ID parameter in the Broker ETBFILE DD. The nnn setting should match either the webMethods EntireX ADASVC or ADA5SVC parameters in the Broker PARMS DD statement. |
ETBBROKERID value |
| Broker Service (IQETBSERVICE) | The webMethods EntireX service you want used for this IQUEUE definition. This should be the same as the value specified for the SERVICE parameter in webMethods EntireX. The ID can be up to 32 characters long. For the valid values of this parameter, check with your webMethods EntireX Broker development staff and the webMethods EntireX Broker documentation. | --- |
| Service Name (IQETBSERVICENAME ) | The name of the webMethods EntireX service you want used for this IQUEUE definition. This should be the same as the value specified for the SERVER parameter in webMethods EntireX. The name can be up to 32 characters long. For the valid values of this parameter, check with your webMethods EntireX Broker development staff and the webMethods EntireX Broker documentation. | --- |
| Service Class (IQETBSERVICECLASS) | The webMethods EntireX service class you want used for this IQUEUE definition. This should be the same as the value specified for the CLASS parameter in webMethods EntireX. The name can be up to 32 characters long. For the valid values of this parameter, check with your webMethods EntireX Broker development staff and the webMethods EntireX Broker documentation. | --- |
| Input Queue Buffer Length (IQBUFLEN parameter) | The length, in bytes, of the input buffer
associated with this input queue. Valid values range from
"2048" through
"2,147,483,647". However, the practical maximum
value is restricted by the amount of virtual storage available in the Event Replicator Server
address space. If you enter a value less than
"2048", "2048" is used.
This is the equivalent of specifying the IQBUFLEN parameter in the Event Replicator Server startup job. This value should be set to a value greater than or equal to the largest message that will be received by the input queue. When the input queue will receive data as a part of node-to-node replication, the largest message will be limited by the minimum of the following Event Replicator Server settings: MAXOUTPUTSIZE parameter, DMAXOUTPUTSIZE parameter (if specified for the destination), or the message limit imposed by the messaging system. |
2048 |
| Open Retry Count(IQRETRYCOUNT parameter) | The number of times that an attempt to open
the input queue will be retried at the interval specified by the
Retry Interval parameter. This is
the equivalent of specifying the
IQRETRYCOUNT parameter directly in the
Event Replicator Server startup job.
Valid values range from 0 through 2,147,483,647 or the literal "GLOBAL". If the value "GLOBAL" is specified for this parameter, the specification for the Retry Count global variable will be used. Any retry attempts will occur at the interval specified by the Retry Interval parameter. A value of zero indicates that no retry attempt to open this input queue should occur. |
The value of the Retry Count global variable |
| Open Retry Interval (IQRETRYINTERVAL parameter) | The default number of seconds between retry
attempts to open the input queue identified by this definition. This is the
equivalent of specifying the
IQRETRYINTERVAL parameter directly in
the Event Replicator Server startup job.
Valid values are 0, 5 through 2,147,483,647, or the literal "GLOBAL". If the value "GLOBAL" is specified for this parameter, the specification for the Retry Interval global variable will be used. A value of zero indicates that no retry attempt to open this input queue should occur. Except for a specification of zero, the minimum value that can be specified for this parameter is 5 seconds. |
The value of the Retry Interval global variable |
When all specifications have been made to your satisfaction, click to save the IQUEUE definition.
Prior to using WebSphere MQ as the messaging subsystem, be sure to read Using WebSphere MQ as the Messaging System, in Event Replicator for Adabas Administration and Operations Guide provided with your Event Replicator Administration documentation.
To use Event Replicator Administration to add a WebSphere MQ IQUEUE definition using the
Replicator system file:
List the IQUEUE definitions in Event Replicator Administration, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed in detail-view.
Right-click on Input Queues in the tree-view under Replication Definitions.
A drop-down menu appears.
Click on Create New MQSeries Input Queue Definition in the drop-down menu.
A blank MQSeries Input Queue panel appears in detail-view.
Fill in the fields in Value columns of the detail-view table as described below:
| Parameter Name | Specify | Default |
|---|---|---|
| Input Queue Name (IQUEUE NAME) | A unique name for the IQUEUE definition. The name must use alphanumeric characters and be between one and 8 characters long. | --- |
| Queue Manager Name (IQMQQMGRNAME) | The name of the WebSphere MQ queue manager you want used for this IQUEUE definition. The name can be up to 48 characters long. For the valid values of this parameter, check with your WebSphere MQ development staff and the WebSphere MQ documentation. | --- |
| MQ Queue name (IQMQQNAME) | The name of the WebSphere MQ queue you want used for this IQUEUE definition. The name can be up to 48 characters long. For the valid values of this parameter, check with your WebSphere MQ development staff and the WebSphere MQ documentation. | --- |
| Open Retry Count(IQRETRYCOUNT parameter) | The number of times that an attempt to open
the input queue will be retried at the interval specified by the
Retry Interval parameter. This is
the equivalent of specifying the
IQRETRYCOUNT parameter directly in the
Event Replicator Server startup job.
Valid values range from 0 through 2,147,483,647 or the literal "GLOBAL". If the value "GLOBAL" is specified for this parameter, the specification for the Retry Count global variable will be used. Any retry attempts will occur at the interval specified by the Retry Interval parameter. A value of zero indicates that no retry attempt to open this input queue should occur. |
The value of the Retry Count global variable |
| Open Retry Interval (IQRETRYINTERVAL parameter) | The default number of seconds between retry
attempts to open the input queue identified by this definition. This is the
equivalent of specifying the
IQRETRYINTERVAL parameter directly in
the Event Replicator Server startup job.
Valid values are 0, 5 through 2,147,483,647, or the literal "GLOBAL". If the value "GLOBAL" is specified for this parameter, the specification for the Retry Interval global variable will be used. A value of zero indicates that no retry attempt to open this input queue should occur. Except for a specification of zero, the minimum value that can be specified for this parameter is 5 seconds. |
The value of the Retry Interval global variable |
When all specifications have been made to your satisfaction, click to save the IQUEUE definition.
To use Event Replicator Administration to modify an IQUEUE definition in the Replicator system
file:
List the IQUEUE definitions in Event Replicator Administration, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed in detail-view.
Locate the definition you want to modify in the table in detail-view and click on it.
The appropriate IQUEUE definition panel appears in detail-view listing the current settings for the IQUEUE definition you selected.
Click the button.
The IQUEUE parameters you can modify become editable in detail-view. For information on modifying these parameters, read the description of the creation of that type IQUEUE definition, elsewhere in this section.
When all modifications have been made, click to save the changes or click to cancel the changes.
To use Event Replicator Administration to copy an IQUEUE definition in the Replicator system
file:
List the IQUEUE definitions in Event Replicator Administration, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed in detail-view.
Locate the definition you want to copy in the table in detail-view and click on it.
The appropriate IQUEUE definition panel appears in detail-view listing the current settings for the IQUEUE definition you selected.
Click the Copy button.
A copy of the IQUEUE definition is created and its parameter values appear in detail-view.
Specify a new, unique name for the copy of the IQUEUE definition in the Value column for the Input Queue Name parameter.
If you wish, modify any other parameters for the new copy in detail-view. For information on modifying the parameters, read the description of the creation of that type IQUEUE definition, elsewhere in this section.
When all modifications have been made, click to save the changes or click to cancel the copy.
You can use Event Replicator Administration to open and close IQUEUE definitions. This section covers the following topics:
To use Event Replicator Administration to open an IQUEUE:
Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.
Click and expand Active Parameters in tree-view under the selected database.
Click and expand Replication in tree-view under Active Parameters.
Click on Input Queues in the tree-view under Replication.
A table listing the IQUEUE definitions in the Replicator system file appears in detail-view.
In detail-view, click on the name of the definition you want to open.
Details about the IQUEUE definition appear in detail-view.
Click the Open button.
The IQUEUE is opened.
To use Event Replicator Administration to close an IQUEUE:
Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.
Click and expand Active Parameters in tree-view under the selected database.
Click and expand Replication in tree-view under Active Parameters.
Click on Input Queues in the tree-view under Replication.
A table listing the IQUEUE definitions in the Replicator system file appears in detail-view.
In detail-view, click on the name of the definition you want to close.
Details about the IQUEUE definition appear in detail-view.
Click the Close button.
The IQUEUE is closed.
To use Event Replicator Administration to delete an IQUEUE definition in the Replicator system
file:
List the IQUEUE definitions in Event Replicator Administration, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed in detail-view.
Locate the definition you want to delete in the table in detail-view and click on it.
The appropriate IQUEUE definition panel appears in detail-view listing the current settings for the IQUEUE definition you selected.
Click the Delete button.
A confirmation panel appears verifying that you want to delete the definition. If you click (indicating that you do want to delete the definition), the definition is deleted. If you click (indicating that you do not want to delete the definition), the definition is not deleted.
