Start of change

Defining the WS-AT data set

The data set you require to enable CICS® Web Services Atomic Transaction (WS-AT) support is the WS-AT directory data set, DFHPIDIR. The WS-AT directory data set, DFHPIDIR, is a file containing a mapping between contexts and tasks.

The WS-AT directory and object store data set, DFHPIDIR, is a CICS file-control-managed data set that requires a resource definition in the CSD. Because the data set is shared across CICS regions that together provide a WS-AT capable Web service provider, you can define it to CICS file control in these ways:

Figure 28 shows the statements used to define DFHPIDIR.

Figure 28. Example JCL to define the WS-AT directory data set
DEFINE CLUSTER(NAME(@dsindex@.CICS@regname@.DFHPIDIR)-           
	INDEXED-
	LOG(UNDO)-        1  
	CYL(2 1)-                   
	VOLUME(@dsvol@)-             2           
	RECORDSIZE( 1017 1017 )-      3                    
	KEYS( 16 0 )-                                             
	FREESPACE ( 10 10 )-                                            
	SHAREOPTIONS(2 3 ))-                                         
DATA  (NAME(@dsindex@.CICS@regname@.DFHPIDIR.DATA)-              
	CONTROLINTERVALSIZE(1024)) -                              
INDEX (NAME(@dsindex@.CICS@regname@.DFHPIDIR.INDEX))                             

 1  Define the backout recovery attribute in the ICF catalog, so that the data set defined by this job can be used in either RLS or non-RLS mode. For data sets used in RLS mode, you define the recovery attributes in the ICF catalog, and these attributes override any that are specified in the CICS file resource definition. You must define the PI directory data set as recoverable.

 2  Specify your own value for the VOLUME parameter, or remove it completely if you are using SMS-managed storage.

 3  The default record size is 1 KB, which can be changed.

Note:
You do not change any of the definition values shown in Figure 28. DFHPIDIR contains only one record, its control record. However, ensure that runtime settings are specified (such as BUFND, BUFNI; and STRNO subparameters on the AMP parameter on the DD statement, or the equivalent in the CICS file resource definition) to support the maximum number of requests that might be active at any one time.
End of change [[ Contents Previous Page | Next Page Index ]]