This feature allows the user to identify which messages to be sent to a specific message queue when BRMS adds the message to the BRMS log (DSPLOGBRM).
To view the current settings:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*DISPLAY')
To set the message queue:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*MSGQ' 'libname' 'objname')
for example:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*MSGQ' 'QSYS' 'QSYSOPR')
To insert a rule:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*INSERT' 'xxx' 'yyyy' 'zzzzzzz')
where:
xxx - position (1, 2, 35, etc) to insert the rule
yyyy - *INC include the message, *EXC exclude the message
zzzzzzz - message ID, generic message ID or *ALL to be included or excluded
To replace a rule:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*REPLACE' 'xxx' 'yyyy' 'zzzzzzz')
where:
xxx - position (1, 2, 35, etc) to insert the rule
yyyy - *INC include the message, *EXC exclude the message
zzzzzzz - message ID, generic message ID or *ALL to be included or excluded
To remove a rule:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*REMOVE' 'xxx')
where:
xxx - position (1, 2, 35, etc) to insert the rule
To clear all rules:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*CLEAR')
Rules are processed in order. Messages being sent to the BRMS log are compared against each rule, and a determination is made whether to send the message to the external message queue.
For example:
The following rules indicate that all BRM messages except BRM1097, and all CPI messages except CPI0307, will be sent to message queue QSYS/QSYSOPR:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*DISPLAY')
MESSAGE QUEUE: QSYS/QSYSOPR.1 *INC BRM*.2 *EXC BRM1097.3 *INC CPI*.4 *EXC CPI0307.
The following rules indicate that all BRM messages except BRM1097, all CPI messages except CPI0307 and all other messages, will be sent to message queue QSYS/QSYSOPR:
CALL QBRM/Q1AOLD PARM('LOGMSGEXT ' '*DISPLAY')
MESSAGE QUEUE: QSYS/QSYSOPR.1 *INC BRM*.2 *EXC BRM1097.3 *INC CPI*.4 *EXC CPI0307.5 *INC *ALL
NOTES:
- In releases IBM i 6.1 and earlier, the following PTFs or their superseding PTFs are required:
-6.1 SI33975
-v5r4m0 SI33974 - Generic rules can be created. For example, BRM*, *ALL, CPF9* etc are all valid generic rules.
- Anything after the '*' is ignored, i.e. CP*1000 is the same as CP*
- All messages sent to the specified message queue will be sent as *INFO messages.
- If the specified message queue is being saved while BRMS is attempting to send a message to it, the backup may fail.
- User profile QBRMS must have authority to send messages to the specified message queue