Start of change

Installing CICS resources using the WUI

Start of changeInstalling resource groupsEnd of change

When you install a resource group, you can install some or all of the resources of a single given type contained in the group. You can use a filter expression to select the resources to be installed. You can either specify the required CICS® system and usage information for the resources, or you can refer to an existing resource assignment for that information. And, just as you can for individual resources, you can provide temporary override values for specific attributes of the selected resources.

Follow this procedure:

  1. From the WUI main menu, click Administration views-->Basic CICS resource administration views-->Resource groups to open the Resource group definition tabular view. This view lists the existing resource groups in the current context.
  2. Select the resource group to be installed and click the Install action button.

    This opens an Install screen like the one shown in Figure 18. This screen prompts you to provide information about the resource definitions in the group and how the resources are to be installed. This information is normally supplied in a resource assignment. When you manually install a resource group using the Install action button, you can either specify the install options explicitly or refer to an existing resource assignment. If you name a resource assignment, any values that you do specify here temporarily override the equivalent values in the assignment.

    Note:
    Any values that you specify on this panel are in effect only for the duration of this single installation process. No resource assignments are created or updated as a result of this panel. If you want to use the same set of install options more than once, you should create a new resource assignment.
  3. Provide the following information, as appropriate:
    Resource assignment value
    (Optional.) Enter the specific or generic name of an existing resource assignment whose values are to be used for this installation. If you enter a generic value, a list of valid resource assignments is displayed.

    If you specify an assignment name, the following fields are optional on this panel:

    • Target scope value
    • Related scope value
    • Usage value
    • Mode value
    • Override value

    If you do supply values in these fields, those values temporarily override the equivalent assignment values. If you do not specify an assignment name, these fields are required.

    Resource type
    Select the type of resources to be installed from the drop down list.
    Note:
    You cannot dynamically install the following types of resource definition:
    • File key segment definitions (FSEGDEF)
    • Journal defintions (JRNLDEF).
    • Session definitions (SESSDEF).
    Referenced assignment name
    When the Resource type field contains CONNDEF (for connections), identify the resource assignment that applies to the related session definitions (SESSDEF). For each connection, CICSPlex® SM requires one or more session definitions to properly construct the actual CICS link. Clicking on the adjacent dynamic selection list icon opens a resource selection screen, allowing you to choose a resource from a list of those available.
    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
    Enter the specific or generic name of an existing CICS system into which those resources identified as REMOTE are 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 resources will be used:
    LOCAL
    The resources are contained within the target CICS system. LOCAL is valid for all supported resource types.
    REMOTE
    The resource definitions refer to resources that reside 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 the local instances of the resources. 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:
    Start of change
    Programs (PROGDEF)
    If you specified LOCAL in the Usage 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.

    If REMOTE is specified in the Usage field, you can identify how the program is to be routed:

    DYNAM
    Programs are processed by the dynamic routing program (DTR).
    STAT
    Programs are sent to the remote CICS system identified in the Related Scope
    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.
    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.
    Note:
    The value you specify here overrides the Dynamic value in the TRANDEF.
    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 Type value in the TDQDEF to install the transient data queue. If the Type value is REMOTE, CICSPlex SM installs an indirect TDQ.
    End of change
    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 resources, indicate which scope the override values should be applied to:
    BOTH
    Apply the override values to both scopes.
    NONE
    Do not apply any override values.
    RELATED
    Apply the override values to the Related Scope only.
    TARGET
    Apply the override values to the Target Scope only.
    Notify value
    Specify the type of checking to be performed before attempting to install resources in the specified CICS systems:
    NO
    No checking is performed.
    INACTIVE
    Check for CICS systems in the target scope that are not currently active.
    RELEASE
    Check for CICS systems in the target scope that do not support EXEC CICS CREATE commands.
    FULL
    Perform both INACTIVE and RELEASE checking.
    State check value
    Indicate whether or not the existence and operational state of all resources are to be checked before an EXEC CICS CREATE command is issued.
    NO
    The existence and operational state of all resources are not to be checked.
    YES
    The existence and operational state of all resources are to be checked.
    Force install value
    Specify YES or NO to indicate whether you want to install the resources even if CICSPlex SM believes they do not need to be installed.

    Normally, CICSPlex SM checks to see if it was responsible for placing the currently installed resource in the CICS system. If so, CICSPlex SM does not install the resource, to avoid inadvertently changing attributes of an active resource.

    If you specify YES in this field, CICSPlex SM bypasses this duplicate resource checking and installs the new resource unconditionally.

    Filter string
    (Optional.) Identifies attributes that are to be used in selecting the resources to be installed. CICSPlex SM processes only those resources that meet the specified filter criteria.

    A filter expression can be made up of one or more attribute expressions in the form:

    Read syntax diagramSkip visual syntax diagramFilter expression
     
    >>-| logic_expr |-.--------------------------------------------><
     
    logic_expr:
     
       .-AND/OR-------------------------.
       V                                |
    |----+-----+-+-| attr_expr |------+-+---------------------------|
         '-NOT-' '-(-| logic_expr |-)-'
     
    attr_expr:
     
    |--attropervalue------------------------------------------------|
     
    

    where:

    attr
    Is the name of an attribute in the resource table for the specified resource. You can name the same attribute more than once in a filter expression.
    oper
    Is one of the following comparison operators:
    <
    Less than
    <=
    Less than or equal to
    =
    Equal to
    >=
    Greater than or equal to
    >
    Greater than
    ¬=
    Not equal to
    value
    Is the value for which the attribute is being tested. The value must be a valid one for the attribute.

    If the attribute accepts character data, this value can be generic. Generic values can contain:

    • An asterisk (*), to represent any number of characters, including zero. The asterisk must be the last or only character in the specified value. For example:
        TRANID=PAY*
    • A plus sign (+), to represent a single character. A + can appear in one or more positions in the specified value. For example:
        TRANID=PY++

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

      TERMID=‘Z AB’

    To include a single quote or apostrophe in a value, you must repeat the character, like this:

      DESCRIPTION=‘October''s Payroll’
    AND/OR
    Combines attribute expressions into compound logic expressions using the logical operators AND and OR, like this:
      attr_expr AND attr_expr.

    Filter expressions are evaluated from left to right. You can use parentheses to vary the meaning of a filter expression. For example, this expression:

      attr_expr AND (attr_expr OR attr_expr).

    has a different meaning than this one:

      (attr_expr AND attr_expr) OR attr_expr.
    NOT
    Negates one or more attribute expressions.

    You can negate a single attribute expression, like this:

      NOT attr_expr

    You can also negate multiple attribute expressions or even a whole filter expression, like this:

      NOT (attr_expr OR attr_expr).

    Note that you must place parentheses around the attribute expressions (or the filter expression) to be negated.

    To see a list of the resource attributes, type FILTER in the COMMAND field and press Enter.
    Override string
    (Optional.) Identifies attributes of the specified resources whose values are to be overridden when they are installed in one or more of the specified scopes. (The value in the Overtype value field determines which scope the override values are applied to.)

    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’
  4. Click Yes to install the resource group in the specified CICS systems.

Related concepts
Deciding where resources should be installed
Automatic resource installation
Dynamic resource installation

Installing resource descriptions

When you install a resource description, you are installing resources from resource groups that are associated, either directly or indirectly, with the description:

You can also replace the resources associated with an installed resource description with the resources associated with a new description. When you replace a resource description, CICSPlex SM:

When you use the install action from the Resource description definition view, CICSPlex SM attempts to install all of the resources associated with the resource description into the CICS systems named in the t arget scope and related scope fields. For resource installation to occur, the CICS systems must be active and must be running a release of CICS that supports the EXEC CICS CREATE command.

To install a resource description:

  1. From the WUI main menu, click Administration views-->Basic CICS resource administration views-->Resource descriptions2 to open the Resource description definition tabular view. This view lists the existing resource descriptions in the current context.
  2. Select the resource description to be installed and click the Install action button.

    This opens an Install input panel like the one shown in Figure 19.

  3. Provide the following information, as appropriate:
    Notify value
    Select the type of checking to be performed before attempting to install resources in the CICS systems associated with the description:
    NO
    No checking is performed.
    INACTIVE
    Check for CICS systems in the target scope that are not currently active.
    RELEASE
    Check for CICS systems in the target scope that do not support EXEC CICS CREATE commands.
    FULL
    Perform both INACTIVE and RELEASE checking.
    State check value
    Indicate whether or not the existence and operational state of all resources are to be checked before an EXEC CICS CREATE command is issued.
    NO
    The existence and operational state of all resources are not to be checked.
    YES
    The existence and operational state of all resources are to be checked.
    Force install value
    Indicate whether or not you want to install the resources even if CICSPlex SM believes they do not need to be installed.
    NO
    Do not force the installation of resources.
    YES
    Force the installation of resources.

    Normally, CICSPlex SM checks to see if it was responsible for placing the currently installed resource in the CICS system. If so, CICSPlex SM does not install the resource, to avoid inadvertently changing attributes of an active resource.

    If you specify YES in this field, CICSPlex SM bypasses this duplicate resource checking and installs the new resource unconditionally.

  4. Click Yes to install the resource description in active CICS systems.
    Note:
    For information on what happens if your installation request does not complete successfully, see Handling dynamic installation errors in the EUI.

Related concepts
Deciding where resources should be installed
Automatic resource installation
Dynamic resource installation
Related tasks
Installing resource groups
Installing system links

Installing system links

When you install a system link, you are establishing a communications link between two CICS systems that are being managed by CICSPlex SM. The connection and session definitions referred to by that system link are installed in the target CICS systems.

Once you have created a CICS system link, it must be installed in order for it to become an actual connection in the CICSplex. CICS system links can be installed:

To install a system link:

  1. From the WUI main menu, click Administration views-->Basic CICS resource administration views-->CICS system links3 to open the System link definition tabular view like the one shown in Figure 20. This view lists the system link definitions in the current context.
  2. Select the radio button next to the link to be installed and click the Install action button.

    This opens an Install input panel.

  3. Provide the following information, as appropriate:
    Notify value
    Specify the type of checking to be performed before attempting to install the CICS system link:
    NO
    No checking is performed.
    INACTIVE
    Check for CICS systems in the target scope that are not currently active.
    RELEASE
    Check for CICS systems in the target scope that do not support EXEC CICS CREATE commands.
    FULL
    Perform both INACTIVE and RELEASE checking.
    State check value
    Indicate whether or not the existence and operational state of all resources are to be checked before an EXEC CICS CREATE command is issued.
    NO
    The existence and operational state of all resources are not to be checked.
    YES
    The existence and operational state of all resources are to be checked.
    Force install value
    Indicate whether or not you want to install the resources even if CICSPlex SM believes they do not need to be installed.
    NO
    Do not force the installation of resources.
    YES
    Force the installation of resources.

    Normally, CICSPlex SM checks to see if it was responsible for placing the currently installed system link in the CICS system. If so, CICSPlex SM does not install the resource, to avoid inadvertently changing attributes of an active resource.

    If you specify YES in this field, CICSPlex SM bypasses this duplicate resource checking and installs the new system link unconditionally.

  4. Click Yes to install the system link in active CICS systems.

Related concepts
Deciding where resources should be installed
Automatic resource installation
Dynamic resource installation
Related tasks
Installing resource groups
Installing resource descriptions
End of change
2.
You can also access this view from the Fully functional Business Application Services (BAS) administration views menu.
3.
You can also access this view from the Fully functional Business Application Services (BAS) administration views menu.

[[ Contents Previous Page | Next Page Index ]]