INITAPI

The INITAPI call connects an application to the TCP/IP interface. Almost all sockets programs that are written in COBOL, PL/I, or assembler language must issue the INITAPI socket command before they issue other socket commands.

The exceptions to this rule are the following calls, which, when issued first, will generate a default INITAPI call.

GETCLIENTID
GETHOSTID
GETHOSTNAME
GETIBMOPT
SELECT
SELECTEX
SOCKET
TAKESOCKET

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 INITAPI call instructions.

Figure 1. INITAPI call instruction example

    WORKING-STORAGE SECTION.
        01  SOC-FUNCTION    PIC X(16)  VALUE IS 'INITAPI'.
        01  MAXSOC          PIC 9(4) BINARY.
        01  IDENT.
            02  TCPNAME     PIC X(8).
            02  ADSNAME     PIC X(8).
        01  SUBTASK         PIC X(8).
        01  MAXSNO          PIC 9(8) BINARY.
        01  ERRNO           PIC 9(8) BINARY.
        01  RETCODE         PIC S9(8) BINARY.
 
    PROCEDURE DIVISION.
         CALL 'EZASOKET' USING SOC-FUNCTION MAXSOC IDENT SUBTASK
         MAXSNO ERRNO RETCODE.

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