SERVLET_URL Statement—Specify a Host URL

C-LANG Statements › SERVLET_URL Statement—Specify a Host URL

SERVLET_URL Statement—Specify a Host URL

The SERVLET_URL statement specifies the host where the program you want to invoke resides in a HTTP job. The statement also specifies whether the agent ignores default proxy setting properties such as initialization parameters.

Supported Job Type

This statement is required for the HTTP job type.

Syntax

This statement has the following format:

SERVLET_URL servlet_url [IGNORE]

servlet_url

Specifies the host where the program or servlet you want to invoke resides. The URL has the following format:

http://host[:port][/action]

host

Specifies the name of the computer running the application server.

port

(Optional) Specifies the port the host uses to listen for HTTP requests.

Default: 80

action

(Optional) Specifies the path to the program or servlet to be invoked.

Limits: Up to 1024 characters; case-sensitive

Example: http://localhost/cgi-bin/test.sh

Note: HTTP and HTTPS are supported..

IGNORE

(Optional) Ignores the global proxy configuration specified by the proxy parameters in the agentparm.txt file. Specify this option if you want to ignore the proxy defaults for this job only. For example, you might ignore the proxy defaults if the request is going to a server on the LAN that does not require the proxy.

Notes:

Enclose values that contain delimiters (such as spaces) in double quotation marks.
If you omit the program or servlet path (action) in this statement, you must specify the ACTION statement in the job definition. If the ACTION statement is omitted from the job definition, the agent assumes that the SERVLET_URL statement specifies the full path to the program or servlet.
If you specify the program or servlet path (action) in this statement, do not include the ACTION statement in the job definition. If the ACTION statement is included in the job definition, the agent assumes that the SERVLET_URL statement specifies only the server host name.

Example: Specify the Host URL in an HTTP Job

Suppose that you want to define a job to perform a Google search and have the results returned to the job's spool file. You also want to refine your search results by specifying a filter. In this example, the job uses the HTTP GET method to perform the Google search on "ca workload automation". When the job runs, the job's spool file includes all matches that contain the filter AE.

AGENT APPAGENT
INVOCATIONTYPE GET
SERVLET_URL http://google.com/search
PARAMETER KEYWORD(q) VALUE('ca workload automation')
AUTHORDER (BASIC, DIGEST, NTLM)
FILTER .*AE.*

Example: Override Global Proxy Defaults in Agent Parameter File

This example performs an HTTP query using the HTTP GET method. The output of the invocation is returned in the job's spool file. In this example, the job specifies the connection domain and origin for NTLM authentication, overrides the global proxy defaults specified in the agentparm.txt file, and specifies the user and BASIC, DIGEST, and NTLM protocols for web server authentication.

AGENT APPAGENT
INVOCATIONTYPE GET
SERVLET_URL http://host.example.com/protected IGNORE
CONNECTIONORIGIN host.example.com    
CONNECTIONDOMAIN windows_domain  
AUTHORDER (BASIC, DIGEST, NTLM)
CONNECTIONUSER user1
PROXYDOMAIN http://host.domain.proxy   
PROXYHOST proxy.example.com 
PROXYORIGIN http://host.origin.proxy
PROXYPORT 90
PROXYUSER user01 domain(mydomain)