z/OS Communications Server: CSM Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CSM application programming interface (API)

z/OS Communications Server: CSM Guide
SC27-3647-00

CSM includes an application programming interface (API) that provides a way to:
  • Obtain and return CSM buffers
  • Change ownership of buffers
  • Copy buffers
  • Manage CSM buffers
Requirement: Applications must be authorized to use CSM.

The storage key for CSM buffers is key 6, fetch protected. Users set up and access data that resides in CSM buffers. These buffers are obtained from buffer pools that are identified by their buffer size and storage type as listed in Table 1.

Table 1. Buffer pools in CSM
Storage types Buffer sizes
31-bit-backed data space 4 KB 16 KB 32 KB 60 KB 180KB
64-bit-backed data space 4 KB 16 KB 32 KB 60 KB 180KB
ECSA 4 KB 16 KB 32 KB 60 KB 180KB

Data space storage is a common area data space and is associated with the master scheduler address space. This association results in a data space that persists for the life of the system.

When an application obtains buffers from CSM, that application is considered the owner of those buffers. Based on application specifications, CSM associates buffer responsibility with an address space or a task within an address space. Applications using CSM have the responsibility of returning owned buffers so that storage is available for other users.

Ownership can be transferred to another user. When this occurs, the new owner is responsible for the return of the buffers. CSM manages buffer reclamation during termination at the task or address space level based on ownership. For detailed information about buffer reclamation during termination, see CSM recovery for normal and abnormal termination.

For more information about buffer ownership, see Ownership of buffers.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014