Handling dynamic installation errors in the EUI

When you ask CICSPlex® SM to install one or more resources dynamically by using the install action from an end-user interface view, an input panel is displayed. After you provide the required information and press Enter, the input panel remains displayed while CICSPlex SM attempts to install the selected resources into the appropriate CICS® systems. Note that the installation of resources into various CICS systems can take place in parallel.

When the installation process is complete, if any of the resources could not be installed, a panel like the one shown in Figure 26 is displayed.

Figure 26. A list of CICS systems with installation errors
COMMAND ===>                                                    Scroll ==> PAGE
These systems had errors.  Select them to see details of the errors.
 
 
C System
- --------
_ EYUMAS1A
 
****************************** BOTTOM OF DATA *********************************
 

The Systems with Errors panel indicates one or more errors occurred while CICSPlex SM was attempting to install resources in the specified CICS systems.

  1. To display a list of the errors encountered by a CICS system, type an S (for Select) to the left of the system name. You can select more than one CICS system at a time.
  2. Press Enter. The list of installation errors for the first CICS system you selected is displayed. Figure 27 shows a sample list of resource installation errors:
    Figure 27. A list of resource installation errors
    COMMAND ===>                                                    Scroll ==> PAGE
    Errors found for  EYUMAS1A
     
     
    Resource Res Resource    Error Code    EIBFN Resp1 Resp2 Resp2
      Name   Ver   Type                                 Hi    Lo
    -------- --- -------- ---------------- ----- ----  ----  ----
    EYU9XLEV  1  PROGDEF  Install Failure  3002  10    31    500
     
    ****************************** BOTTOM OF DATA *********************************
     
  3. Note the errors. Either press Enter, or issue the END or CANCEL command. The list of errors for the next CICS system you selected is displayed. When the errors for all the CICS systems you selected have been displayed, you are returned to the view where you entered the install command.
    Attention:
    Once you exit the list of CICS systems that experienced installation errors, that list is deleted and cannot be recreated.
  4. Correct the installation errors and try the installation process again.

The Resource Install Errors panel lists the resources that could not be installed in the specified CICS system. The following information is provided for each resource:

Resource Name
The name of the resource that could not be installed.
Res Ver
The version of the resource that could not be installed.
Resource Type
The type of resource that could not be installed.
Error Code
A CICSPlex SM error code that describes the reason the resource could not be installed. The error code will be one of the following:
Complete Failed
An EXEC CICS CREATE COMPLETE request for a connection, session, or terminal failed. The CICS EIBFN and RESP values are returned with this error code.
Connection Failed
An attempt to install the specified connection failed because the associated session definition could not be found.
Discard Failure
An EXEC CICS CREATE DISCARD request for a connection, session, or terminal failed. The CICS EIBFN and RESP values are returned with this error code.
Install Failure
Either CICSPlex SM did not perform a resource state check before issuing the EXEC CICS CREATE command or the state check process failed. The resource install request was rejected by CICS. The CICS EIBFN and RESP values are returned with this error code.
MAS Failure
An attempt to install the specified resource in the specified system failed because an unexpected condition was encountered. Refer to the specific CICS system job jog and CMAS EYULOG for further information.
Not Authorized
The external security manager (ESM) determined that the user who requested the install action is not authorized to perform the specified installation.
Not Forced
An attempt to install the specified resource in the specified CICS system failed because the same resource already exists in the CICS system and Force Install is set to NO.
Not Supported
An attempt to install the specified resource in the specified CICS system failed because CICS does not support the dynamic installation of that resource. Journals cannot be installed dynamically. Journal models and transient data queues can be installed only in systems running the CICS TS for OS/390.
Status Failure
CICSPlex SM performed a resource state check and determined that the specified resource could not be installed in the specified CICS system.
System State
The specified CICS system either is not active or does not support the EXEC CICS CREATE command.
EIBFN
The code that identifies the last CICS command issued by the task. For a list of valid codes, see the CICS Application Programming Reference or the CICS System Programming Reference .
Resp1
The number corresponding to the condition specified in the Error code field.
Resp2 Hi
The number in the high-order EIBRESP2 halfword (see Note).
Resp2 Lo
The error number in the low-order EIBRESP2 halfword (see Note).
Note:
The fullword EIBRESP2 field is regarded as a structure containing two halfwords. The low-order halfword (Resp2 Lo) always contains an error number. The high-order halfword (Resp2 Hi) may contain another number to help you identify the error. The EXEC CICS CREATE RESP2 values and their meanings can be found in CICS System Programming Reference.

Related concepts
Deciding where resources should be installed
Automatic resource installation
Dynamic resource installation
Related tasks
Installing resource groups
Installing resource descriptions
Installing system links
[[ Contents Previous Page | Next Page Index ]]