Class HostFactory


  • public final class HostFactory
    extends Object
    A factory class that provides methods for creating hosts.

    Note: When using this HostFactory in a plug-in running in a Topaz Workbench installation, the protocol and timeout parameters will be overridden by any matching host configured in the Topaz Workbench client.

    Developers creating plug-ins to run inside a Topaz Workbench installation are encouraged to use the HostManager class from the com.compuware.api.topaz.eclipse plug-in instead.

    Since:
    2.0.0
    Version:
    1.0.0
    Restriction:
    This class is not intended to be extended by clients.
    • Method Detail

      • createZOSHost

        public static IZOSHost createZOSHost​(String host,
                                             int port,
                                             Protocol protocol,
                                             int timeoutSeconds)
        Creates an IZOSHost implementation for the specified host, port, protocol, and timeout.

        Regarding parameter validation for this method:

        A host is considered invalid if:

        • A DNS name is specified that cannot be resolved to an IP address.
        • An IPv4 IP address is specified but does not have exactly 4 period-delimited integer qualifiers between 0 and 255.

        A port is considered invalid if:

        • It is outside the integer range of 0-65535.

        Note: When using this method in a plug-in running in a Topaz Workbench installation, the protocol and timeout parameters will be overridden by any matching host configured in the Topaz Workbench client.

        Developers creating plug-ins to run inside a Topaz Workbench installation are encouraged to use the HostManager class from the com.compuware.api.topaz.eclipse plug-in instead.

        Parameters:
        host - the name or IPv4 IP address of the host
        port - the port
        protocol - the protocol
        timeoutSeconds - the timeout value in seconds
        Returns:
        the z/OS host
        Since:
        2.0.0
        See Also:
        IZOSHost