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

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

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

When you install a resource description, you are installing resources from
resource groups that are associated, either directly or indirectly, with the
description:
- Resources in groups that are directly associated with the description
(using the Resource group in resource description view
) are installed in the CICS systems named in the Resource group
scope name field of the description.
- Resources in groups associated with the description by way of a resource
assignment are installed in the target and related scope systems. These CICS systems
can be identified in the resource assignment, the resource description, or
the association between them (Resource assignment in resource
description view).
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:
- Discards any resources that are associated with the old resource description,
but not the new one.
- Reinstalls any resources that are associated with both the old resource
description and the new one, regardless of whether the definitions have changed.
- Installs any additional resources that are associated with the new resource
description.
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:
- 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.
- 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.
- 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.
- Click Yes to install the resource description in
active CICS systems.

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:
- Automatically at CICS initialization.
This can be done by using the Install Resources field on the CICS system initialization,
as described in CICSPlex System Manager Administration. If you enable automatic
resource installation for a CICS system, all the system links defined for that system
are installed at initialization.
- Dynamically while a CICS system is active.
This can be done by using the
install action command described here. The install action command is useful
for installing individual system links that were not installed at initialization.
To install a system link:
- 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.
- Select the radio button next to the link to be installed and click the Install action button.
This opens an Install input panel.
- 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.
- Click Yes to install the system link in active CICS systems.

You
can also access this view from the Fully functional Business
Application Services (BAS) administration views menu.
You can
also access this view from the Fully functional Business
Application Services (BAS) administration views menu.
[[ Contents Previous Page | Next Page Index ]]