Starting a Natural Application with a URL

The connection parameters available in the configuration file for the session and on the logon page can also be specified as URL parameters of the logon page URL. This allows bookmarking the startup URL of a Natural application or starting an application by clicking a hyperlink in a document.

The URL parameters overrule the definitions in the configuration file, with the exception described in the table below.

The following URL parameters are available for the logon page:

URL Parameter	Corresponding Option in the Session Configuration
`xciParameters.natsession`	Session ID
`xciParameters.natserver`	Host name
`xciParameters.natport`	Port number
`xciParameters.natuser`	User name
`xciParameters.natpassword`	Password
`xciParameters.natprog`	Application
`xciParameters.natparam`	Natural parameters
`xciParameters.natparamext`	Natural parameters The URL parameter `xciParameters.natparamext` extends an existing Natural parameter definition in the configuration file. The extension works in the following way: the Natural parameters defined in the configuration file come first. Then, the Natural parameters defined in the URL parameter `xciParameters.natparamext` are added, separated by a space character. If you want to overrule the definition in the configuration file, use the URL parameter `xciParameters.natparam` instead.
`xciParameters.nattimeout`	Timeout (n seconds)
`xciParameters.savesessionuser`	Save user credentials
`xciParameters.sharesessionuser`	Share session user

Important:
All parameter values must be URL-encoded.

Example: In order to start the Natural program MENU-NJX from the library SYSEXNJX, while your application server is running on myappserver:4711, your Natural Web I/O Interface server is running on mywebio:4712, and the name of the Natural startup script is nwo.sh, you can use the following URL:

http://myappserver:4711/cisnatural/servlet/StartCISPage?PAGEURL=%2Fcisnatural%2FNatLogon.html&xciParameters.natserver=mywebio&xciParameters.natprog=nwo.sh&xciParameters.natport=4712&xciParameters.natparam=stack%3D%28logon+SYSEXNJX%3BMENU-NJX%3Bfin%29

Instead of adding the parameters to the URL, you can also use the HTTP method POST to set the parameters in an HTML form. Example:

<html> 
<head> 
<title>Start Natural for Ajax Session</title> 
<script type="text/javascript"> 
function submitStart() { 
document.forms["myform"].submit(); 
} 
</script> 
</head> 
<body> 
 <form id="myform" name="myform" action="servlet/StartCISPage" method="post">
  <input type="hidden" name="PAGEURL" value="/cisnatural/NatLogon.html" /> 
   Host: <input type="input" size="20" name="xciParameters.natserver" value="mywebio" /><br/>
   Port: <input type="input" size="10" name="xciParameters.natport" value="4712" /><br/>
   Natural program: <input type="input" size="20" name="xciParameters.natprog" value="nwo.sh" /><br/>
   Natural parameter: <input type="input" size="50" name="xciParameters.natparam" value="stack=(logon sysexnjx;menu)" />
 </form> 
 <a href="#" onclick="submitStart()">Start Session</a> 
 <div id="status">Click on Start Session</div> 
</body> 
</html>

When you write the above example code to a file named startWithPost.html which is located in the cisnatural main directory, you can start the form with the following URL:

http://myappserver:4711/cisnatural/startWithPost.html