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:
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:
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.
------------ 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.
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:
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.
------------ 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.
The browse panels contain some fields that do not appear on the create panels:
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:
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:
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:
If the attribute accepts character data, this value can be generic. Generic values can contain:
TRANID=PAY*
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’
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.
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.
An alter expression can be made up of one or more attribute expressions in the form:
Alter Expression .-,----------. V | >>---attr=value-+-.--------------------------------------------><
where:
DESCRIPTION=‘Payroll.OCT’
DESCRIPTION=‘October''s Payroll’
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:
For each additional error that is detected, the update panel is redisplayed, until all the resource definitions have been successfully altered.
When CICSPlex SM finishes altering the selected resource definitions, you are returned to the view where you issued the alter request.
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.
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:
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.