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:
- Target Scope
- Related Scope
- Usage
- Mode
- Override
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:
- 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.
- 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:

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

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:
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.
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
(via RESINDSC) are installed in the CICS systems named in the ResGroup Scope field
of the description.
- Resources in groups associated with the description by way of a resource
assignment (RASGNDEF) 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 (RASINDSC).
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 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:
- 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.
- Provide the system information.
- Provide checking information.
- Press Enter.
- Correct errors.

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 CICSSYS definition, 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.
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.
[[ Contents Previous Page | Next Page Index ]]