Oracle9iAS Portal Developer Kit

get_host function

Contained in package wwctx_api.

Call this function to get the host server name and port.

function get_host

return varchar2;

Version: Oracle9iAS Portal 9.0.2 or later

Returns:

This function returns the server and port for the host as provided by the SERVER_NAME and SERVER_PORT CGI environment variables, i.e. server_name[:server_port]

If the port is the default port for the current protocol, then it is not included in the returned value. Otherwise it returns server_name[:server_port]

Exceptions:

This function raises no user-defined exceptions.

Example:

l_process_path := wwctx_api.get_host;

Notes

  • A qualified, or absolute URL contains all necessary elements to reach a Web location regardless of the current specified location of the user or calling routine. Qualified URLs begin with: http://host.domain.com/.

  • A relative, or partial URL, is a path from the current location of the user or calling routine, and never begins with a slash (/). Examples of relative URLs are: package.procedure?arg=value, images/hello.gif, and ../../pls/dad2/package.proc.

Related topics

The PL/SQL API Reference is part of the Portal Developer Kit on Portal Studio