Creating, updating, and removing definitions

You can use certain API commands to maintain the CICSPlex SM and CICS definitions in your data repository.

CREATE: Creates a new CICSPlex SM or CICS definition using the attribute values you specify. The new definition is stored in the data repository.
UPDATE: Updates an existing CICSPlex SM> or CICS definition according to the attribute values you specify. The updated definition replaces the existing definition in the data repository.
REMOVE: Removes a CICSPlex SM or CICS definition from the data repository.

Note:

Before you can update or remove a definition you must use the FETCH command to retrieve the appropriate resource table record from a result set.
For CICSPlex SM definitions that have a CICSplex as their context (such as workload management or real-time analysis definitions), any changes you make are automatically distributed to all the CMASs involved in managing the CICSplex.

With each of these commands, you use the FROM option to supply a CICSPlex SM Definition or CICS definition resource table record for the definition you are working with. The record must include all of the attributes in the resource table for the definition. If you do not want to specify certain optional attributes, you must set those fields to null (that is zero) values.

As an alternative, when you are updating CICS definitions, you can use the RESULT and MODIFY options of the UPDATE command. These options enable you to modify multiple definitions at one time (this is the equivalent of issuing the ALTER action command from the CICSPlex SM end-user interface).

To update CICS definitions, identify a result set that contains CICS Definition resource table records in the RESULT option. Then use the MODIFY option to specify the changes to be made to the definitions. MODIFY accepts a modification expression, as described in Modifying resource attributes.