Start of changeInstalling CICS resources using the EUIEnd of change

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.

When you use the install line action command from the RESGROUP view, a series of input panels is produced.

The first panel 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 (RASGNDEF). When you manually install a resource group using the INS action command, 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.

Figure 21 illustrates the first panel for installing a resource group.

Figure 21. Installing a resource group - Page 1
 COMMAND  ===>
 
    Group Name           EYUBAG01     Resource Group
    Assignment      ===>              Resource Assignment name
    Type            ===>              Resource Type to process
 
    Ref Assignment  ===>              Referenced Resource Assignment name
 
    Target Scope    ===>
    Related Scope   ===>
 
    Usage           ===>              How resource is referenced
    Mode            ===>              Resource use qualifier
    Override        ===>              Scope Attribute overrides applied to
 
    Notify          ===>  NO          Precheck (INACTIVE,RELEASE,FULL,NO)
    State Check     ===>  NO          Consistent State (YES,NO)
    Force Install   ===>  NO          Unconditional Install
 
 Press ENTER to Install.
 Type UP or DOWN to view Assignment Select/Override panel.
 Enter END or CANCEL to cancel without installing.
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.

Provide the following information, as appropriate:

Assignment
(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:

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.

Type
Specify the type of resources to be installed. For a list of valid resource types, see Figure 6.
Note:
You cannot dynamically install the following types of resource definition:
  • File key segment definitions (FSEGDEF)
  • Journal defintions (JRNLDEF).
  • Session definitions (SESSDEF).
Ref Assignment
When the 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.
Target Scope
Enter the specific or generic name of an existing CICS system or CICS system group into which the specified resources are to be installed. If you enter a generic value, a list of valid CICS systems and CICS system groups is displayed.
Related Scope
Enter the specific or generic name of an existing CICS system into which those resources identified as REMOTE are to be installed as LOCAL. If you enter a generic value, a list of valid CICS systems is displayed.
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
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 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 and Related Scope 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 parameter 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
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 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 field contains REMOTE, a Mode 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 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.
For all other resources, specify N/A because no Mode data is required.
Override
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
Specify the type of checking to be performed before attempting to install resources in the specified CICS systems:
NO
No checking is performed.
FULL
Perform both INACTIVE and RELEASE checking.
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.
State Check
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
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.

If you are finished specifying installation options, press Enter. If you want to specify a filter or override expression for the resources, issue the DOWN command.

Figure 22 shows the format of the second panel for installing a resource group.

Figure 22. Installing a resource group - Page 2
 COMMAND  ===>
 
    Group Name      EYUBAG01        Resource Group
 
 Filter string expression:  (Type FILTER to list columns)
 ===> NAME='A+B*'.
 ===>
 ===>
 ===>
 ===>
 ===>
 ===>
 ===>
 
 Override string expression:  (Type MODIFY to list modifiable columns)
 ===> DSNAME='CVM.TEST.FILE',STRINGS=4.
 ===>
 ===>
 ===>
 
 Press ENTER to Install Resource Group.
 Type DOWN or UP to view Install options screen.
 Enter END or CANCEL to cancel without installing.

Provide the following information, as appropriate:

Filter string expression
(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 expression
(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 Override 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’
To see a list of resource attributes that can be modified, type MODIFY in the COMMAND field and press Enter.

Press Enter to install the resource group in the specified 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

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 line action command (INS) from the RESDESC view, CICSPlex SM attempts to install all of the resources associated with the resource description into the CICS systems named in the Target 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. Type INS alongside the resource description you wish to install. The panel illustrated in Figure 23 is displayed:

    Figure 23. Installing a resource description
     COMMAND  ===>
     
      Name                EYUBAD03     Description to be installed
     
     
      Notify        ===>  NO           Precheck (INACTIVE, RELEASE, FULL, NO)
      State Check   ===>  NO           Consistent State (YES, NO)
      Force Install ===>  NO           Unconditional Install (YES, NO)
     
     Press ENTER to install Resource Description.
     Enter END or CANCEL to cancel without installing.

    Provide the following information, as appropriate:

    Notify
    Specify 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.
    FULL
    Perform both INACTIVE and RELEASE checking.
    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.
    State Check
    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
    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.

    Press Enter 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.
  2. Provide the system information.
  3. Provide checking information.
  4. Press Enter.
  5. Correct errors.

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:

Figure 24 shows the format of the panel produced when you use the install (INS) line action command from the SYSLINK view.

Figure 24. Installing a CICS system link
 COMMAND  ===>
 
    Primary System     EYUMAS1A
    Secondary System   EYUMAS1B
 
    ConnDef Name       CON1         Version   1
    SessDef Name       SESSDEF1     Version   1
 
    Notify        ===> NO           Precheck (INACTIVE, RELEASE, FULL, NO)
    State Check   ===> NO           Consistent State (YES, NO)
    Force Install ===> NO           Unconditional Install (YES, NO)
 
 
 Press ENTER to install SYSLINK.
 Type END or CANCEL to cancel without installing.

Provide the following information, as appropriate:

Notify
Specify the type of checking to be performed before attempting to install the CICS system link:
NO
No checking is performed.
FULL
Perform both INACTIVE and RELEASE checking.
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.
State Check
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
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.

Press Enter 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
[[ Contents Previous Page | Next Page Index ]]