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.
The Systems with Errors panel indicates one or more errors occurred while CICSPlex SM was
attempting to install resources in the specified CICS systems.
- 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.
- 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 *********************************
- 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.
- 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.
[[ Contents Previous Page | Next Page Index ]]