Optional: Enabling the replication administration tools to work with IBM MQ on z/OS

You can enable the Replication Center and ASNCLP command-line program to list, select, and validate IBM® MQ queues that are needed for Q replication and publishing. To do so, you run an optional sample job that creates a stored procedure on the subsystems where the replication programs run.

About this task

When you create control tables and queue maps for Q Replication or event publishing, you specify MQ queues. To avoid having to manually enter the names of the queues in the Replication Center, you can create a stored procedure that enables the Replication Center to connect to the queue manager and retrieve a list of queues for selection. The ASN.ADMINIF stored procedure also enables the Replication Center to validate whether the queues have the correct properties for Q replication and publishing, and to send a test message between the queues that are specified in a replication queue map.

If you are using the ASNCLP program, the stored procedure only enables you to validate queues and send test messages.

Important: When performing MQ operations, the stored procedure inherits the security environment from the user ID that is associated with the Workload Manager (WLM) application environment under which it runs. Ensure that this user ID has update authority on the system model queue (SYSTEM.DEFAULT.MODEL.QUEUE). The stored procedure needs this authority to create a dynamic temporary queue that serves as a reply-to queue to receive the output of a DISPLAY QUEUE command. The Replication Center then uses this output to build a list of queues from which you can select.

Procedure

Run the following PERMIT commands to grant update privileges on the dynamic queue that the stored procedure creates (CSQ4SAMP.*) and on the SYSTEM.DEFAULT.MODEL.QUEUE.
```
PERMIT CSQ4SAMP.* CL(MQQUEUE) ID(WLM-AE-UID) ACCESS(UPDATE)

PERMIT SYSTEM.DEFAULT.MODEL.QUEUE CL(MQQUEUE) ID(WLM-AE-UID) ACCESS(UPDATE)
```
Add the following DD statements to the STEPLIB concatenation in your WLM startup procedure for ASN.ADMINIF. The STEPLIB must include the MQ libraries if they are not installed in the LNKLST.
```
//  DD  DSN=ASNQ!!0.SASNLOAD, DISP=SHR
//  DD  DSN=MQSERIES.SCSQLOAD, DISP=SHR
//  DD  DSN=MQSERIES.SCSQAUTH, DISP=SHR
//  DD  DSN=MQSERIES.SCSQANLE, DISP=SHR
```
Change ASNQ!!0 to the name of your replication target library. Change the data set name to match the name of your MQ load library.
Run the ASNADMSP sample job in the SASNSAMP data set.