Installing resource groups
When you install a resource group, you can install some or all of the resources of a single given type contained in the group.
About this task
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.
Procedure
- From the WUI main menu, click Administration views > Basic CICS resource administration views > Resource groups to open the Resource group definitions tabular view. This view lists the existing resource groups in the current context.
- Select the resource group to be installed and click the Install button
to display the Install view. 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.
- 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
- 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 objects)
- Journal defintions (JRNLDEF objects).
- Session definitions (SESSDEF objects).
- Referenced assignment name
- When the Resource type field contains CONNDEF (for connections),
identify the resource assignment that applies to the related session
definitions (SESSDEF objects). For each connection, CICSPlex® SM requires
one or more session definitions to properly construct the actual CICS link.
Clicking on the adjacent
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 (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 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:
- 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 TSMDEF Remote system attribute, see Temporary storage model definitions - TSMDEF.
- 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 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.
- 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:
where:
Filter expression
>>-| logic_expr |--.-------------------------------------------><
logic_expr
.-AND/OR----------------------------.
V |
|----+-----+--+-| attr_expr |--------+-+------------------------|
'-NOT-' '-(--| logic_expr |--)-'
attr_expr
|--attr--oper--value--------------------------------------------|
- 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++
TERMID='Z AB'To include a single quote or apostrophe in a value, you must repeat the character, like this:DESCRIPTION='October''s Payroll' - 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:
- 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:
has a different meaning than this one:attr_expr AND (attr_expr OR attr_expr).(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_exprYou can also negate multiple attribute expressions or even a whole filter expression, like this:
Note that you must place parentheses around the attribute expressions (or the filter expression) to be negated.NOT (attr_expr OR attr_expr).
- 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:
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 install the resource group in the specified CICS systems.
eyuacx6.html |
Last updated: Sunday, 4 June 2017