Resource attribute update parameters

The following table describes the parameters that appear after the common header in the communication area for a resource attribute update exit.

Table 1. User exit parameters: resource attribute update
Parameter Description Can be updated by exit?
Function The primitive CICS-level function about to be performed by this CICS® Configuration Manager API command:
CREATE
The API command is about to perform a DEFINE function for a CSD-based resource definition or a CREATE function for a context-based resource definition.
DELETE
The API command is about to perform a DELETE function for a CSD-based resource definition or a REMOVE function for a context-based resource definition.
UPDATE
The API command is about to perform an ALTER for a CSD-based resource definition or an UPDATE for a context-based resource definition.

For CICSPlex® SM resource definitions, there are two additional functions:

ADD
The API command is about to create an association (xxxINGRP) record for a resource to a ResGroup.
REMOVE
The API command is about to remove an association record for a resource to a ResGroup.
 
Object type Resource definition type. See Table 1.  
Object name Resource definition name.  
Object group Resource definition group (or ResGroup, for a context-based resource definition).  
Description Resource definition description.  
Target CICS configuration type The type of CICS configuration where the resource definition is to be created, updated, or deleted.
CSD
CICS system definition file
CONTEXT
CICSPlex SM context
EXPORT
Export file
 
Target CICS configuration location One of the following, depending on the target CICS configuration type:
  • CSD file data set name
  • CICSPlex SM context name
  • Export file data set name
 
Target resource definition: I/O area and length The attributes of the resource definition. To access the attributes, your user exit program must contain a definition of the layout of this area. Use the layout definitions supplied with CICSPlex SM in the following libraries:
Library
Contains
AEYUCOB
COBOL copybooks
AEYUMAC
Assembler DSECTs
AEYUC370
C typedef structs
AEYUPL1
PL/I DCL structures

The member names in these libraries match the resource definition types.

You must compile your user exit program with the libraries supplied with the release level of CICS Transaction Server for z/OS® that is running the CICS Configuration Manager server CICS region.

Yes  1 
 1 
The CICS Configuration Manager server ignores any changes to resource attributes by a Delete or Rename API command exit.