GETCLIENTID

GETCLIENTID call returns the identifier by which the calling application is known to the TCP/IP address space in the calling program. The CLIENT parameter is used in the GIVESOCKET and TAKESOCKET calls. See GIVESOCKET for a discussion of the use of GIVESOCKET and TAKESOCKET calls.

Do not be confused by the terminology; when GETCLIENTID is called by a server, the identifier of the caller (not necessarily the client) is returned.

Table 1. GETCLIENTID call requirements
Condition	Requirement
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 the 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 GETCLIENTID call instructions.

Figure 1. GETCLIENTID call instruction example

    WORKING-STORAGE SECTION.
        01  SOC-FUNCTION    PIC X(16)  VALUE IS 'GETCLIENTID'.
        01  CLIENT.
            03  DOMAIN      PIC 9(8) BINARY.
            03  NAME        PIC X(8).
            03  TASK        PIC X(8).
            03  RESERVED    PIC X(20).
        01  ERRNO           PIC 9(8) BINARY.
        01  RETCODE         PIC S9(8) BINARY.
 
    PROCEDURE DIVISION.
         CALL 'EZASOKET' USING SOC-FUNCTION CLIENT ERRNO RETCODE.

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