z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Effect of CFLEVEL on MAXELEMNUM

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

Even if you request that a structure be allocated in a CFLEVEL=1 or higher coupling facility (thus allowing up to 255 data elements per data entry), the system might need to allocate the structure in a CFLEVEL=0 coupling facility instead. The system will attempt to allocate the structure with an entry size as great as that specified on the IXLCONN invocation and then adjust the number of data elements to fit into the entry size. You can examine the resulting data element and data entry values in the connect answer area.

For example: You request to connect to a structure with a data element size of 256 bytes and a MAXELEMNUM of 128 (thus implying a CFLEVEL=1 or higher coupling facility). The maximum entry size is 32K (256 bytes x 128). If the system is forced to allocate the structure in a CFLEVEL=0 coupling facility, it will allocate the structure with a data element size of 2K and a MAXELEMNUM of 16. The maximum entry size is still 32K, but the MAXELEMNUM is changed to conform to the maximum allowed in a CFLEVEL=0 coupling facility. (The system increases the data element size by the same power of 2 by which the MAXELEMNUM value was decreased.)

Note that a change to MAXELEMNUM will have a corresponding effect on the entry-to-element ratio you specify. If the system changes the element size, it also must change the entry-to-element ratio to suit the maximum entry size. The ratio is adjusted by the same power of 2 calculation described above.) You can examine the resulting entry-to-element ratio information in the connect answer area.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014