z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


GETIBMOPT

z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
SC27-3660-00

The GETIBMOPT call returns the number of TCP/IP images installed on a given MVS™ system and their status, versions, and names. With this information, the caller can dynamically choose the TCP/IP image with which to connect by using the INITAPI call. The GETIBMOPT call is optional. If you do not use the GETIBMOPT call, follow the standard method to determine the connecting TCP/IP image:
The following requirements apply to this call:

Figure 1 shows an example of GETIBMOPT call instructions.

Figure 1. GETIBMOPT call instruction example
        WORKING-STORAGE SECTION.
            01  SOC-FUNCTION    PIC X(16)  VALUE IS 'GETIBMOPT'.
            01  COMMAND         PIC 9(8)   BINARY VALUE IS 1.
            01  BUF.
                03  NUM-IMAGES  PIC 9(8) COMP.
                03  TCP-IMAGE   OCCURS 8 TIMES.
                    05  TCP-IMAGE-STATUS  PIC 9(4) BINARY.
                    05  TCP-IMAGE-VERSION PIC 9(4) BINARY.
                    05  TCP-IMAGE-NAME    PIC X(8)
            01  ERRNO           PIC 9(8)   BINARY.
            01  RETCODE         PIC S9(8)  BINARY.
 
       PROCEDURE DIVISION.
 
           CALL 'EZASOKET' USING SOC-FUNCTION COMMAND BUF ERRNO RETCODE.
 

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014