DFS070 UNABLE TO ROUTE MESSAGE RSN=xxyy (I: sss1/name1, D: sss2/name2)

Explanation

One of the following situations occurred and an error was encountered while routing the message:
  • IMS attempted to enqueue a message.
  • A /FORMAT command was entered.
  • One of these entry points in the TM and MSC Message Routing and Control user exit (DFSMSCE0) attempted to reroute a message:
    • Link Receive Routing
    • Program Routing
    • Terminal Routing
In the message text:
xx
The IMS module that detected the error:
Code
Meaning
00
Unknown module or DFSMSCEC requestor
01
DC Communication Manager (DFSICIO0)
02
LU 6.2 Receive LU Manager (DFSRLM10)
03
OTMA Receive LU Manager (DFSYTIB0)
04
DC Call Handler (DFSDLA30)
05
MSC Analyzer (DFSCMS00)
06
/FORMAT command processor (DFSICLK0)
08
IMS Termination (DFSTRM00)
10
IMS Initialization (DFSIINB0)
yy
The reason for the error:
Code
Meaning
02
The exit requested two user prefixes.
03
The exit requested two internal prefixes. Internal prefixes are reserved for IMS internal tools.
04
The prefix buffer length was too large.
05
A DFSPOOL error occurred on the get prefix buffer.
06
The exit return code was negative.
07
The exit return code was too high.
08
A DFSBCB error occurred while getting a BCB control block.
09
A bad SYSID was detected.
10
A Message Queue Manager error occurred while inserting a prefix.
11
A nonzero return code was received from DFSICLR1.
12
The message destination is an invalid type for the AVM/ISC link.
13
Change destination error. User exit requested to change the destination name to a different transaction by setting MSLR2CHG, MSPR2CHG, or MSTR2CHG. The new destination name at MSLRDEST, MSPRDEST, or MSTRDEST is not a transaction destination.
14
Change destination error. User exit requested to change the destination name to a different LTERM by setting MSLR2CHG, MSPR2CHG, or MSTR2CHG. The new destination name at MSLRDEST, MSPRDEST, or MSTRDEST is not an LTERM destination.
15
The DFSMSCEC exit routing flag is in error.
16
A DFSUSRX interface error occurred.
17
Change destination error. User exit requested to change the destination name by setting MSTR2CHG or MSLR2CHG or MSPR2CHG. The new destination name at MSTRDEST, MSLRDEST, OR MSPRDEST was not be found.
18
The exit changed the destination name of the I/O PCB message.
19
The exit requested rerouting for the I/O PCB message.
20
The exit changed the destination name to a command (for example, /CMDVERB).
21
The user exit override of MSNAME was invalid.
22
Local share queue registration failed for rerouting the transaction to the local shared queues.
23
The exit routed the transaction to an invalid, remote destination.
24
The exit rerouted the message to an invalid MSC system identification (for example, SYSID).
25
The exit routed the message to an invalid MSNAME.
26
The exit routed an intermediate message to this local IMS, but the source SYSID is unknown to this local IMS.
27
The exit indicated routing to a remote IMS but did not set the destination SYSID or MSNAME.
28
The exit requested rerouting to the source system but MSC was not system defined or the source SYSID was not valid.
29
The exit requested that direct route override but override was unsuccessful.
30
The exit requested invalid rerouting for a front-end switch message to a remote IMS.
31
The exit requested rerouting for a response message.
33
DFSMSCE0 initialization failed because DFSMSCSV is not supported.
34
DFSMSCE0 initialization failed because the DFSMSCSV length is invalid.
35
DFSMSCE0 initialization failed because the character string VECTOR is not present.
36
The user prefix segment (MSCEUPR) was invalid when the exit returned to IMS.
37
The internal prefix segment (MSCEIPR) was invalid when the exit returned to IMS. Internal prefixes are reserved for IMS internal tools.
38
The exit overlaid the 512–byte user work area buffer.
39
The exit overlaid the MSEB BCB block name.
40
The exit overlaid the parameter list.
Codes 41 through 52 apply to the /FORMAT command.
41
The CNT for the terminal to be formatted was not found.
42
The specified terminal is a remote LTERM.
43
The specified terminal is a dynamic MSNAME (LNB).
44
The destined terminal (which is different from the input terminal) is not MFS-formatted.
45
The destined terminal is in line response mode.
46
The destined terminal is in TERMINAL response mode.
47
Conversation is active on the destined terminal (when LTERM was specified in the command).
48
The terminal is in input only mode.
49
The terminal is in the exclusive mode (when LTERM was specified in the command).
50
The call to Queue Manager failed for a put locate call.
51
The inset prefix call to Queue Manager failed.
52
The call to enqueue the message failed.
sss1/name1
The source SYSID and source LTERM name for the input system.
sss2/name2
The destination SYSID and destination LTERM or TRAN code of the processing system.

System action

The /Format command or message routing request is canceled.

If one of the exits attempted to reroute a message or IMS attempted to enqueue a message, a log record type X'67', subcode X'01' (ID=AER1, ID=MSCE, or both) is written to the log. More than one record might be written to record the error. These records contain the IMS control blocks and save areas used by IMS or the user exit when the error was encountered.

Operator response

(master terminal) Notify the system programmer.

System programmer response

One of the following situations might have caused the error:
  • Operator error. For example, an incorrect transaction code or LTERM name might have been entered.
  • A user routing exit error occurred.
  • An IMS internal error occurred.

If the error is caused by the DFSMSCE0 user exit, see TM and MSC Message Routing and Control User exit routine (DFSMSCE0) and the prologue of the sample DFSMSCE0 exit for an explanation of the routing option.

For all other situations, see Data communication service aids for diagnostic information about message DFS070. Check the RSN, and follow the instructions for determining the cause. Print the 6701 log records for additional information.

Module

DFSCMS00, DFSDLA30, DFSICLK0, DFSICIO0, DFSIINB0, DFSRLM10, DFSTRM00, DFSYTIB0