This document covers the following topics:
Starting a Natural Application from the Logon Page
When you start Natural for Ajax in the browser, a logon page appears. The entries in this logon page depend on the settings in your configuration file (see Natural Client Session Configuration).
In order to start a Natural application from the logon page, you enter the following URL inside your browser:
http://<host>:<port>/cisnatural/servlet/StartCISPage?PAGEURL=/cisnatural/NatLogon.html
where <host> and <port> are the host name and port number of your application server.
Examples of Logon Pages
For each session definition that has been configured in the configuration file, an entry appears on the logon page. If the user selects the corresponding entry, only those parameters that were not preconfigured in the configuration file need to be specified in the logon page in order to start the application. Usually, you will preconfigure all connection parameters except user name and password.
The following example shows part of a logon page which results from a configuration file in which no special entries are defined for a session:
The following example shows part of a logon page which results from a configuration file in which many settings are already predefined (including user ID and password):
To log on to a session, you have to specify all required information in the logon page (for example, you select a session from the corresponding drop-down list box). When you choose the button, the screen for the selected session appears.
Dynamically Changing the CICS Transaction Name when Starting a Session
The following description applies if you want to switch to a different CICS transaction on a mainframe.
You specify the CICS transaction name in the same text box in which you also specify the dynamic parameters for the Natural environment. So that the CICS transaction name can be evaluated, it is important that you specify it before any Natural parameters, using the following syntax:
<TA_NAME=name>
where name can be 1 to 4 characters long. This must be the name of an existing CICS transaction which applies to a CICS Adapter. It will override the transaction name which is currently defined in the configuration file for the CICS Adapter on the Natural Web I/O Interface server (NWO). Ask your administrator for further information.
Make sure to put the entire definition in angle brackets. When this definition is followed by a Natural parameter, insert a blank before the Natural parameter. Example:
<TA_NAME=NA82> STACK=(LOGON SYSCP)
If the specified CICS transaction name cannot be found, an error message occurs and the session cannot be started.
Note:
The above definition for the CICS transaction name can also be
specified in the configuration
tool, in the same place where you also specify the Natural
parameters, and together with the URL
parameter xciParameters.natparam.
Specifying a Password in the Logon Page
The following information applies when the field for entering a password appears on the logon page. This field does not appear when a password has already been defined in the configuration file.
Under Windows, UNIX and OpenVMS, you always have to enter the operating system password, even if Natural Security is active.
On the mainframe, this is different: When Natural Security is not active, you have to enter the operating system password. When Natural Security is active, you have to enter the Natural Security password.
Changing the Password in the Logon Page
Currently, this functionality is only available for Natural for UNIX, Natural for OpenVMS and Natural for Windows.
The following information applies when the fields for entering a user ID and a password appear on the logon page. These fields do not appear when user ID and password have already been defined in the configuration file; in this case, it is not possible to change the password in the logon page.
When your password has expired, you are automatically asked for a new password. When you try to log on with your current password, an error message appears and input fields for changing the password are shown.
To change the password
-
Click the title to show the content of this input area.
The following two input fields are shown in the logon page:
-
New password
-
Repeat new password
-
-
Enter your user ID and your current password as usual.
-
Enter the new password in the two input fields.
-
Choose the button to change the password.
Browser Restrictions
The browser's "Back" and "Forward" buttons do not work with Natural for Ajax and should therefore not be used.
If you want to run two Natural sessions in parallel, you have to start a new instance of the browser (for example, by choosing the corresponding icon in the Quick Launch toolbar of Windows). You must not use the browser's "New Window" function. This would result in one session running in two browsers, which is not allowed.