ADDRESS PPQ Commands › PPQ Setup Command › CREATE Command

CREATE Command

The create command creates a new queue.

This command has the following format:

ADDRESS PPQ 'CREATE QUEUE(qname) [DROP(NO|YES)]
                                    [SHARE(NO|YES)]
                                    [MAXITEMS(maxitems)] 
                                    [PERSISTENCE(PERMANENT|TEMPORARY)]
                                    [TRANSPORT(network-transport-name)]'

QUEUE

Specifies the 1- to 16-character name of the queue (qname). The queue name can contain alphanumeric characters and any of these special characters: ! @ # $ _

The queue name cannot contain blanks.

Note: The qname cannot take the value of the computer name of any of the systems in your PPQ network.

DROP

(Optional) Causes the first (oldest) item in the queue to be dropped from the queue when an attempt is made to write to a full queue.

Default: NO

SHARE

(Optional) Specifies whether the queue is network-shared on the allowed transport.

For more information about network-shared versus local queues, see the chapter on using program-to-program queues in the Administrator Guide

Default: NO

MAXITEMS

(Optional) Specifies the maximum number of items (1 to 10,000) the queue can contain.

Default: 100

PERSISTENCE

(Optional) Specifies whether a queue should be deleted by the REXX program that created it when that program terminates. Valid PERSISTENCE values are:

PERMANENT

The queue remains (persists), even if the creating REXX program terminates (unless the PPQs services terminate or you restart your workstation).

TEMPORARY

Specifies that the queue is to be deleted when the creating REXX program terminates.

Default: PERMANENT

TRANSPORT

(Optional) Specifies the transport a queue is to be created on. This operand is valid only when SHARE(YES) is specified; it is otherwise ignored.

Specifies the network-transport-name is the network transport specified on the TRANSPORT() startup initialization parameter.

Valid network-transport-name is:

PPQTCP

Specifies the network transport is TCP/IP.

Note: This keyword will be removed in a future release.

Usage Note:

You should not create multiple queues with the same name in different transports within one PPQs network. (A transport is the mechanism that moves data from one location to another, such as shared memory on your workstation or TCP/IP.

Example:

'CREATE QUEUE(PROD1) SHARE(YES)'