SOCK gate, CREATE function
This function creates a new socket.
Input Parameters
- SWITCH_TCB
- Optional parameter
- Specifies if a switch to a socket TCB is required.
- Values of the parameter are:
- NO
- YES
- LIFETIME
- Optional Parameter
- The lifetime of the socket.
- Values for the parameter are:
- PERSISTENT
- SHARED
- TASK
- QUEUE_TIMEOUT
- Optional Parameter
- A parameter that indicates whether a request to create a socket will be queued if no sockets can be created immediately, and whether the request will be queued for ever or will time out.
- Values for the parameter are:
- FOREVER
- NO
- YES
- QUEUE_TIMEOUT
- Optional Parameter
- A parameter that indicates whether a request to create a socket will be queued if no sockets can be created immediately, and whether the request will be queued for ever or will time out.
- Values for the parameter are:
- FOREVER
- NO
- YES
- TIMEOUT_VALUE
- Optional Parameter
- The interval after which a request will time out.
- TRANSPORT
- Optional Parameter
- The type of IP transport supported by the socket.
- Values for the parameter are:
- TCP
- UDP
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOCK_FAILURE
- LOOP
- SOCKET_IN_USE
- The following values are returned when RESPONSE is EXCEPTION:
- ADDRESS_IN_USE
- ADDRESS_NOT_AVAILABLE
- ALREADY_ASSOCIATED
- CLIENT_ERROR
- CONNECTION_CLOSED
- CONNECTION_REFUSED
- INSUFFICIENT_STORAGE
- INSUFFICIENT_THREADS
- INVALID_OPTION
- IO_ERROR
- MISSING_OPTION
- NEVER_ASSOCIATED
- NO_CONNECTION
- NO_SOCKET_AVAILABLE
- NOT_AUTHORIZED
- NOT_PENDING
- NOTIFICATION_UNAVAILABLE
- NOTIFIED
- SCHEDULED
- SSL_HANDSHAKE_ERROR
- STATE_ERROR
- TCP_NOT_ACTIVE
- UNKNOWN_SESSION_TOKEN
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- The following values are returned when RESPONSE is PURGED:
- TASK_CANCELLED
- TIMED_OUT
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- SOCKET_TOKEN
- A token that is generated when a socket is created, and is used subsequently to identify the socket.