pdel -- Delete a Storage Pool

SYNOPSIS

 #include <pool.h>

 void pdel(POOL_t *p);
 

DESCRIPTION

pdel releases all elements of a storage pool (allocated by the pool function) and frees associated storage. p is a pointer that points to the storage pool. It is not necessary to free all the elements of the pool before deleting it.

RETURN VALUE

pdel has no return value.

ERRORS

User ABEND 1206, 1207, or 1208 may occur if memory management data areas are overlaid. User ABEND 1208 will probably occur if the block pointer is invalid; that is, if it does not address a previously allocated area of memory that has not already been freed.

CAUTION

Deleting a storage pool twice or calling pdel with a random argument usually results in an ABEND.

Do not reference pool elements after the pool has been deleted.

EXAMPLE

See the example for pool.

RELATED FUNCTIONS

free, pool

SEE ALSO

Memory Allocation Functions

Copyright (c) 1998 SAS Institute Inc. Cary, NC, USA. All rights reserved.