Resource assignment attribute descriptions

Provide the following information, as appropriate:

Assignment Name
The specific or generic name of an existing resource assignment that you want to associate with a resource description. If you enter a generic value, a list of valid resource assignments is displayed.
Description
(Optional.) A 1- to 30-character description of a resource assignment or a resource assignment-to-description association..
Description Name
The specific or generic name of an existing resource description with which a resource assignment is to be associated. If you enter a generic value, a list of valid resource descriptions is displayed.
Filter string expression
(Optional.) Identifies attributes that are to be used in selecting resources to be assigned. 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=PAY++96

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.

Group Name
The specific or generic name of a resource group that contains, or will contain, resource definitions to be processed by a resource assignment. If you enter a generic value, a list of all resource groups is displayed.
Mode
For some resource types, CICSPlex SM requires additional information to determine which subset of resource attributes to use in processing a resource assignment. The Mode value you should specify depends on the resource type being assigned:
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 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 when creating a resource assignment overrides the Dynamic value in the TRANDEF.
Transient data queues (TDQDEF)
You can identify the type of transient data queue to be assigned:
EXTRA
Extrapartition TDQ.
IND
Indirect TDQ.
INTRA
Intrapartition TDQ.
If you specify N/A, CICSPlex SM uses the Type value in the TDQDEF to assign the transient data queue. If the Type value is REMOTE, CICSPlex SM assigns an indirect TDQ.
End of change
For all other resources, specify N/A because no Mode data is required.
Name
A 1- to 8-character name for the resource assignment. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
Override
If you plan to specify an override expression for the resources, indicate to which scope the override values should be applied:
NONE
Do not apply any override values.
BOTH
Apply the override values to both scopes.
RELATED
Apply the override values to the Related Scope only.
TARGET
Apply the override values to the Target Scope only.
Override string expression
(Optional.) Identifies attributes of the specified resources whose values are to be overridden when they are assigned to one or more 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.

Referenced Assign
The resource assignment that applies to the related session definitions (SESSDEF) when a Resource Type field contains CONNDEF (for connections). For each connection, CICSPlex SM requires one or more session definitions to construct the actual CICS link properly.
Related Scope
The specific or generic name of an existing CICS system to which remote resources are to be assigned as LOCAL, if you specify a Usage value of REMOTE. If you enter a generic value, a list of valid CICS systems is displayed.

If you specify a Usage value of REMOTE when you are creating a resource assignment, and you do not specify a Related Scope value, you must provide one in the associated RASINDSC or RESDESC definition.

Notes:
  1. You must also specify a Related Scope value when assigning connections (CONNDEF) that reference other CICS systems in the same CICSplex.
  2. 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.
Resource Group
The specific or generic name of an existing resource group that contains, or will contain, resource definitions of a specified type. If you enter a generic value, a list of all resource groups is displayed.

If you do not specify a Resource Group value when you are creating a resource assignment, you must provide one in the associated RASINDSC or RESDESC definition.

Resource Type
The type of resource to be processed by an assignment statement. For a list of valid resource types, see Figure 6.
Target Scope
The specific or generic name of an existing CICS system or CICS system group to which the resurces named in a resource assignment are to be assigned. If you enter a generic value, a list of valid CICS systems and CICS system groups is displayed.

If you do not specify a Target Scope value when creating a resource assignment, you must provide one in the associated RASINDSC or RESDESC definition.

Usage
Specifies 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 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.

Related concepts
Resource assignments
RASGNDEF (resource assignments) view
Related tasks
Accessing BAS administration views using the EUI
Accessing the RASGNDEF view
Working with the RASGNDEF view
Creating a resource assignment
Adding a resource assignment to a resource description
[[ Contents Previous Page | Next Page Index ]]