/Q Configuration for CICS Runtime

/Q Configuration for CICS Runtime

Asynchronous transactions launched using 'EXEC CICS START TRANSID' requests may also be launched with a delay set to an interval or to a fixed time.

In this case, the transaction request is deposited into a Tuxedo /Q Queue, and when the time is ready, the transaction will be automatically invoked.

For this feature to be available, a few extra components must be activated:

•	A Tuxedo /Q Queue Space named ASYNC_QSPACE must be created.

•	A Tuxedo /Q Queue named ASYNC_QUEUE will be created in the queue space.

•	A TMQFORWARD server will be configured to receive messages from this queue and invoke the application transaction corresponding to the request.

/Q Configuration for delayed transactions

Before you begin creating the qspace you must load the variable KIX_QSPACE_IPCKEY and the Tuxedo QMCONFIG variable.

The QMCONFIG variable points to an existing device where the Tuxedo UDL must be in running mode.

For more details see the Tuxedo documentation "Creating Queue Spaces and Queues".

Creating an Entry in the Tuxedo UDL: crdl and Queue Space "ASYNC_QSPACE"

Listing 7‑1 crdl and Queue Space "ASYNC_QSPACE"

#create the qspace

# qspacecreate -n 1000B

# Queue space name: ASYNC_QSPACE

# IPC Key for queue space: ${KIX_QSPACE_IPCKEY}

# Size of queue space in disk pages: 1000

# Number of queues in queue space: 4

# Number of concurrent transactions in queue space: 9

# Number of concurrent processes in queue space: 9

# Number of messages in queue space: 1000

# Error queue name: errque

# Initialize extents (y, n [default=n]): y

# Blocking factor [default=16]: 16

qmadmin ${QMCONFIG} <<!end

crdl ${QMCONFIG} 0 2000

qspacecreate -n 1000

ASYNC_QSPACE

${KIX_QSPACE_IPCKEY}

1000

4

9

9

1000

errque

y

16

Q

!end

 

Creating a Queue

Listing 7‑2 ASYNC_QUEUE" using Tuxedo "qcreate" tool

#create the queue

# qcreate

# Queue name: ASYNC_QUEUE

# Queue order (priority, time, expiration, fifo, lifo): fifo

# Out-of-ordering enqueuing (top, msgid, [default=none]): none

# Retries [default=0]: 2

# Retry delay in seconds [default=0]: 30

# High limit for queue capacity warning (b for bytes used, B for blocks used,

# % for percent used, m for messages [default=100%]): 80%

# Reset (low) limit for queue capacity warning [default=0%]: 0%

# Queue capacity command:

# No default queue capacity command

 

qmadmin ${QMCONFIG} <<!end

qopen ASYNC_QSPACE

qcreate

ASYNC_QUEUE

fifo

none

2

30

80%

0%

 

qcreate

RPLYQ

fifo

none

2

30

80%

0%

 

qcreate

errque

fifo

none

2

30

80%

0%

q

!end

 

For more information about errque and RPLYQ see the Tuxedo documentation.

Tuxedo /Q server configuration in the ubbconfig file

In the *GROUPS section

# /Q

GQUEUE GRPNO=1000

TMSNAME=TMS_QM TMSCOUNT=2

OPENINFO="TUXEDO/QM:/home/kix04/trf/config/tux/kixqspace:ASYNC_QSPACE"

In the *SERVERS section

# /Q

TMQUEUE SRVGRP=GQUEUE

SRVID=1010

RESTART=Y GRACE=0 CONV=N MAXGEN=10

CLOPT="-s ASYNC_QSPACE:TMQUEUE -- "

TMQFORWARD

SRVGRP=GQUEUE

SRVID=1020

GRACE=0 RESTART=Y CONV=N MAXGEN=10

CLOPT="-- -n -i 2 -q ASYNC_QUEUE"