# ppxSubmit

Submits a series of connection calls.

#### Prototype

DWORD ppxSubmit ( CTAHD ctahd )

Argument | Description
ctahd | Context handle returned by ctaCreateContext or ctaAttachContext.

#### Return values

Return value | Description
SUCCESS |
CTAERR_OUT_OF_MEMORY | Unable to allocate memory.
CTAERR_SVR_COMM | Natural Access server communication error.
PPXERR_COMM_FAILURE | Problems were encountered when communicating with the PPX server.
PPXERR_INVALID_COMMAND | A ppxBegin command was not active.

#### Events

PPXEVN_SUBMIT_COMPLETE

#### Details

ppxSubmit submits a series of switching commands that are preceded with ppxBegin.

When ppxSubmit is called, the PPX service determines if each operation is valid and if valid paths exist for all connections. After verifying the commands and paths, the PPX service calls the functions to perform the operations. If an error occurs when making the connections, the system is returned to its state before ppxBegin was called.

The value field of PPXEVN_SUBMIT_COMPLETE contains either SUCCESS or the first non-SUCCESS response issued by the commands included in the ppxBegin/ppxSubmit block.

Only one begin or submit transaction can be active on a given context.

Refer to Managing groups of connections for more information.

#### See also

ppxBeginCancel