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.  
Start of change Target CICS configuration End of change Start of change The name of the CICS configuration where the resource definition is to be created, updated, or deleted. End of change Start of change   End of change
Target CICS configuration type One of the following:
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.

Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ccv-server-exit-parms-attribute.htm