SOCKET call

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

The following requirements apply to this call:

Requirement	Description
Authorization:	Supervisor state or problem state, any PSW key
Dispatchable unit mode:	Task
Cross memory mode:	PASN = HASN
Amode:	31-bit or 24-bit
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'.
    * For AF_INET 
        01 AF            PIC 9(8)  COMP VALUE 2.
    * For AF_INET6                                                    
        01 AF            PIC 9(8)  BINARY VALUE 19.                
        01 SOCTYPE       PIC 9(8)  BINARY.
        01 STREAM        PIC 9(8)  BINARY VALUE 1.
        01 DATAGRAM      PIC 9(8)  BINARY VALUE 2.

        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.