Responding to errors in the Simulator

There are several messages that can appear in the message area of the Simulator Request Initiation display (DFHMASP1).

These messages indicate the Simulator status or denote any errors that have occurred while using the Simulator. See IVP simulator messages for a list of the errors can display in the message area of the Simulator Request Initiation display.

In response to these messages you should perform the following steps:

  1. Select F 13 PROCESS STATUS. The Process Status information displays as follows:
    Figure 1. Process status screen
                              SIMULATOR REQUEST INITIATION                DFHMASP1  
     -------------------------------------------------------------------------------
                                                                                    
                                     PROCESS STATUS                                 
                                                                                    
       COMPLETION STATUS:  NORMAL                                                   
                    MODE:  COMPLETE                                                 
          SUSPEND STATUS:  NOTSUSPENDED                                             
              ABEND CODE:                                                           
             RETURN CODE:  00000009                                                 
                 MESSAGE:  CIA04002                                                 
          FAILED TRANSID:  CMA9                                                     
          FAILED PROGRAM:  DFHMAIP5                                                 
             FAILED NODE:  DFHMAIP5                                                 
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
       Please select system option:                                                 
                                                           (12) EXIT  (16) RETURN   
    If an error occurs during WebSphere® MQ-CICS bridge processing, the display fields come from the returned MQCIH header and the screen that appears when you select F 13 PROCESS STATUS is as follows:
    Figure 2. WebSphere MQ-CICS bridge status screen
                              SIMULATOR REQUEST INITIATION                DFHMASP1  
     -------------------------------------------------------------------------------
                                                                                    
                                      BRIDGE STATUS                                 
                                                                                    
             RETURN CODE:  SECURITY ERROR                                           
                FUNCTION:  1008                                                     
         COMPLETION CODE:  000000069                                                
             REASON CODE:  000000008                                                
              ABEND CODE:                                                           
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
       Please select system option:                                                 
                                                           (12) EXIT  (16) RETURN 
  2. View the information on the status screen(s) to determine why the request failed. Any information (such as, return code, completion status, suspend status, mode, message) displayed on the Process Status screen comes from the DFHMAH structure. The following lists the DFHMAH fields that correspond to the display item:
    • DFHMAH-COMPSTATUS - Completion Status
    • DFHMAH-MODE - Mode
    • DFHMAH-SUSPSTATUS - Suspend Status
    • DFHMAH-ABENDCODE - Abend Code
    • DFHMAH-RETURNCODE - Return Code
    • DFHMAH-MESSAGE - Message
    • DFHMAH-FAILED-TRANID - Failed Transid
    • DFHMAH-FAILED-PROGRAMID - Failed Program
    • DFHMAH-FAILED-NODE - Failed Node
    See Request message headers for detailed information on these fields.

    If you are viewing the bridge Status screen, refer to WebSphere MQ Application Programming Reference for the MQCIH ReturnCode, Function, CompCode, Reason, and AbendCode definitions and values.