Toolkit 7.3 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

$$PARSEURL^XTHCURL(): Parses a URL

Reference Type: Supported, Category: Toolkit—HTTP Client Helper, Integration Agreement: 5554

Description

The $$PARSEURL^XTHCURL extrinsic function parses a URL using into host, port, and path (path includes query string).
NOTE:XTHC* routines are part of the HTTP Client Helper application for developers.
NOTE: This API was released with Kernel Toolkit patch XT*7.3*123.
NOTE: This API is IPv6 compliant as of Kernel Toolkit patch XT*7.3*138.

Format

  $$PARSEURL^XTHCURL(url)

Input Parameters

Output Parameters

url:

(required) Reference to variable where host name is to be returned.

host:

(required) Input URL.

port:

(required) Reference to variable where port is to be returned.

path:

(required) Reference to variable where path string is to be returned.

Output

Returns:

Return

  • Success: 0
  • Fail: -1^Error Description

Example:

D PARSEURL^XTHCURL"http://cgi.vagroup.va.gov:9999/tpl/PKG",.ZH,.ZP,.ZA)
W ZH,!,ZP,!,ZA

cgi.forum.va.gov
9999
/tpl/PKG

VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: June 6, 2018

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.