OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-14
FTM_BEGIN_GROUP_REQ_
threshold is a required parameter.
For additional information on setting the threshold value, see the OSI/FTAM
Programming Guide.
tag input
INT(32):value
is for use in nowait mode only. Specify a unique value to identify this instance of
the procedure call. When the operation is complete, the MFM_AWAITIOX_
procedure returns the tag parameter value, allowing your application to match the
completion with the correct instance of the procedure call. For details on the use of
the tag parameter, see the OSI/FTAM Programming Guide.
tag is an optional parameter.
Considerations
•
Before calling FTM_BEGIN_GROUP_REQ_, you must have negotiated the
grouping functional unit on the FTM_INITIALIZE_REQ_ call.
•
Because no values are returned in the F-BEGIN-GROUP response, no confirm
procedure is needed to retrieve data. You must, however, verify the success of the
F-BEGIN-GROUP primitive by calling APS_STATUS_ and determining that the
begin-group confirm has been received. If the value of the event-code parameter
is ZFTM-VAL-EVT-BEGINGROUP-CNF, the begin group confirm has been
received.
•
You must issue an MFM_AWAITIOX_ call to complete the nowait I/O operation
when you set the nowait operating mode in the FTM_INITIALIZE_REQ_ call.
Errors
Table 4-3. Possible FTAM Initiator Errors for the FTM_BEGIN_GROUP_REQ_
Procedure
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6001 ZFTM-ERR-OUT-OF-SEQUENCE
- 6002 ZFTM-ERR-FU-NOT-NEGOTIATED
- 6017 ZFTM-ERR-INVALID-IF-VERSION
- 6018 ZFTM-ERR-INVALID-FIELD-VERSION
- 6019 ZFTM-ERR-BAD-APS-STATUS
- 6022 ZFTM-ERR-CONNECTION-ABORTED
- 6036 ZFTM-ERR-SU-ABORTED