How To Guide

Monitoring the QSYSOPR Message Queue with Powertech Interact and Robot/Console

Last Updated:
July 5, 2017

When you want to monitor for the messages in QSYSOPR message queue with both Robot/Console and Powertech Interact, the problem is that the first product activated locks the QSYSOPR message queue so the other product does not work.

The solution is to set up Robot/Console to monitor the QSYSOPR message queue and forward the messages to another queue (QSYSOPR2). Interact can then be set up to monitor the messages in the QSYSOPR2 message queue.  If Robot/Console and Powertech Interact are both set up to monitor the QSYSOPR message queue, the product that starts first will work successfully and will have a lock on the QSYSOPR message queue. This causes the other product to fail as it can’t allocate the QSYSOPR message queue.

To get these two products to work together, you need to create another message queue (QSYSOPR2) and setup Console to redirect the messages from QSYSOPR to QSYSOPR2.  Interact can be setup to monitor the messages in the QSYSOPR2 message queue and forward the messages to the SYSLOG server.  

Robot/Console must be at R05M16 or later to use the following setup.  

1. Robot/Console setup for QSYSOPR message queue:

Robot/Console must be installed, licensed, and set up to monitor for the messages in the QSYSOPR message queue. Refer to the HelpSystems documentation on the installation of Robot/Console.

Note: When Robot/Console is installed, the installation process prompts the user, asking whether to set up and create the monitor for QSYSOPR messages. This may be already setup in Robot/Console.

Note 2: If Robot/Console is already setup to monitor for the QSYSOPR message queue, you can proceed with step 3. 


2. If Robot/Console is not setup to monitor QSYSOPR message queue, continue with the following steps:  

a. Enter the Robot/Console license key.

b. Start Robot/Console.

From Robot/Console’s Main Menu, take option 4 (Control Menu).

Option 1 – Start Robot Console.

c. Create QSYSOPR Message Center (if it doesn’t already exit).

From Robot/Console’s Main Menu, take option 6 (System Setup),

Option 1 (Message Center Maintenance),

F6=ADD to create the QSYSOPR message center.

d. Change the QSYSOPR Message Queue.

From Robot/Console’s Main Menu, take option 6 (System Setup),

Option 2 (Message Queue Maintenance),

Change the ‘Remove Messages After Processing’ to ‘N’.

Change the ‘Allow Message Queue to be Monitored to ‘Y’.

Change the ‘Establish Robot/Console exclusive lock to ‘N’.

Note: Press ‘Enter’ to save the change.

e. Activate QSYSOPR Message Queue in Console.

From Robot/Console’s Main Menu take option 6 (System Setup),

Option 2 (Message Queue Maintenance),

Option 4 = Start Monitoring Messages


3. Create message queue QSYSOPR2 for Interact to monitor.



4. Create Message Set in Console to re-queue the messages from QSYSOPR to QSYSOPR2.


Option 5 - Console  

Option 2 - Message Set Menu  

Option 1 - Maintain Message Sets  

F6 = Add Record  

On the 'Monitor Message Instructions' panel, enter the following:  

Message Group - *NONE 

Message Set Name – QSYSOPR2  

Description - Send QSYSOPR msg to QSYSOPR2

Message Queue Name - QSYSOPR  

Library - QSYS  

Application – (leave this blank)

Message Set Type - select 'All Messages'

Message File - QCPFMSG  

Library - QSYS  

Press ‘Enter’

Enter a '1' next to 'Always do this message set'

F10 = Next Option (nothing needed on 'Extended Set Information' panel) 

F10 = Next Option

On the 'Operator Assistance Language' panel, enter: 

Operation  - CALLCP  

Operation Values - RBCMSGTOQ  

F10 = Next Option

Do you wish to create the message set at this time?  Y (Y=Yes, N=No)

Press enter to save changes and create the opal program.


5. Return to 'Maintain Message Sets' menu (press F12 multiple times to return to previous panels)

Activate the Message Set – QSYSOPR2

Option 10 - Hold/Release set   (notice - verify that the status displayed is 'ACT')


6. Add QSYSOPR2 message queue to the RBTCONLIB/RBCMSGTOQD data area for the OPAL program 'RBCMSGTOQ' to route the messages to



7. Setup Interact to send message to SYSLOG server  


Option 1 - Work with Brokers/Agents  

Option 2 = Change next to Syslog Server 

Message Queue to Monitor - QSYSOPR2  

Library - QSYS   

Syslog Server Location - Enter IP address for the Syslog Server  

Press enter to save changes  

F12 = Close Window  


8. Change the 'Critical Priority' on the message by selecting Option 7 - Syslog Server

Note: If using “Console Message Table” need to add the messages there, too.

Note: Messages with Critical Priority of ‘0’ are not sent to the Syslog server.  


9. Test both Robot/Console and PowerTech Interact by changing the priority of message and adding to Robot/Console’s message table (if using a message table)      

An example to use:     

In Interact, change message CPF1397 to have a value greater than ‘0’

Add the message CPF1397 to the message table in Robot/Console (if using message table)

Sent test message using Robot/Console’s test message set facility


Option 5 - Console  

Option 2 - Message Set Menu  

Option 2 - Test Message Sets  

Select '1' - QSYS/CPFMSG  

Start List at: Message ID - enter CPF1397  

Option 2 = Test Message Data List  

F6 = Add Test Message Data  

Press Enter to save the changes

F12 = Previous

Select ‘Option 2’ – Send, to send a test record

Enter ‘1’  - next to QSYSOPR (yes, QSYSOPR message queue) to send the test message to QSYSOPR message queue.


You have successfully setup Robot/Console and PowerTech Interact to monitor the QSYSOPR messages.

Note: The following steps are optional and should be done only if you want to control the messages in QSYSOPR2 to be the same as the events in Interact that are set to be transmitted to the Syslog server. 

To control the messages that Robot/Console will forward to the QSYSOPR2 message queue, you need to setup a ‘Message Table’ in Robot/Console. This table would contain the same messages/events that Interact is set to send to the syslog server (i.e. – the critical factor would be set to either a 1, 2 or 3).

Note: This will require that you maintain the messages and/or events in both Interact and Robot/Console, however, it is beneficial when troubleshooting or knowing what events are being sent by Interact. 


10. Create a Message Table – QSYSOPR2

From Robot/Console’s Main Menu take option 2 (Message Set Menu), option 4 (Maintain Message Tables)

F6=ADD Record

Create the Message Table – QSYSOPR2

Message Table – QSYSOPR2

F4 – Prompt for the message file - QCPFMSG

Description – Interact Message Table


11. Create a Message Table – QSYSOPR2

Take option 2 = Elements.

Note: Only add the messages that have a criticality of ‘1’, ‘2’, or ‘3’ in Interact.

Enter the message ID and press enter

(Example – CPF1393  User Profile &2 has been disabled).


12. Create the Message Set QSYSOPR2 to use the table.

From Console’s Main Menu

Option 2 – Message Set Menu

Option 1 – Maintain Message Sets

Select a ‘1’ next to the QSYSOPR2 Message Set.

Change the Message Type from ‘Single’ to ‘Message Table’.      

F10 = Next Option, to end of the message and save the change.


Related Products