OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-21
Setting the Threshold Parameter
Setting the Threshold Parameter
The threshold parameter specifies how many primitives (not including the
F-BEGIN-GROUP and F-END-GROUP primitives) must succeed before the group can
be considered successful. Success occurs when a primitive returns a state-result
value other than ZFTM-VAL-STATE-FAILURE. If threshold is set to the total number
of primitives in the group, the primitives in the group succeed or fail as a group. If a
grouped request fails, no change in state occurs, and the association remains in the
regime in which it was when you initiated the grouped request.
1. For the transfer service class, management service class, or
transfer-and-management service class, you must set the threshold parameter
to the total number of required and optional primitives you plan for the group. This
limitation on the threshold value does not apply to the file-access service class,
for which greater flexibility is provided.
For the file-access service class, you can set the threshold parameter to a value
less than the total number of required and optional primitives to include in the
group. For example, suppose that you want to initiate the following Group A
procedure-call primitive sequence:
required F-BEGIN-GROUP
required F-SELECT
optional F-READ-ATTRIB
required F-OPEN
required F-END-GROUP
If you negotiated the file-access service class on the initialize request, you can set
a threshold value of 2, one less than the number of primitives in the group. In
the case where the F-SELECT and F-READ-ATTRIB primitives succeed and the
F-OPEN primitive fails, the select and read-attribute actions will be performed.
After the number of successful primitives (2 in this example) equals, or exceeds,
the threshold value (2 in this example), the successful actions are performed.
Selecting Files
This section describes the steps to follow to select an FTAM file and gives details on
how to set the parameters of the FTM_SELECT_REQ_ procedure.
Procedure-Call Sequence
Table 4-9 on page 4-22 shows the sequence of procedures to call and describes the
steps to select an FTAM file and make the file available for access in a file storage
system with which the application has an established association. Sometimes you can
omit a procedure call associated with a substep, depending on the context. The
sequence of procedures is explained after the table.