NET/MASTER Network Control Language (NCL) Programmer's Guide

Writing a MSGPROC NCL Procedure
An NCL Tutorial
106160 Tandem Computers Incorporated 3–33
The MSGPROC NCL procedure is correctly installed if you see the display highlighted
in the following screen:
(13:11) --------------------- OPERATOR CONTROL SERVICES ----------------------
PROFILE
NNM0381 USERID: NNMUSER TERMINAL-ID: #9246528
NNM0382 NCL PROCEDURE LIBRARY ID: $DATA9.MYNCLLIB
NNM0383 USERID HAS MONITOR STATUS.
NNM0384 AUTOHOLD SETTING IS ON AUTO.
NNM0385 AUTHORITY LEVEL IS 2, MSGPROC MSGPROC ACTIVE.
NNM0386 USER SERVICES PROCEDURE: USRSERN
NNM0388 EMS MESSAGE DELIVERY DETAILS:
NNM0390 .. RECEIVE ALL EMS MESSAGES.
NNM0358 Operand Function
NNM0359 (CMDKEEP=NO..) NO COMMAND WILL BE KEPT ON ENTRY LINE.
NNM0361 (CMDSTACK=20.) COMMAND STACK SIZE IS 20.
NNM0362 (DELCHAR=_...) ROLL DELIMITER LINE CHARACTER IS '_'.
NNM0364 (HOLD=200....) HELD MESSAGES THRESHOLD IS 200.
NNM0365 (INITCMD=....) INITIAL CMD IS: AUTOHOLD ON;PROFILE CMDKEEP=NO.
NNM0378 (EMS=YES.....) EMS MESSAGES WILL BE DISPLAYED. CLASS=NORM.
NNM0375 (ROLL=1......) SCREEN ROLL DELAY TIME IS 1.
NNM0366 (MONMSG=YES..) MONITOR CLASS MESSAGES WILL BE DISPLAYED.
NNM0372 (NRDELCH==...) NRD DELIMITER LINE CHARACTER IS '='.
NNM0374 (RDMIN=1.....) MINIMUM RDM LINES IS 1.
NNM0368 (MSGALARM=0..) QUEUED MESSAGE ALARM COUNT IS 0.
AUTO HOLD ------------------ NonStop NET/MASTER D30 ---------------- --------
M=>
Features of MSGPROC Comments throughout the MSGPROC NCL procedure summarize what is happening
at each step. Here are some additional comments on its features.
The MSGREAD Verb and the VARS Keyword
The MSGREAD verb is used only in a MSGPROC NCL procedure. It reads the next
message destined for an OCS window. The VARS keyword reads each word of the
text of the message into the specified variables. The variables following VARS begin
with &WORD, and NCL automatically creates variables beginning with &WORD—
&WORD1, &WORD2, and so on—to hold all the words in the text.
Note The whole message, the attributes as well as the text, is also read into a mapped data object (MDO)
variable beginning with the reserved stem &$MSG.. MDO variables are discussed in more detail in
Section 10, “Working With Mapping Services.”
The IF Core Statements and the MSGDEL and MSGCONT Verbs
After a message is read, the IF core statements determine how to process the message.
Depending on the text, the IF statements can:
Delete the message using the MSGDEL verb. The message is not displayed at the
OCS window.
Modify the message and forward it on using the MSGCONT verb. The modified
message is displayed at the OCS window.