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 preceding 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 version field is:

Version	Field
TCP/IP z/OS® Communications Server V1R4	X'0614'
TCP/IP z/OS Communications Server V1R5	X'0615'
TCP/IP z/OS Communications Server V1R6	X'0616'
TCP/IP z/OS Communications Server V1R7	X'0617'
TCP/IP z/OS Communications Server V1R8	X'0618'
TCP/IP z/OS Communications Server V1R9	X'0619'
TCP/IP z/OS Communications Server V1R10	X'061A'
TCP/IP z/OS Communications Server V1R11	X'061B'

The name field is the PROC name, left-aligned, and padded with blanks.

Figure 1. Example of name field

ERRNO

A fullword binary field. If RETCODE is negative, this field contains an error number. See 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.