Remote Nodes
4 Optionally enter a description of the queue in the Description field
The following table explains the fields:
Field Description / Values Remote Queue
Manager:
Name It identifies the name of the remote Queue Manager to which the remote queue belongs.
User Id User identifier with which the transport identifies itself to the remote Queue Manager.
Password Password with which the transport identifies itself to the remote Queue Manager.
Remote Queue:
Name It identifies the name of the remote queue corresponding to the queue to be created.
Password Write password for remote queues in the remote Queue Manager.
Type Queue Type Address Type Address Type
Value Description Spazio
Spazio System
Local Automatic
Remote Automatic
Queue Mode It specifies if the queue can be opened for input several times concurrently.
Default Input
Open Option It identifies the default way in which a queue should be opened for input
File Default
User Class It identifies the default user class when putting files and getting files from queue.
6 Click the Advanced tab:
The following table explains the fields in the Advanced tab:
Field Description / Values
Storage Class Storage class to be associated with the new queue. For further details, see section 2.3.2.8.
Max File Depth Maximum number of files that can be contained in the queue.
Max Message Depth Maximum number of messages that can be contained in the queue.
Max Message Length Maximum length of messages that may be inserted in the queue.
Default Priority Default priority of the Message\File put to the queue
Default
persistence of messages
Persistence assigned to messages written to this queue that had no persistence specified when they were written.
Mode in which messages are delivered Value Description
FIFO Delivered using First In First Out mechanism.
Whether GET operations are blocked for the queue:
Value Description
True GET operations are blocked.
Inhibit Get Operation
False GET operations are not
Field Description / Values
Whether PUT operations are blocked for the queue:
Value Description
True PUT operations are blocked.
Inhibit Put Operation
False PUT operations are not blocked.
Read Password Read password associated with the queue (allows files and messages to be read from the queue).
Write Password Write password associated with the queue (allows files and messages to be inserted in the queue).
Set Password Set password associated with the queue (allows the queue to be modified or deleted).
Force Default
Class For Files Force all files put to the queue to use the default user class
Force Default
Class For Messages Force all messages put to the queue to use the default user class
7 Fill in the relevant fields.
8 Click the Delivery Mode tab:
The following table explains the fields in the Delivery Mode tab:
It identifies how messages/files are written to the remote Queue Manager, once they have been written on the local Queue Manager.
Allowed values:
Field Description Delivery Mode
Hold Optional.
Alternate to Immediate, Interval, Use Transport Class parameters.
Deferred delivery.
Files/messages remain in the local Queue Manager. They are transmitted to the remote Queue Manager only on request.
This mode is valid only for MVS nodes.
Immediate Optional.
Alternate to Hold, Interval, Use Transport Class parameters.
Immediate delivery.
All messages/files written on the local Queue Manager are immediately
delivered to the remote Queue Manager.
If selected, the Max Delivery Time field appears that identifies the maximum time interval, in seconds, between the writing of a message/file in the local Queue Manager and its send to the remote Queue Manager (max. 86400, a day)
This mode is valid only for MVS nodes.
Interval Optional.
Alternate to Hold, Immediate, Use Transport Class parameters.
It identifies the time of the day at which the delivery of a message/file starts and ends.
If selected, two fields appear and the user must indicate the values in the format HHMMSS.
This mode is valid only for MVS nodes.
Use Transport Class Optional.
Alternate to Hold, Immediate, Interval parameters.
The user can specify a transport class, different from the default transport class, to be used for files contained in this queue.
Value Description
Use Default
Transport Class
Use the current default user class
Field Description Class of their destination queue manager
Use Transport
Class Specify a Transport Class to be used Transport Success Event
Event Name Event used after a successful transport Group Name Group used after a successful transport Transport Failure Event
Event Name Event used after a failed transport Group Name Group used after a failed transport Custom Delivery mode
Guaranteed Delivery
Order Guaranteed Delivery Order
Restart Interval Interval specified between restart attempts Restart Max Number Optional.
Maximum number of restarts that can be attempted.
If Delivery Mode is set to Use Transport Class, this value is ignored, since it will be taken directly from the Transport Class specified for the queue.
If Delivery Mode is other than Class (Hold, Immediate, Interval), this value can be specified.
The range of values is [0 – 10000]. The value 0 sets the value to the default (for SPAZIO the default is 6).
Sync Level Number of blocks (in the case of a file) or number of messages before a Sync (ACK1) is requested in the transport. Default: 10 Files
Transport Name File Transport Name Transport Timeout File Transport Timeout Transport Prestarted File Transport Prestarted Messages
Transport Name Messages Transport Name Transport Timeout Messages Transport Name Transport Prestarted Messages Transport Name
9 Select the relevant option.
10 Click OK to create the queue, or Cancel to abort the operation.
NOTE: if the user specifies an incorrect password when defining a remote queue, subsequent transmissions to this queue will fail (status "Failed").
Normally transmissions in "Failed" status require manual intervention by the user (New Transport) in order to restart them. In this case, however, it is enough to specify the correct password in the definition of the remote queue and the transmissions will restart and complete automatically.
2.3.2.6 Delete a Queue
1 Select a local or remote queue.
2 Click the button on the toolbar.
3 The Remove Queue dialog box appears:
4 If no Set password was assigned to the queue, leave the Password field blank. If a Set password is required, enter the correct password.
5 The queue is now deleted.
2.3.2.7 View and Set the Security properties of a Queue
To view or change the security properties of a queue, select the queue and choose View – Security or right-click the queue and choose Security.
Refer to Chapter 3: Security Management for details on how to set and modify the permissions.
2.3.2.8 Storage Class
A Storage Class is applied to a Queue Manager and specifies the attributes (in particular the data catalogue path and the maximum number of files that can be stored in a queue) that characterize the queues belonging to the Queue Manager to which such class is applied.
A Storage Class must be defined in the SPQM.INI configuration file and is made up of the following attributes:
Identifier (ClassId)
Name (ClassName)
Path where directories CLASS and DATA of the Storage Class in QM, are appended (ClassPath)
Maximum size of disk file of persistent object entry repository - entries for persistent messages and files in queues (RepPMax)
Maximum size of memory file of volatile object entry repository - entries for non-persistent messages in queues (RepNPMax)
Maximum size of disk file of persistent message body repository - entries for persistent messages in queues (MsgBodyPMax)
Maximum size of memory file of volatile message body repository - entries for non-persistent messages in queues (MsgBodyNPMax)
Maximum size of disk file of file information entry repository - entries for files in queues (FileInfoPMax)
Example (SPQM.INI)
MsgBodyPMax_1 = 20000000 MsgBodyNPMax_1 = 800000 FileInfoPMax_1 = 10000000 ..
2.3.3 DQLs
The sections below describe the operations that you can perform on DQLs (Destination Queue Lists) belonging to a Queue Manager on a Local or Remote Node using SPAZIO Administrator.
A DQL is a SPAZIO object that groups together a set of queues to which you want to send files or messages. In SPAZIO you can add an item to a DQL by naming a destination queue and its Queue Manager.
NOTE: all queues of a DQL must also belong to the same storage class. If a DQL item is a Queue Manager queue type (M queue type), all the other DQL queues must belong to the default storage class that is the first defined in SPQM.INI.
2.3.3.1 List DQLs
1 Click the DQLs folder in the left panel of the screen.
2 The DQLs belonging to the current Queue Manager are displayed:
3 The DQLs are also listed in the right panel:
2.3.3.2 View the general properties of a DQL
1 Click a DQL.
2 If the button on the toolbar is already selected, the properties of the DQL are listed in the right panel:
The properties listed are the name of the DQL, possibly a brief description and the date a time at which the DQL was created.
2.3.3.3 View the items contained in a DQL
1 Click a DQL.
2 If the button on the toolbar is already selected, the items contained in the DQL are displayed in the right panel:
The various objects are displayed hierarchically, using the familiar icon representations of queues and Queue Managers.
2.3.3.4 Create a DQL
The easiest way to explain DQL creation is through a simple example. The following sections describe the creation of a DQL called dql2.