TCP/IP TELNET Management Programming Manual

LISTOPENS Command

Commands and Responses

6–42 53474 Tandem Computers Incorporated

ZPRIM-FNUM is an integer value that specifies the primary file number

assigned to the opener when the OPEN procedure was called.

ZPROCNAME is a null-terminated string that specifies the system name of the

opener.

ZCOM-TKN-OBJNAME

specifies the name of the TELNET process specified in the command. Unless an

error prevents the LISTOPENS command from being attempted at all, this token is

present in every response record. ZCOM-TKN-OBJNAME is described more fully

in “Data Communications Standard Definitions” in Section 5.

ZCOM-TKN-OBJTYPE

specifies the type of object queried. This token has the value ZCOM-OBJ-PROC.

See Section 5, “Common Definitions,” for a detailed description of this token.

ZSPI-TKN-RETCODE

specifies whether the command completed successfully. If the command

completed successfully, including when the command completes with a warning,

the value of this token is zero (ZCOM-ERR-OK). Note that if the empty response

(ZCOM-ERR-EMPT-RSP) is returned, the value of this token is nonzero even

though the command has completed successfully.

If the command did not complete successfully, the value of this token indicates the

reason the command failed. Always check the contents of the error list to

determine the token or value in error. For details on the ZCOM return codes and

associated error lists, see the Communications Management Programming Manual.

For details on the ZSPI return codes and associated error lists, see the Distributed

Systems Management (DSM) Programming Manual.

The following nonzero values of RETCODE can be returned in response to the

LISTOPENS command:

ZSPI-ERR-INVBUF (-1)

ZCOM-ERR-CMD-MISMATCH (-4)

ZCOM-ERR-CMD-TOO-LARGE (-8)

ZCOM-ERR-OBJ-NOT-FOUND (-17)

ZCOM-ERR-OBJ-NOT-SUPP (-18)

ZCOM-ERR-SPI-ERR (-23)

ZCOM-ERR-SSID-INV (-24)

ZCOM-ERR-TKN-CODE-INV (-26)

ZCOM-ERR-TKN-DUP (-27)

ZCOM-ERR-TKN-REQ (-29)

ZSPI-TKN-ERRLIST

indicates the beginning of an error list. See “SPI Standard Definitions” in Section 5

for a detailed description of this token.