CANCEL

Format

Parameters

CALAREA

Input parameter. The ECB specified in the call being cancelled.

ECB

Input parameter. It points to a 160-byte field containing:

• A four-byte ECB posted by TCP/IP when the macro completes.
• A 156-byte storage field used by the interface to save the state information.

Note: This storage must not be modified until the macro function has completed and the ECB has been posted.

ERRNO

Output parameter. A fullword binary field. If RETCODE is negative, ERRNO contains a valid error number. Otherwise, ignore ERRNO.

See ERRNO Values, for information about ERRNO return codes.

RETCODE

Output parameter. A fullword binary field. If RETCODE is 0, the CANCEL was successful. The error status (ERRNO) of the cancelled call is sent to ECANCELED. If RETCODE is –1, the CANCEL failed. Check ERRNO for an error code. For example, ERRNO is set to EINPROGRESS if the selected request cannot be cancelled because it is in progress, or set to EINVAL if the selected request cannot be cancelled because it has already been completed.

ERROR

Input parameter. The location in your program to receive control, if the application programming interface (API) processing module cannot be loaded.

TASK

Input parameter. The location of the task storage area in your program.