Notes

To omit an optional parameter in the parameter list, replace the parameter with the @ symbol.
A CA ADS dialog associated with a server task (a task started by a generic listener):
- Must be a mapless dialog.
- Should include SOCKET-LISTENER-PARMS as a work record.
The following pre-defined records are provided during installation and can be attached to a dialog as work records:
- SOCKET-CALL-INTERFACE—Describes the socket functions, return codes, and errno values used to issue all socket requests.
- SOCKET-MISC-DEFINITIONS—Describes options and flags specific to individual functions.
- SOCKET-MISC-DEFINITIONS-2—Describes the flags specific to the IOCTL function.
- SOCKET-SOCKADDR-IN, SOCKET-SOCKADDR-IN6, SOCKET-HOSTENT, SOCKET-SERVENT, SOCKET-TIMEVAL, and SOCKET-ADDRINFO—Describe structures that may be useful for certain socket applications.
The SOCKET-CALL-INTERFACE record contains fields that can be used for SOCKET built-in function common parameters:
- function
- return-code
- errno
- reason-code
Each supported function is represented by a field, whose value is the function number. The following example illustrates how to issue a READ socket request using the SOCKET built-in function and fields within the SOCKET-CALL-INTERFACE record:
```
IF (SOCKET (SOCKET-FUNCTION-READ,
            SOCKET-RETCD,
            SOCKET-ERRNO,
            SOCKET-RESNCD,. . .) = 0)
```
For more information about CA ADS and built-in functions, see the CA ADS Reference Guide.