The GETIBMOPT macro returns the number of TCP/IP images installed on a given MVS™ system and the status, version, and name of each image. With this information, the caller can dynamically choose the TCP/IP image with which to connect, using the INITAPI macro. The GETIBMOPT macro is optional. If you do not use this macro, follow the standard method to determine the connecting TCP/IP image:
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. |
>>-EZASMI--TYPE=GETIBMOPT--,COMMAND--=--+-number---+------------> +-address--+ +-*indaddr-+ '-(reg)----' >--,BUF--=--+-address--+--,ERRNO--=--+-address--+---------------> +-*indaddr-+ +-*indaddr-+ '-(reg)----' '-(reg)----' >--,RETCODE--=--+-address--+--+-------------------------+-------> +-*indaddr-+ '-,ERROR--=--+-address--+-' '-(reg)----' +-*indaddr-+ '-(reg)----' >--+------------------------+---------------------------------->< '-,TASK--=--+-address--+-' +-*indaddr-+ '-(reg)----'
On successful return, these buffer entries contain the status, name and version of up to eight active TCP/IP images. The following layout shows BUF upon completion of the call.
The NUM_IMAGES field indicates how many entries of TCP_IMAGE are included in the total BUF field. If the NUM_IMAGES returned is 0, there are no TCP/IP images present.
Version | Field |
---|---|
TCP/IP z/OS® Communications Server V1R13 | X'061D' |
TCP/IP z/OS Communications Server V2R1 | X'0621' |
The name field is the PROC name, left-aligned, and padded with blanks.
See Socket call error return codes for information about ERRNO return codes.