pdcomm_gem_formatted_program_verification_submit
Function
Sends the S7F29 verification inquiry for a prepared result.
PdcommStatus pdcomm_gem_formatted_program_verification_submit(PdcommTcpEndpoint *endpoint, PdcommGemResult *prepared, PdcommTcpToken *out_token)Success means the inquiry was queued. The S7F30 grant, a timeout, or a disconnection produces a later result through pdcomm_gem_handle_event(). On success the prepared result's submitted flag becomes 1.
Parameters
| Name | Description |
|---|---|
endpoint | Communicating GEM equipment endpoint that prepared the result. |
prepared | Result from pdcomm_gem_formatted_program_verification_prepare(). |
out_token | Receives the S7F29 transaction token. It is zeroed first whenever it is not NULL, so it is zero after every failure. |
Returns
#PDCOMM_OK when the inquiry was queued; #PDCOMM_INVALID_ARGUMENT when a pointer is NULL; #PDCOMM_INVALID_STATE when the endpoint is not a communicating GEM equipment, the service is not configured, or prepared is not a negotiation result; #PDCOMM_STALE_TOKEN when prepared is not an equipment-side record of this endpoint, the session was reselected or reconnected since preparation, or the negotiation already finished; #PDCOMM_BACKPRESSURE when the endpoint holds a staged TCP event, all 32 GEM request slots are in use, or the send queue is full; #PDCOMM_LIMIT_EXCEEDED when max_pending negotiations are submitted; #PDCOMM_INVALID_STATE also when the inquiry was already submitted; other TCP statuses such as #PDCOMM_IO_ERROR; #PDCOMM_POISONED.