HTTP(S) URL (-URL)
The HTTP(S) URL adapter command (-URL) is required for connection. Specify the URL to connect to the HTTP(S) server. You must specify a file name for the file to be transferred.
-URL {HTTP|HTTPS}://[user[:pass]@][host[:port]][/dir[/file]]
- Option
- Description
- HTTP
- The HTTP application protocol
- HTTPS
- The HTTPS application protocol
Note: This option is only available if you have the Security Option installed.
- user
- Specify the user name to connect to the HTTP(S) server. Unless you are also specifying a password, this must be followed by @ if you specify host.
- : pass
- Specify the password that authenticates the user name. This parameter must be followed by @ if you are also specifying host.
- host
- The HTTP(S) server name or address
- : port
- The HTTP(S) server port name or number
- /dir
- The directory path for the file
- /file
- The file that the HTTP Adapter retrieves
Note: The user and pass arguments extend what is supported by the RFC for a URL path.
The URL does not need to be completely `URL-encoded'. You only need to use escape characters for tokens specifically used in a URL, as shown in the following table.
- Tokens
- Replaced with
- % (percent)
- %25
- @ (at)
- %40
- / (forward slash)
- %2F
- : (colon)
- %3A
- ; (semicolon)
- %3B
- & (ampersand)
- Escape not needed, use as is
- # (pound)
- Escape not needed, use as is
- 8-bit or control characters
- Escape not needed, use as is
Any URL that contains spaces must be enclosed in quotes. For example,
-URL HTTP://Home Machine/HTTP Fil