Parameter values returned to the application

BUF: A 100-byte buffer into which each active TCP/IP image status, version, and name are placed.

On successful return, these buffer entries contain the status, names, and versions of up to eight active TCP/IP images. The following layout shows the BUF field 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.

The status field can have a combination of the following information:

Status field: Meaning
X'8xxx': Active
X'4xxx': Terminating
X'2xxx': Down
X'1xxx': Stopped or stopping

Note: In the above status fields, xxx is reserved for IBM® use and can contain any value.

When the status field is returned with a combination of Down and Stopped, TCP/IP abended. Stopped, when returned alone, indicates that TCP/IP was stopped.

The following table shows the examples that are returned on version field:

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-justified, and padded with blanks.

Figure 1. Example of name field

Table that shows the structure of NUM_IMAGES field, each image is indicated by a 2-byte status, a 2-byte version, and an 8-byte name.

ERRNO

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

RETCODE

A fullword binary field with the following values:

Value: Description
-1: Call returned error. See ERRNO field.
0: Successful call.