Modifying resource attributes

You can change the current value of a resource attribute by using the SET or UPDATE command.

SET modifies the attributes of a CICS® resource, while UPDATE modifies CICSPlex® SM and CICS definitions. The MODIFY option of these commands accepts a modification expression, which is a character string that defines the attribute changes to be made.

A modification expression can be made up of one or more attribute expressions in the form:
Read syntax diagramSkip visual syntax diagram
Modification Expression

   .-,--------------.      
   V                |      
>>---attr--=--value-+--.---------------------------------------><

where:
attr
Is the name of a modifiable attribute in the resource table.
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'
Note: Be sure to consider the quoting conventions of your programming language when using single quotes in a CICSPlex SM value string.
Note: A modification expression must be followed by either blank spaces or null characters to the end of the specified buffer. That is, the buffer length you specify (using the LENGTH option) should not include any data other than a modification expression.
For example, to disable one or more local transactions (LOCTRAN), you could specify:
  STATUS=DISABLED.

in the MODIFY option of a SET command.

If you issue a SET command against CICS systems that do not support the requested modification, the request is ignored for those CICS systems. If your context and scope consist solely of CICS systems that do not support the modification, you receive RESPONSE and REASON values of NOTAVAILABLE SCOPE.

To change the task storage location of a CICS transaction definition (TRANDEF), you could specify:
  TASKDATALOC=ANY

in the MODIFY option of an UPDATE command.

Note that the MODIFY option of UPDATE is valid only for CICS Definition resource tables.

For a list of the attributes for each resource and their valid values, see CICSPlex SM resource tables.



eyup1bf.html | Timestamp icon Last updated: Sunday, 4 June 2017