TESTSITE command

Use TESTSITE to verify that the hlq.HOSTS.ADDRINFO and hlq.HOSTS.SITEINFO data sets can correctly resolve the name of a host, gateway, or net.

Requirement: VMCF must be started for the TSO TESTSITE command to be successful because the TSO TESTSITE command uses the Pascal socket API. If VMCF is not started, an ABEND0D6 can occur.

Format:

Read syntax diagramSkip visual syntax diagram TESTSITE

Parameters:

There are no parameters for this command.

Examples:

To test your HOSTS data sets, enter:
TESTSITE
When prompted for a name, enter the host, gateway or net name you want to verify.

When you have checked all the names in question, enter QUIT and press ENTER.

Usage:

TESTSITE gets its input from the hlq.HOSTS.ADDRINFO and hlq.HOSTS.SITEINFO data sets, where the HLQ is derived in this order:
  • TSO user ID or the TSO PROFILE PREFIX, if it is different from the userid.
  • The value specified with the DATASETPREFIX statement in PROFILE.TCPIP and TCPIP.DATA.
  • System default.
Restriction: Start of change

TESTSITE command cannot be used with encrypted hlq.HOSTS.ADDRINFO and hlq.HOSTS.SITEINFO data sets. Using TESTSITE with encrypted data sets will result in IEC143I 213-99 message by DFSMS module IGG0193A. Instead, use TSO PING command, z/OS Unix host command or getnetent() socket call to verify that the encrypted hlq.HOSTS.ADDRINFO and hlq.HOSTS.SITEINFO data sets can correctly resolve the name of a host or net.

End of change

Start of changeFor more information on PING and host commands, see Resolver related commands and Monitoring the TCP/IP network. For more information on getnetent(), see C socket calls in z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference. End of change