GETIBMOPT

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:

Connect to the TCP/IP specified by TCPIPJOBNAME in the active TCPIP.DATA file.
Locate TCPIP.DATA using the search order described in the z/OS Communications Server: IP Configuration Reference.

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 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.