FTAM/9000 Programmer's Guide

Chapter 7 303

Managing and Accessing HP FTAM/9000 Files

Grouping LLCS FTAM Functions

Use ft_bgroup() and ft_egroup() to begin and end the grouping of low

level FTAM functions and thus, increase performance. The ftam_init

places these functions into one presentation service data unit (PSDU)

before sending it across the network.

For a group to be successful, all functions moving from one regime to

another must be successful (regardless of whether the calls that do not

move through regimes succeed).

If a failure occurs on a function that crosses regimes and if the

SUCCESS count does not equal or exceed threshold, no remaining calls,

except ft_egroup(), are processed and you receive an error.

Allowable Groupings

Refer to the following guidelines for grouping FTAM functions and for

reading the following table. The table lists the legal groupings with the

associated sequence of LLCS functions (from left to right).

• All groups must begin with ft_bgroup() and end with ft_egroup().

• The ﬁrst function you want to call after ft_bgroup() determines which

regime you must be in to call ft_bgroup().

• You must call all functions within the group asynchronously except

for ft_egroup(), which can be synchronous or asynchronous.

• If more than one function is listed in a ``Mandatory'' column, you

must perform both functions in the order listed.

EXAMPLE: The ﬁrst grouping (#1) in the table reads as follows.

1. Call ft_bgroup().

2. Call either ft_create() if the ﬁle does not exist or

ft_select() if it does.

3. Call either or both ft_rattributes() and

ft_cattributes().

4. Call ft_open() followed by ft_egroup().