Filter
Top Products
CMSG—message switching
Message-switching responses
Every input from the terminal receives a response. Most
responses are preceded by indicators where the letters
before OK represent the first character of each of the CMSG
options (except CANCEL) as follows:
D DATE
E ERRTERM
H HEADING
I ID
M MSG
O OPCLASS
P PROTECT
R ROUTE
S SEND
T TIME
These indicators identify the options that have been
processed and that are currently in effect.
Errors may occur because of:
Syntax (for example, misspelled option, unbalanced
parentheses, terminal identifier more than 4 characters,
invalid option separator, and message and destination
not provided).
Specification (for example, the specified terminal has not
been defined to CICS).
Operation (for example, operator not currently signed on
to the system).
Syntax errors within an option cause it to be rejected by the
message-switching routine. To correct a known error, reenter
the option before typing the SEND keyword.
Syntax errors cause no data to be processed in that input
beyond the detected error. All following data must be
reentered to be included.
A specification or operation error message may be written to
the terminal with an indicator that shows that the option in
question has been processed and is still in effect. Two
possible error messages are:
1. M OK TERMID GT 4 CHAR AT T004A
This message has been issued because the terminal
identifier is greater than 4 characters. The absence of
the R indicator preceding the message shows that
ROUTE is not currently in effect and that the message
must be reentered.
2. MRHS OK INVLD TERMINL ID T004
This message has been issued because the specified
terminal is not known to CICS. The R indicator shows
that ROUTE is still in effect. Operator action as a result
of this type of message is either:
A space (entry deleted)
Termid/opid specifying a termid, or operator
identifier, or both (entry changed)
Any option (the route option or another option may
be entered).
Note: If an option is entered, the error message is
repeated unless a new ROUTE option is entered
before SEND. If the incorrect entry is changed or
deleted by responding with a space or
termid/opid, the message is routed unless other
errors are still present. These errors are
indicated by another message. If an option is
entered, it signifies normal entry mode in which
multiple options can be entered requiring another
SEND option to end the input.
The following is a list of all possible responses from the
message-switching program (DFHMSP). Because of
device-dependent considerations, all responses are limited to
25 characters plus the indicators.
ALL ROUTE ENTRIES DELETED
A space entered in reply to a incorrect destination
message caused the remaining destinations to be
deleted, leaving no destinations to which to route the
message. This condition forces a return to normal option
mode, and a ROUTE option must be reentered to
provide the message destinations.
CANCELED - TEMP STRG ERR N
N has a value in the range 1–4.
N=1. An error occurred on a temporary storage (TS)
request.
N=2. An error occurred on a temporary storage (TS)
request. A possible cause of this response, not
related to a TS problem, is a request for a TS
record that does not exist. This can happen if:
– The transaction identifier is entered followed by
a C. This extended transaction identifier
(CMSGC) normally requests a continuation of a
message-switching transaction, but no previous
status information exists for this terminal. See
“Message-switching continuation” on page 232.
Note: A CICS cold start of temporary storage
causes the loss of any status saved
from a previous CICS process.
– The transaction identifier is entered in
lowercase on a 3270 family display device that
is defined as a dual case keyboard, and for
which no previous message-switching
transaction status exists.
Note: The transaction identifier in the terminal
input/output area (TIOA) is not
translated. To correct this problem,
enter the transaction identifier in
uppercase.
N=2 also occurs when transaction routing is being
used and indicates that the transaction identifier
used to initiate the task is different to that specified
in the CICS system definition.
N=3. An error (most likely caused by TS) occurred
on a DFHBMS TYPE=TEXTBLD request.
Chapter 19. Message switching CMSG 241