Maintenance of resource definitions

As part of the ongoing maintenance of your CICSplex resources, it may be necessary to update existing resource definitions. You can update resource definitions in the CICSPlex® SM data repository by:

Update a resource definition

When you update a resource definition, you are changing an existing resource definition in the CICSPlex SM data repository. Any changes you make affect the resource as it is assigned to various CICS® systems; this, in turn, affects any logical scope or application that includes the resource. However, the resource that exists in active CICS systems is not affected when you update the resource definition. The actual resource will not match the updated resource definition until the next time it is installed, either automatically at system initialization or dynamically into an active system.

Every CICSPlex SM resource definition view supports an UPDate action command, which enables you to update the attributes of a single definition that is currently displayed in a view. For example, to update a connection definition, you would:

  1. Display the CONNDEF view.
  2. Issue the UPD line action command next to the resource definition you want to update.
  3. Modify the attributes of the connection on the Update Connection Definition panels.

The update panels for a resource definition are similar to the panels for creating a definition. When you update a resource definition, you are updating a specific version of the definition as it exists in the data repository. Any changes that you make have no immediate effect on CICS systems that are currently active. Changes to a resource definition take effect the next time the definition is installed in a CICS system (either dynamically or automatically at CICS initialization).

Figure 8 is an example of the first input panel produced when you are updating a resource definition.

Figure 8. Updating a resource definition - Page 1
 ------------ Update Connection Definition for EYUPLX01 Page 1 ------------------
 COMMAND  ===>
  Name              C00A      Version   0
  Description  ===> System A Connection
  Created          1/09/97  08:36    Changed      1/09/97  08:36
  User Data    ===>
 
  AccessMethod ===> VTAM      Access Method (VTAM, INDIRECT, IRC, XCF, XM,
                                NETBIOS, TCPIP)
  Attachsec    ===> LOCAL     Attach-time security
                                (LOCAL,IDENTIFY,MIXIDPE,PERSISTENT,VERIFY)
  AutoConnect  ===> NO        Autoconnect sessions to VTAM (NO,ALL,YES)
  ConnType     ===> NOTAPPLIC Nature of connection (GENERIC, SPECIFIC,
                                 APPC, NETBIOS, TCPIP, NOTAPPLIC)
  Datastream   ===> USER      Data stream type (USER,LMS,SCS,STRFIELD,3270)
  IndirectSys  ===>           Intermediate system name
  Inservice    ===> YES       Connection status (YES,NO)
  MaxQueTime   ===> NO        Maximum queue time (NO, 0-9999, blank)
  NetName      ===>           Network name
  Protocol     ===> APPC      Protocol (APPC,EXCI,LU61,NOTAPPLIC)
 
 Press ENTER to update CONNDEF.
 Enter UP or DOWN to view other screens.
 Type END or CANCEL to cancel without updating.
Note:
The update and browse panels for a resource definition are identical. Most of the fields in the update panels are modifiable; the fields in the browse panels are not.

The Name, Description, and User Data fields are the same fields that appear on the create panel, as shown in Figure 7. The RESGROUP field that appears on the create panel does not appear when you are updating or browsing a resource definition. You can add a resource definition to a resource group when you create the definition, but not when you update it.

The update panels also contain some fields that do not appear on the create panels. These fields are not modifiable:

Created
The date and time at which the resource definition was created.
Changed
The date and time at which the resource definition was last updated.
Notes:
  1. The Created and Changed values are recorded using the time zone of the maintenance point CMAS, not the user who created or changed the resource definition. In addition, these values are fixed at the time they are recorded; they are not affected by any subsequent changes to the time zone of the maintenance point CMAS.
  2. For any resource definitions that contain password fields, the password is not displayed on the update panels. The field name appears highlighted to indicate a password exists; the field itself contains blanks. You can use the update panel to change or remove an existing password or add a new password for the resource definition.
  3. Updating a resource definition that is associated with a resource group could result in inconsistent resource set errors. For information about this type of problem and how to resolve it, see Validation of a set of resources.
  4. You cannot change the Name field or the Version field when you update a resource definition.

Browse a resource definition

To browse a resource definition, enter the BRO line action command next to the definition you want to display.

The browse panels are similar to the panels used to create the definition; see Figure 9.

Figure 9. Browsing a resource definition - Page 1
 ------------ Browse Connection Definition for EYUPLX01 Page 1 ------------------
 COMMAND  ===>
  Name              C00A      Version   0
  Description  ===> System A Connection
  Created          1/09/97  08:36    Changed      1/09/97  08:36
  User Data    ===>
 
  AccessMethod ===> VTAM      Access Method (VTAM, INDIRECT, IRC, XCF, XM,
                                NETBIOS, TCPIP)
  Attachsec    ===> LOCAL     Attach-time security
                                (LOCAL,IDENTIFY,MIXIDPE,PERSISTENT,VERIFY)
  AutoConnect  ===> NO        Autoconnect sessions to VTAM (NO,ALL,YES)
  ConnType     ===> NOTAPPLIC Nature of connection (GENERIC, SPECIFIC,
                                 APPC, NETBIOS, TCPIP, NOTAPPLIC)
  Datastream   ===> USER      Data stream type (USER,LMS,SCS,STRFIELD,3270)
  IndirectSys  ===>           Intermediate system name
  Inservice    ===> YES       Connection status (YES,NO)
  MaxQueTime   ===> NO        Maximum queue time (NO, 0-9999, blank)
  NetName      ===>           Network name
  Protocol     ===> APPC      Protocol (APPC,EXCI,LU61,NOTAPPLIC)
 
 
 Enter UP or DOWN to view other screens.
 Type END or CANCEL to cancel.
Note:
The update and browse panels for a resource definition are identical. Most of the fields in the update panels are modifiable; the fields in the browse panels are not.

The browse panels contain some fields that do not appear on the create panels:

Created
The date and time at which the resource definition was created.
Changed
The date and time at which the resource definition was last updated.
Notes:
  1. The Created and Changed values are recorded using the time zone of the maintenance point CMAS, not the user who created or changed the resource definition. In addition, these values are fixed at the time they are recorded; they are not affected by any subsequent changes to the time zone of the maintenance point CMAS.
  2. For any resource definitions that contain password fields, the password is not displayed on the browse panels. The field name appears highlighted to indicate a password exists; the field itself contains blanks.

Alter multiple resource definitions

Every CICSPlex SM resource definition view supports an ALTER action command, which enables you to update the attributes of multiple definitions at one time, regardless of whether those definitions are currently displayed in a view.

For example, to update several connection definitions that share common attributes, you would:

  1. Display the CONNDEF view.
  2. Issue the ALTER action command.
  3. Complete the Alter CICS Resource panel.

The alter panel for resource definitions prompts you to:

CICSPlex SM attempts to apply the changes you specified to all of the resource definitions you identified at one time. If the changes cannot be applied to a given resource definition as specified, the update panels for that definition are displayed.

For example, the specified change might conflict with an existing attribute, or the modification of one field might require you to specify an attribute that was not needed previously. When the resource definition update panels appear, you are prompted to provide the necessary information that would allow the resource definition to be updated.

Provide the following information, as appropriate:

Resource Group
(Optional) Enter the specific or generic name of an existing resource group from which the resource definitions are to be selected. If you enter a generic value, a list of valid resource groups is displayed.
Filter string expression
(Optional) Identify resource attributes that are to be used in selecting the definitions to be altered. CICSPlex SM alters only those definitions 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 definition. 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 attributes in the specified resource definition, type FILTER in the COMMAND field and press Enter.
Alter string expression
Identify those attributes of the selected resource definitions whose values are to be altered.

An alter expression can be made up of one or more attribute expressions in the form:

Read syntax diagramSkip visual syntax diagramAlter Expression
 
   .-,----------.
   V            |
>>---attr=value-+-.--------------------------------------------><
 

where:

attr
Is the name of a modifiable attribute in the resource definition.
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 attributes in the resource definition that can be modified, type MODIFY in the COMMAND field and press Enter.

When you press Enter, CICSPlex SM first validates the information on this panel to ensure that:

The alter panel remains displayed while CICSPlex SM attempts to alter the selected resource definitions.

If CICSPlex SM detects an error while attempting to alter a specific resource definition, the alteration process is suspended and the update panel for that resource is displayed. The panel includes an error message that describes the problem and the cursor is positioned on the field that is in error. When the resource definition update panel appears, you can:

When CICSPlex SM finishes altering the selected resource definitions, you are returned to the view where you issued the alter request.

Remove a resource definition

You can use the REMove action command to remove a resource definition from the CICSPlex SM data repository.

Figure 10 shows the format of the panel produced when you issue the remove primary (REMove) or line (REM) action command from a resource definition view.

Figure 10. Removing a resource definition
 COMMAND  ===>
 
    Name                FILEDF01  Version   0
    Description
 
    Type                File Definition
 
 
 
  WARNING:  For this definition type, removal will cascade through
  related associations.
 
 
 Press ENTER to remove.
 Type END or CANCEL to cancel without removing.

From this panel you can verify which resource definition is being removed:

Name
The name of the resource definition being removed.
Version
The version of the resource definition being removed.
Description
A description of the resource definition being removed, if one was specified.
Type
The type of resource definition being removed.

Press Enter to remove the resource definition from the CICSPlex SM data repository. To cancel the remove action, type END or CANCEL; the resource definition remains in the data repository.

Related concepts
Using the end user interface to define CICS resources
Common EUI resource definition actions
Common EUI definition fields
Multiple versions of a resource definition
Availability for CICS releases
Creation of resource definitions
Links between CICS systems
Resource definition validation
Management of CICS resources using CICSPlex SM
Installation of CICS resources
[[ Contents Previous Page | Next Page Index ]]