Resource assignments - RASGNDEF

The Resource assignment definition (RASGNDEF) views display information about the characteristics of resource definitions of a particular resource group and class, and how those resources are to be assigned to and installed in a set of CICS systems.

Supplied views

To access from the main menu, click:

Administration views > Fully functional Business Application Services (BAS) administration views > Resource assignments

Table 1. Views in the supplied **Resource assignment definitions** (RASGNDEF) view set
View	Notes
Resource assignment definitions EYUSTARTRASGNDEF.ADDTODSC	Add one or more resource assignment definitions to a resource description.
Resource assignment definitions EYUSTARTRASGNDEF.CREATE	Create a resource assignment definition and add it to the data repository.
Resource assignment definitions EYUSTARTRASGNDEF.DETAILED	Detailed information about a selected resource assignment definition.
Resource assignment definitions EYUSTARTRASGNDEF.REMOVE	Remove a resource assignment definition from the data repository.
Resource assignment definitions EYUSTARTRASGNDEF.TABULAR	Tabular information about all resource assignment definitions for the current context.

Actions

Table 2. Actions available for RASGNDEF views
Action	Description
ADDTODSC	Add one or more resource assignment definitions to a resource description.
CREATE	Create a resource assignment definition and add it to the data repository.
REMOVE	Remove a resource assignment definition from the data repository.
UPDATE	Update a resource assignment definition in the data repository.

Fields

Table 3. Fields in RASGNDEF views
Field	Attribute name	Description
Last modification agent	CHANGEAGENT	The change agent identifier that made the last modification. DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release	CHANGEAGREL	The CICS release level of the agent that made the last modification.
Last modification	CHANGETIME	The local date and time when the definition was last changed.
Last modification user ID	CHANGEUSRID	The user ID that made the last modification.
Time created	CREATETIME	The local time when the definition was created.
Description code page	DESCCODEPAGE	The code page of the description field.
Description	DESCRIPTION	A description of the resource assignment.
Filter string	FILTER	(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 'attribute operator value'. Valid operators are <, <=, =, =>, > and ¬=. Attribute expressions can be combined using AND or OR operators, parentheses to group expressions and NOT to negate an expression. If a value contains embedded blanks or special characters (including periods, commas or equal signs) the entire value must be enclosed in single quotes. If a single quote is included in a value it should be converted to two single quotes. The filter expression must be terminated with a period.
Resource usage qualifier	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 value you should specify depends on the resource type being assigned: 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. 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. For all other resources, specify N/A because no MODE data is required.
Override string	ORSTRING	(Optional.) Identifies attributes of the specified resources whose values are to be overridden when they are assigned to the scope(s) identified in the OVERRIDE field. The string, that defines which values are to be overridden, can be made up of one or more expressions, of the form attribute=value, separated by commas and terminated with a period. If a value contains embedded blanks or special characters (including periods, commas or equal signs) the entire value must be enclosed in single quotes. If a single quote is included in a value it should be converted to two single quotes.
Scope that override is applied to	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.
Resource type	RDEFTYPE	The type of resources to be processed by the assignment.
Referenced resource assignment name	REFASSGN	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.
Name	RESASSGN	The name of the resource assignment.
Resource group	RESGROUP	The name of the resource group that contains the resource definitions of the specified resource type to be assigned. The resource group information contained in the resource assignment definition (RASGNDEF) takes precedence over the information contained in the association between the resource description and resource assignment (RASINDSC), and over the information contained in the resource description (RESDESC).
Related scope	RSCOPE	The name of the CICS system or system group where resources identified as REMOTE to the target scope are to be assigned as LOCAL. The scope information contained in resource assignments (RASGNDEF) takes precedence over the information contained in the association between the resource description and resource assignment view (RASINDSC), and over the information contained in the resource description view (RESDESC).
Target scope	TSCOPE	The name of the CICS system or system group where the resources are to be assigned. The scope information contained in resource assignments (RASGNDEF) takes precedence over the information contained in the association between the resource description and resource assignment view (RASINDSC), and over the information contained in the resource description view (RESDESC).
Resource usage	USAGE	Indicates how the resources will be used: LOCAL - The resources are contained within the target CICS systems. REMOTE - The resource definitions refer to resources installed in a different CICS system, as identified in the Related Scope field.