FTAM/9000 Programmer's Guide

Chapter 4 169

Using Support Functions

Chapter Overview

This chapter describes the following functions in the order listed.

Task to Perform

Function Used

to Perform the

Task

Description

Managing Memory ft_dfdcb() De-allocate memory for DCBs (dynamic DCB

de- allocation)

ft_didcb() Allocate memory for DCBs (dynamic DCB

allocation)

em_fdmemory() Free dynamic memory allocated by

em_gperror() for the return_code and

vendor_code strings

ft_fdmemory() Free dynamic memory allocated by ft_gperror()

for the return_code and vendor_code strings

Responding to

Asynchronous Calls

em_wait() Suspends application processing until a MAP

event occurs

em_hp_select() Suspends application processing until a MAP

or non- MAP event occurs

em_hp_sigio() Notiﬁes that an asynchronous call completed

by way of a SIGIO

Translating Error

Messages

em_gperror() Translate returned Event Management

return_codes and vendor_codes to printable

strings

ft_gperror() Translate returned FTAM return_codes and

vendor_codes to printable strings

Determining

Available Resources

ft_nwcleared() Determine that a resource constraint cleared

and that resource is now available