GETHOSTNAME call

The GETHOSTNAME call returns the domain name of the local host.

Note: The host name that is returned is the host name that the TCPIP stack learned at startup from the TCPIP.DATA file that was found. For more information about hostname, see HOSTNAME statement in z/OS Communications Server: IP Configuration Reference.

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

Figure 1. GETHOSTNAME call instruction example

    WORKING-STORAGE SECTION.
        01  SOC-FUNCTION    PIC X(16)  VALUE IS 'GETHOSTNAME'.
        01  NAMELEN         PIC 9(8) BINARY.
        01  NAME            PIC X(24).
        01  ERRNO           PIC 9(8) BINARY.
        01  RETCODE         PIC S9(8) BINARY.
 
    PROCEDURE DIVISION.
         CALL 'EZASOKET' USING SOC-FUNCTION NAMELEN NAME
                         ERRNO RETCODE.

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