OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-23
Setting Procedure Parameters
a. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for
completion of the APS_EVENT_RECEIVE_ call and to obtain the status code.
A status code of ZAPS-VAL-STATUS-EVENT means you received an event.
3. If you received an event, call APS_STATUS_ to determine which event. If the event
code is ZFTM-VAL-EVT-SELECT-CNF, you received a select confirm.
4. Next, call FTM_SELECT_CNF_ to retrieve the data sent by the confirm. Check the
state-result and action-result output parameters.
If the state-result value is ZFTM-VAL-STATE-SUCCESS and the
action-result value is ZFTM-VAL-ACTION-SUCCESS, the file has been
selected.
Setting Procedure Parameters
To provide details about the file you wish to select, use these parameters of the
FTM_SELECT_REQ_ procedure:
1. The filename (ZAPS-DDL-CHAR128) parameter names the file to select. The
name should be fully qualified, as required by the remote system, to uniquely
identify the file. The name can have up to 128 characters.
2. The requested-access (ZFTM-DDL-REQUESTED-ACCESS) parameter
specifies the level of access to the file you are requesting. The requested-
access parameter can include any or all the file-action capabilities specified in the
permitted-actions field of the initial-attrib (ZFTM-DDL-CREATE-ATTR)
parameter of the create request, but no others.
The requested-access parameter is a string of Boolean fields, and each
Boolean field can take on the values ZAPS-VAL-TRUE or ZAPS-VAL-FALSE. The
fields and default values for requested-access include:
3. The access-passwords (ZFTM-DDL-ACCESS-PASSWDS) parameter
authenticates the actions requested in the requested-access parameter. To use
this parameter, you must have specified the security group in the attrib-groups
parameter of the FTM_INITIALIZE_REQ_ call. The remote responder rejects the
Field Name Task Associated With Access Default Value
ZREAD Read the file. TRUE
ZINSERT Insert information into the file. FALSE
ZREPLACE Replace some or all the contents of the
file.
FALSE
ZEXTEND Extend the file. FALSE
ZERASE Erase some or all the contents of the file. FALSE
ZREADATTR Read the attributes of the file. TRUE
ZCHNGATTR Change the attributes of the file. FALSE
ZDELETE Delete the file. FALSE