Parameter values returned to the application

RETARG

Returns an array whose size is based on the value in COMMAND. See Table 1 for information about REQARG and RETARG.

ERRNO

A fullword binary field. If RETCODE is negative, the field contains an error number. See Socket call error return codes for information about ERRNO return codes.

RETCODE

A fullword binary field that returns one of the following values:

Value: Description
0: Successful call.
-1: Check ERRNO for an error code.

The COMMAND SIOGIFCONF returns a variable number of network interface configurations. Figure 1 contains an example of a COBOL II routine that can be used to work with such a structure.

Note: This call can be programmed only in languages that support address pointers. Figure 1 shows a COBOL II example for SIOCGIFCONF.

Figure 1. COBOL II example for SIOCGIFCONF

  WORKING-STORAGE SECTION.
    77   REQARG        PIC 9(8) COMP.
    77   COUNT         PIC 9(8) COMP VALUE max number of interfaces.
  LINKAGE SECTION.
    01   RETARG.
         05   IOCTL-TABLE OCCURS 1 TO max TIMES DEPENDING ON COUNT.
              10    NAME     PIC X(16).
              10    FAMILY   PIC 9(4) BINARY.
              10    PORT     PIC 9(4) BINARY.
              10    ADDR     PIC 9(8) BINARY.
              10    NULLS    PIC X(8).
  PROCEDURE DIVISION.
    MULTIPLY COUNT BY 32 GIVING REQARQ.
    CALL 'EZASOKET' USING SOC-FUNCTION S COMMAND
        REQARG RETARG ERRNO RETCODE.