Information Systems:OPMESSAGES - System Operator Message Monitor
Message Monitor
Throughout the day, the system sends messages to the system operator; user ID QSYSOPR. The vast majority of these are informational only, and we are not concerned about them. Others can be vital.
It is not practical for someone to manually monitor this message queue. There are a lot of messages to go through, and it would just take too much of someone’s time, waiting for something that happens infrequently.
There is a program (OPMESSAGES) that runs all day, constantly looking at the system operator message queue. It ignores messages that are expected, or for which we don’t have to do anything. When it comes across an unexpected message, it emails it to the email addresses in the data areas MSGREC, MSGREC2, MSGREC4, and MSGREC5 (in library UNIPHARMIT).
To add to the file of messages that are not to be emailed, use DFU on file OPMSGOMITP in library UNIPHARMIT.
Program
To see the operator message monitor job, key in WRKACTJOB SBS(MONITOR) and press enter. Or you can just key in WRKACTJOB, press enter, and page down until you get to the monitor subsystem.
Work with Active Jobs
Current
Opt Subsystem/Job User Type CPU % Function Status
__ MONITOR QSYS SBS .0 DEQW
__ MSGMONITOR EODJOB BCH .0 PGM-OPMESSAGES MSGW
In this case, the status ‘MSGW’ does not mean the program is waiting for a user to reply to a message, but that it is waiting for a message to arrive in a message queue.
Email Rececipients
To display the data areas (to see who is being sent the emails), key in DSPDTAARA and press F4 to prompt.
Display Data Area (DSPDTAARA)
Type choices, press Enter.
Data area . . . . . . . . . . . > MSGREC Name, *LDA, *GDA, *PDA
Library . . . . . . . . . . . > UNIPHARMIT Name, *LIBL, *CURLIB
Output . . . . . . . . . . . . . * *, *PRINT
Output format . . . . . . . . . *CHAR *CHAR, *HEX
3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Key in the data area name (MSGREC, MSGREC2, MSGREC4, MSGREC5), library UNIPHARMIT, and press enter.
Display Data Area
System: BART
Data area . . . . . . . : MSGREC
Library . . . . . . . : UNIPHARMIT
Type . . . . . . . . . : *CHAR
Length . . . . . . . . : 50
Text . . . . . . . . . : email to receive operator messages
Value
Offset *...+....1....+....2....+....3....+....4....+....5
0 'SHEILAV@MAGGIE.UNIPHARM.COM '
Press Enter to continue.
F3=Exit F12=Cancel
Notice that as this is an internal distribution, it uses the Domino server name, which is maggie.unipharm.com
To change the email address saved in the data area, key in CHGDTAARA and press F4 to prompt.
Change Data Area (CHGDTAARA)
Type choices, press Enter.
Data area specification:
Data area . . . . . . . . . . MSGREC Name, *LDA, *GDA, *PDA
Library . . . . . . . . . . UNIPHARMIT Name, *LIBL, *CURLIB
Substring specifications:
Substring starting position . *ALL 1-2000
Substring length . . . . . . . 1-2000
New value . . . . . . . . . . . NEW@MAGGIE.UNIPHARM.COM
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys
Key in the data area name, library UNIPHARMIT, new email address, and press enter.
Sample Emails
Here is a message that requires no action.
Subject: CPC1162 From: QSYSOPR To: SHEILAV Date: 11/12/2013 02:51 PM Job 041297/EODJOB/MSGMONITOR held by user SHEILAV with option SPLFILE(*NO). MONITOR QSYS 988479QWTMMHDJ 00001131211145140 574004
An important message looks like this –
Subject: CPA403D From: QSYSOPR To: SHEILAV Date: 10/12/2013 11:01 PM Operator action required on device NARINV09A (C R). NARINV09A QSPLJOB 968817QSPSNDWM 00001131210230144 857814
What make this important is the brackets with some or all of the letters C, D, I, R, and G (these stand for Cancel, Dump, Ignore, Retry, and Go). It means that this message must be answered – in this case the narcotics invoice printer will not print until it is.
Take note of the date and time (1131210 230144). These can be used to lookup this event in the history log. (This date format uses a one digit century – 0 for 19 or 1 for 20. So 113 is 2013.)
Find Message Requiring Response
On a command line, key in DSPMSG QSYSOPR and press enter.
Work with Messages
System: BART
Messages in: QSYSOPR
Type options below, then press Enter.
5=Display details and reply
Opt Message
Messages needing a reply
5 Operator action required on device NARINV09A (C R).
Reply . . : R
Messages not needing a reply
_ Log version QHST13346B in QSYS closed and should be saved.
_ Writer 997429/QSPLJOB/RETPRT05 started.
_ Writer 997043/QSPLJOB/RETPRT05 ended normally.
_ Service Agent is analyzing your system product activity log entries.
_ Job message queue for 995992/EODJOB/FTP_ORDERS has been wrapped.
_ Writer 997043/QSPLJOB/RETPRT05 started.
_ Cleanup has completed.
_ Cleanup of system journals and system logs successfully completed.
More...
F1=Help F3=Exit F5=Refresh F12=Cancel F17=Top F18=Bottom
F21=Select assistance level F22=Display list details
Key a 5 in front of the message, and press Enter.
Additional Message Information
Message ID . . . . . . : CPA403D Severity . . . . . . . : 99
Message type . . . . . : Inquiry
Date sent . . . . . . : 12/10/13 Time sent . . . . . . : 23:01:44
Message . . . . : Operator action required on device NARINV09A (C R).
Cause . . . . . : An error was detected on device NARINV09A. Look at the
printer to determine the cause of the problem.
Recovery . . . : Do one of the following and try the request again.
Possible choices for replying to message . . . . . . . . . . . . . . . :
C -- Enter C to cancel the writer.
R -- Enter R to continue printing the file after the problem at the printer
has been corrected.
Technical description . . . . . . . . : For more information, see your
printer's operator guide.
Reply . . . : R
Press Enter to continue.
F3=Exit F6=Print F9=Display message details F12=Cancel
F21=Select assistance level
Perform whatever action the message suggests, then reply. The best answer, if it offered, is always R for Retry. Otherwise I’m afraid it can be different for every event.
Add Message to ‘Do not Send’ List
Go to Unity / Start uniPHARM Extensions / VA Company / Work with UWD IT Tools / System Messages to Not Email.
This will run DFU on the file OPMSOMITP in library UNIPHARMIT. To delete a record, key in the message code (in upper case), and press enter. When the record is found, press F23 twice to delete. To add a record, press F10 so that the mode in the upper right corner is ‘ENTRY’. Key in the message code (again, in upper case), and press enter.
Press F3 to end. You should see a count of the records you added or deleted. Press Enter.