Installing resources dynamically
About this task
- Open a resource definition screen by clicking Administration views
> Basic CICS resource administration views > CICS resource definitions,
then selecting the type of resource to be installed. Note: You can also access this view from the Fully functional Business Application Services (BAS) administration views menu.
- Select one or more resources and click the Install button.
- Provide the following information about the CICS® systems where the resources are to
be installed.
- Target scope value
- Enter the specific or generic name of an existing CICS system or CICS system group into which the specified resources are to be installed.
- Related scope value
- If you specify a Usage value of
REMOTE, enter
the specific or generic name of an existing CICS system into which the remote resource
is to be installed as LOCAL. Note: For remote transaction definitions (TRANDEF objects) that are defined as dynamic, you can specify a CICS system group for the Related scope value. For all other remote resources, you can specify a CICS system group only if it consists of a single CICS system.
- Usage value
- Specify how the resource will be used:
- LOCAL
- The resource is contained within the target CICS system. LOCAL is valid for all supported resource types.
- REMOTE
- The resource definition refers to a resource installed in a different CICS system.
If you specify REMOTE, you must also specify a Related Scope value to
identify the CICS system
that will contain a local instance of the resource. REMOTE is valid only for
the following resource types:
- File definitions (FILEDEF objects)
- Program definitions (PROGDEF objects)
- Transient data queue definitions (TDQDEF objects)
- Transaction definitions (TRANDEF objects)
Note:- When you specify REMOTE, the resources are assigned to all the CICS systems identified in both the Target scope value and Related scope value fields. Likewise, when the resources associated with this assignment are installed, remote resources are installed in both the target and related scopes.
- Although a temporary storage queue may be created on a remote system, the temporary storage model that controls the queue's attributes is always a local resource. Therefore, when you install a temporary storage model definition, the Usage value must always specify LOCAL. See Installing BAS temporary storage model definitions. For a description of the temporary storage model definition Remote system attribute, see Temporary storage model definitions.
- Mode value
- For some resource types, CICSPlex SM requires
additional information to determine which subset of resource attributes to
use in completing the installation. The Mode value you should specify
depends on the resource type being installed:
- Programs (PROGDEF objects)
- If you specified LOCAL in the Usage value field, you can specify AUTO to have CICS automatically install programs into a system. AUTO means that no explicit definition of the programs is required in the CICS system. Otherwise, specify N/A.
- Transactions (TRANDEF objects)
- You can specify whether or not the transaction should be processed by
the dynamic routing program. If the Usage value field contains REMOTE,
a Mode value must be specified as follows: Note: The value you specify here overrides the Dynamic routing option value in the transaction definitions (TRANDEF objects).
- DYNAM
- Transactions are processed by the dynamic routing program.
- STAT
- Each transaction should be sent to the remote CICS system identified in the transaction definition (TRANDEF object). This mode may be specified only if the Usage value field contains REMOTE.
- Transient data queues (TDQDEF definitions)
- You
can identify the type of transient data queue to be installed:
- EXTRA
- Extrapartition TDQ
- IND
- Indirect TDQ
- INTRA
- Intrapartition TDQ
- Overtype value
- If you plan to specify an override
expression for the resource, indicate which scope the override values should
be applied to:
- NONE
- Do not apply any override values.
- BOTH
- Apply the override values to both scopes.
- RELATED
- Apply the override values to the Related Scope only.
- TARGET
- Apply the override values to the Target Scope only.
- Referenced resource assignment name
- If you are installing
connections from the Connection definition view, identify the resource
assignment that applies to the related session definitions. For each connection, CICSPlex SM requires one
or more session definitions to properly construct the actual CICS link. Note: The Referenced resource assignment name field appears only when you are installing a connection from the Connection definition view.
- Specify any pre-installation checks. When you install resources into CICS systems dynamically, you can ask CICSPlex SM to perform the following checks before it attempts to install the resources:
- Are the CICS systems running?
- Do the CICS systems support the EXEC CICS CREATE command?
If you request any of these pre-installation checks, CICSPlex SM performs them for all the resources you specified before any of the resources are installed.
To specify these checks, select one of the following values from the Notify value field:
- INACTIVE
- CICSPlex SM checks all of the CICS systems you identified to make sure they are currently active in the CICSplex. If any of the CICS systems are not active, CICSPlex SM returns a list of inactive systems.
- RELEASE
- CICSPlex SM checks for CICS systems in the target scope that do not support EXEC CICS CREATE commands. If any of the CICS systems are running a release of CICS that does not support EXEC CICS CREATE, CICSPlex SM returns a list of systems where resources cannot be installed.
- FULL
- CICSPlex SM checks all of the CICS systems you identified to make sure they are currently active in the CICSplex, and checks that the CICS system is at the appropriate level for the resource being installed. If any of the CICS systems are not active, CICSPlex SM returns a list of inactive systems. If any of the CICS systems are running a release of CICS that does not support EXEC CICS CREATE, CICSPlex SM returns a list of systems where resources cannot be installed.
- NO
- No checking is performed.
- Request any consistent state check.
If a resource that you are trying to install already exists in a CICS system, CICSPlex SM can check whether its current operational state would allow the resource to be replaced. For example, if a program with the same name and attributes exists in a CICS system, CICSPlex SM attempts to discard it. However, if that program is currently in use, CICSPlex SM cannot replace it with a new one. You use the State check value field to request a consistent state check:
- State check
-
- NO
- CICSPlex SM does not provide details on resource that are not installable because of their status before issuing an EXEC CICS CREATE command.
- YES
- CICSPlex SM provides details on resources that are not installable because of their status before issuing an EXEC CICS CREATE command.
- Specify a Force install value.
Before installing a resource, CICSPlex SM checks to see if the same resource already exists in the CICS system and if CICSPlex SM itself was responsible for installing it. If so, CICSPlex SM considers the new resource to be a duplicate.
In this situation, CICSPlex SM concludes that the new resource does not need to be installed because it is a duplicate of one that already exists. However, you may want to reinstall an existing resource if, for example, you have changed attributes of the definition, or you are supplying override values as part of the installation request. To do this, you can use the Force install value option when you dynamically install resources. This option is available when you:- Install an individual resource
- Install a resource group
- Install a resource description
- Replace a resource description
- Force install value
-
- YES
- Install the specified resource unconditionally, without checking whether or not it is a duplicate
- NO
- Do not install the duplicate resource.
By default, Force install value is set to No; CICSPlex SM does not normally force the installation of a resource it believes to be a duplicate. However, if you specify YES, you can bypass this duplicate resource checking. CICSPlex SM will install all of the specified resources unconditionally.
- Provide any override expressions.
This identifies attributes of the specified resource whose values are to be overridden when they are installed in one or more of the specified scopes. The value in the Override string field determines which scope the override values are applied to.
(Optional.) An override expression can be made up of one or more attribute expressions in the form:
where:
Override Expression
.-,--------------.
V |
>>---attr--=--value-+--.---------------------------------------><
- attr
- Is the name of a modifiable attribute for the resource.
- value
- Is the value to which you want the attribute set. The following restrictions
apply:
- The value must be a valid one for the attribute.
- If the value contains imbedded blanks or special characters (such as periods,
commas, or equal signs), the entire value string must be enclosed in single
quotes, like this:
DESCRIPTION='Payroll.OCT'. - To include a single quote or apostrophe in a value, you must repeat the
character, like this:
DESCRIPTION='October''s Payroll'.
- Click Yes to action any pre-installation checks and install the
resource definition in the specified CICS systems. The resource definition tabular
view is redisplayed.
If the installation fails, messages containing diagnostic information are displayed on this screen.