An IQUEUE definition defines the input queue on which Event Replicator for Adabas should listen for requests from EntireX Communicator and MQSeries targets. At least one definition is required for every EntireX Communicator or MQSeries target you intend to use.
This document covers the following topics:
To use the Adabas Event Replicator Subsystem to list the IQUEUE definitions stored in the
Replicator system file:
Select option from the Adabas Event Replicator Subsystem Main Menu.
The List of IQUEUE Definitions screen appears showing all of the IQUEUE definitions in the Adabas Event Replicator Subsystem.
10:03:52 ***** A D A B A S EVENT REPLICATOR SUBSYSTEM ***** 2007-06-15
List of Input Queue Definitions M-RP1300
Sel Name Typ Sel Name Typ Sel Name Typ Sel Name Typ
----------------- ----------------- ----------------- ----------------
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
_ _ _ _
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Add - + Menu |
To use the Adabas Event Replicator Subsystem to add an IQUEUE definition to the Replicator
system file:
Select option from the Adabas Event Replicator Subsystem Main Menu.
The List of IQUEUE Definitions screen appears.
Press PF4 on the List of IQUEUE Definitions screen.
The Create New IQUEUE Definition screen appears.
09:53:52 ***** A D A B A S EVENT REPLICATOR SUBSYSTEM ***** 2007-06-15
Create New IQUEUE Definition M-RP1390
Code Function
---- -------------------------------------
M Create MQ Input Queue Definition
E Create Broker Input Queue Definition
? Help
. Exit
---- -------------------------------------
Code ... _
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Menu |
Select the code on this screen corresponding to the type of IQUEUE definition you need.
The appropriate IQUEUE definition screen appears for the selected IQUEUE type. For more information, read one of the following:
Be sure to read Using EntireX Communicator as the Messaging System prior to using EntireX Communicator as the messaging subsystem.
To use the Adabas Event Replicator Subsystem to add an EntireX Communicator IQUEUE definition
to the Replicator system file:
Select option on the Create New IQUEUE Definition screen.
The EntireX Broker Input Queue Definition screen appears.
15:19:33 ***** A D A B A S EVENT REPLICATOR SUBSYSTEM ***** 2007-06-28
EntireX Broker M-RP1320
Input Queue Definition
Input Queue Name ............ ________
Broker ID ................... ________________________________
Broker Service .............. ________________________________
Service Name ................ ________________________________
Service Class ............... ________________________________
Input Queue Buffer Length ... ______2048
Retry Interval .............. GLOBAL____
Retry Count ................. GLOBAL____
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Save Menu |
Update the fields on this screen as described in the following table.
| Parameter Name | Specify | Default |
|---|---|---|
| Broker ID | The EntireX Communicator Broker ID you want
used for this IQUEUE definition.
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 EntireX Communicator PORT parameter. For Adabas SVC communications, the fomat is: 'broker-id:SVCnnn:NET' In this case, the broker-id setting should match the EntireX Communicator BROKER-ID parameter in the Broker ETBFILE DD. The nnn setting should match either the EntireX Communicator ADASVC or ADA5SVC parameters in the Broker PARMS DD statement. This is the equivalent of specifying the IQETBBROKERID parameter in the Event Replicator Server startup job. |
ETBBROKERID value |
| Broker Service | The EntireX Communicator service you want
used for this IQUEUE definition. This should be the same as the value specified
for the SERVICE parameter in EntireX Communicator. The ID can be up to 32
characters long.
This is the equivalent of specifying the IQETBSERVICE parameter in the Event Replicator Server startup job. |
--- |
| Input Queue Buffer Length | 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. |
2048 |
| Input Queue Name | A unique name for the IQUEUE definition. The
name must use alphanumeric characters and be between one and 8 characters long.
This is the equivalent of specifying the IQUEUE NAME parameter in the Event Replicator Server startup job. |
--- |
| Retry Count | 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 |
| Retry Interval | 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 |
| Service Class | The EntireX Communicator service class you
want used for this IQUEUE definition. This should be the same as the value
specified for the CLASS parameter in EntireX Communicator. The name can be up
to 32 characters long.
This is the equivalent of specifying the IQETBSERVICECLASS parameter in the Event Replicator Server startup job. |
--- |
| Service Name | The name of the EntireX Communicator service
you want used for this IQUEUE definition. This should be the same as the value
specified for the SERVER parameter in EntireX Communicator. The name can be up
to 32 characters long.
This is the equivalent of specifying the IQETBSERVICENAME parameter in the Event Replicator Server startup job. |
--- |
Press PF5 to save the IQUEUE definition.
Be sure to read Using MQSeries as the Messaging System prior to using EntireX Communicator as the messaging subsystem.
To use the Adabas Event Replicator Subsystem to add an MQSeries IQUEUE definition to the
Replicator system file:
Select option on the Create New IQUEUE Definition screen.
The MQSeries Input Queue Definition screen appears.
15:39:40 ***** A D A B A S EVENT REPLICATOR SUBSYSTEM ***** 2007-06-28
MQSeries M-RP1310
Input Queue Definition
Input Queue Name ........... ________
Queue Manager Name.......... ________________________________________________
MQ Queue Name .............. ________________________________________________
Input Queue Buffer Length .. ______2048
Retry Interval ............. GLOBAL____
Retry Count ................ GLOBAL____
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Save Menu |
Update the fields on this screen as described in the following table.
| Parameter Name | Specify | Default |
|---|---|---|
| Input Queue Buffer Length | 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. |
2048 |
| Input Queue Name | A unique name for the IQUEUE definition. The
name must use alphanumeric characters and be between one and 8 characters long.
This is the equivalent of specifying the IQUEUE NAME parameter in the Event Replicator Server startup job. |
--- |
| MQ Queue name | The name of the MQSeries queue you want used
for this IQUEUE definition. The name can be up to 48 characters long.
This is the equivalent of specifying the IQMQQNAME parameter in the Event Replicator Server startup job. |
--- |
| Queue Manager Name | The name of the MQSeries queue manager you
want used for this IQUEUE definition. The name can be up to 48 characters long.
This is the equivalent of specifying the IQMQQMGRNAME parameter in the Event Replicator Server startup job. |
--- |
| Retry Count | 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 |
| Retry Interval | 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 |
Press PF5 to save the IQUEUE definition.
To use the Adabas Event Replicator Subsystem to modify an IQUEUE definition in the Replicator
system file:
List the IQUEUE definitions in the Adabas Event Replicator Subsystem, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed on the List of IQUEUE Definitions screen.
Locate the definition you want to modify on the screen and enter an M in the Sel column for that definition.
An appropriate IQUEUE definition screen appears for the IQUEUE type you selected. For information on modifying this screen, read the description of adding that type of IQUEUE definition in Adding IQUEUE Definitions.
When all modifications have been made, press PF5 to save the changes.
To use the Adabas Event Replicator Subsystem to copy an IQUEUE definition in the Replicator
system file:
List the IQUEUE definitions in the Adabas Event Replicator Subsystem, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed on the List of IQUEUE Definitions screen.
Locate the definition you want to copy on the screen and enter a C in the Sel column for that definition.
A dialog appears requesting a name for the copy of the IQUEUE definition.
Enter new name: ________
or press ENTER to cancel
|
Specify a new, unique name for the copy of the IQUEUE definition and press Enter.
The IQUEUE definition is copied and the copy appears on the List of IQUEUE Definitions screen.
To use the Adabas Event Replicator Subsystem to delete an IQUEUE definition in the Replicator
system file:
List the IQUEUE definitions in the Adabas Event Replicator Subsystem, as described in Listing IQUEUE Definitions.
The IQUEUE definitions are listed on the List of IQUEUE Definitions screen.
Locate the definition you want to delete on the screen and enter a D in the Sel column for that definition.
The IQUEUE definition is deleted.
