snalu62_confirm(3) — Subroutines
Name
snalu62_confirm − Sends a confirmation request to the remote transaction program and waits for a reply. The interface flushes the currently buffered send data.
FORMAT
STATUS_RTN snalu62_confirm(
RES_ID resource,
STATUS_VEC status_vec,
ASYNC_INFO ∗wait_object,
UINT8 ∗rts_recv,
UINT8 ∗exp_data_recv
);
Valid Conversation States
Send
Arguments
resource
A RES_ID structure assigned to the conversation by the interface. This ID was returned by the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb.
status_vec
A pointer to a STATUS_VEC array to receive the completion status information.
wait_object
A pointer to an ASYNC_INFO structure specifying whether the interface should process this verb in a blocking or non-blocking manner.
rts_recv
A pointer to a UINT8 location to receive a boolean value indicating whether the remote transaction program has requested permission to send data. A value of TRUE (1)
indicates the remote program is requesting to send data. A value of FALSE (0)
indicates the remote program has not requested to send data.
exp_data_recv
This parameter is a place holder. The functionality represented by this parameter is not implemented.
Description
This verb and the snalu62_confirmed verb allow cooperating transaction programs to verify that a unit of communication has taken place before proceeding with the next unit. The LU flushes its send buffer as a function of this verb.
Return Values
SNALU62_S_OK
normal successful completion
SNALU62_S_ALLERR
conversation could not be allocated
SNALU62_S_BACKOUT
backed out
SNALU62_S_CONVCANC
conversation canceled
SNALU62_S_DEABPR
deallocate abend program
SNALU62_S_DEABSVC
deallocate abend services
SNALU62_S_DEABTIM
deallocate abend timer
SNALU62_S_FMHNOT
user control data (FMH) not supported
SNALU62_S_MAPEFAI
map execution failure
SNALU62_S_MAPNFOU
map name not found
SNALU62_S_MAPNSUP
mapping not supported
SNALU62_S_OPINCOMP
non-blocking operation not completed
SNALU62_S_OPNOTACC
non-blocking operation not accepted
SNALU62_S_PARERR
parameter error, function-name
SNALU62_S_PRERPU
program error purging
SNALU62_S_PRGPARCHK
program parameter check
SNALU62_S_RESFNO
resource failure no retry
SNALU62_S_RESFRET
resource failure retry
SNALU62_S_STAERR
LU6.2 verb function-name invalid with conversation in current state
SNALU62_S_SVCERPU
service error purging
SNALU62_S_UNSUC
verb did not execute successfully