SOCKET

The SOCKET call creates an endpoint for communication and returns a socket descriptor representing the endpoint.

The following requirements apply to this call:

Authorization:

Supervisor state or problem state, any PSW key.

Dispatchable unit mode:

Task.

Cross memory mode:

PASN = HASN.

Amode:

31-bit or 24-bit.

Note: See "Addressability mode (Amode) considerations" under CALL instruction API environmental restrictions and programming requirements.

ASC mode:

Primary address space control (ASC) mode.

Interrupt status:

Enabled for interrupts.

Locks:

Unlocked.

Control parameters:

All parameters must be addressable by the caller and in the primary address space.

Figure 1 shows an example of SOCKET call instructions.

Figure 1. SOCKET call instruction example

    WORKING-STORAGE SECTION.
        01  SOC-FUNCTION    PIC X(16)  VALUE IS 'SOCKET'.
    * AF_INET
        01  AF              PIC 9(8) COMP VALUE 2.

    * AF_INET6
        01  AF              PIC 9(8) COMP VALUE 19.
        01  SOCTYPE         PIC 9(8) BINARY.
            88  STREAM        VALUE  1.
            88  DATAGRAM      VALUE  2.
            88  RAW           VALUE  3.
        01  PROTO           PIC 9(8) BINARY.
        01  ERRNO           PIC 9(8) BINARY.
        01  RETCODE         PIC S9(8) BINARY.
 
    PROCEDURE DIVISION.
         CALL 'EZASOKET' USING SOC-FUNCTION AF SOCTYPE
                        PROTO ERRNO RETCODE.

For equivalent PL/I and assembler language declarations, see Converting parameter descriptions.