Start of change

Installing resources dynamically using the WUI

To install a resource definition dynamically:

  1. Open a resource definition screen by clicking Administration views-->Basic CICS resource administration views->CICS resource definitions4, then selecting the type of resource to be installed.
  2. Select one or more resources and click the Install action button.
  3. 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 (TRANDEFs) 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:
    • FILEDEF
    • PROGDEF
    • TDQDEF
    • TRANDEF
    Notes:
    1. 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.
    2. 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 TSMDEF Remote system attribute, see Temporary storage model definition attributes.
    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)
    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)
    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).
    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). This mode may be specified only if the Usage value field contains REMOTE.
    Transient data queues (TDQDEF)
    You can identify the type of transient data queue to be installed:
    EXTRA
    Extrapartition TDQ
    IND
    Indirect TDQ
    INTRA
    Intrapartition TDQ
    If you specify N/A, CICSPlex SM uses the Transient data queue type value in the transient data queue definition to install the transient data queue. If this type value is REMOTE, CICSPlex SM installs an indirect TDQ.
    For all other resources, specify N/A because no mode data is required.
    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.
  4. 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:

    The value in the Notify value field determines, which, if any, checks are carried out.

    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 actually 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.
  5. 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.

    If you do not request a state check, CICSPlex SM simply passes the EXEC CICS CREATE request to CICS; if the resource is in a state that prevents it from being replaced, the request fails.

  6. 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:

    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.

  7. 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:

    Read syntax diagramSkip visual syntax diagramOverride Expression
     
       .-,----------.
       V            |
    >>---attr=value-+-.--------------------------------------------><
     
    

    where:

    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’
  8. 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 install fails, messages containing diagnostic information are displayed on this screen.

End of change
4.
You can also access this view from the Fully functional Business Application Services (BAS) administration views menu.

[[ Contents Previous Page | Next Page Index ]]