This document covers the following topics:
The following new Natural parameters are provided in this version:
| Parameter | Description |
|---|---|
RPCSDIR
|
Specifies the name of the Natural library in which the service directory is located. |
SRVCMIT |
Specifies the time at which a Natural RPC server automatically commits an RPC conversation or a non-conversational RPC request. |
SRVTERM
|
Specifies the event at which a Natural RPC server is automatically terminated. |
The utility SYSEXT provides the following new
application programming interfaces (APIs):
| API | Description |
|---|---|
USR4005N |
Read current PF-key settings. |
USR4212N |
Read a data area from the system file/file
system and return the single entries in a table. This allows you to analyze a
data area independent of the way the definitions were done in the data area
editor. It also allows you to process data areas in DEFINE DATA
format.
|
USR6304N |
Set/get the reliable state for the reliable Natural RPC. |
USR6305N |
Commit/rollback reliable RPC message(s). This API is required if the reliable RPC state has been set to "client commit". |
USR6306N |
Retrieve the status of all reliable RPC messages of the user who is currently logged on to the EntireX Broker. |
Natural for Ajax is now delivered in the Version 1.2.1 and is based on Application Designer Version 2.4.
Support is now provided for converting character-based Natural
applications to Natural for Ajax applications. This support consists of the
following: map extraction, INPUT statement extraction, map
conversion and code conversion. INPUT statement extraction and
code conversion are supported with Natural Engineer Version 6.1.2. See
Application Modernization in the Natural for Ajax
documentation.
In order to support the conversion of character-based Natural applications to Natural for Ajax applications, a number of new controls is provided:
NJX:BUTTONITEMLIST
NJX:BUTTONITEM
NJX:BUTTONITEMLISTFIX
NJX:BUTTONITEMFIX
NJX:FIELDLIST
NJX:FIELDITEM
NJX:FIELDVALUE
NJX:NJXVARIABLE
A new control is provided to support event parameters:
NJX:EVENTDATA
The above controls are available in the controls palette of the Layout Painter, in the new section with the name .
Support is now provided for server-side scrolling and sorting. See Server-Side Scrolling and Sorting in the Natural for Ajax documentation.
The following Natural parameters are now evaluated in Natural for Ajax applications and passed to Application Designer at runtime:
See also Natural Parameters and System Variables in the Natural for Ajax documentation.
A configuration tool is now available on Java EE-based servers. It is used to manage the contents of the configuration files for the session (sessions.xml) and for logging (natlogger.xml). See Using the Configuration Tool in the Natural Web I/O Interface documentation.
The new profile parameters
RPCSDIR,
SRVCMIT and
SRVTERM can be specified. See
Remote Procedure Call in the
Configuration Utility documentation.
A new command, , is now available. It is used to create map extract files which are intended as input for the Map Converter. See Using the Map Extractor in the Natural Studio Extensions documentation.
Natural for Ajax now supports right-to-left languages and bidirectional text. See Support of Right-to-Left Languages in the Natural for Ajax documentation.
It is now possible to change the language while an
application is running. This is done by setting the Natural system variable
*LANGUAGE in the Natural program. Each time this
system variable is changed, Natural for Ajax changes the language code for the
web pages when the next update of the page occurs. See also Multi
Language Management in the Natural for Ajax documentation.
A number of features that was previously controlled by an XSLT file (colors, fonts, PF key buttons) is now controlled by a style sheet (CSS). As of this version, the XSLT file only provides restricted possibilities (see Modifying the Field Attributes in the Natural Web I/O Interface documentation). The XSLT files of the previous versions are no longer supported.
Note:
As of version 6.3.7, the above chapter is no longer
available.
Natural for Ajax is delivered with a number of predefined style sheets. You can edit the predefined style sheets or create your own style sheets. See Using Style Sheets in the Natural Web I/O Interface documentation.
The new URL parameter 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
natparamext are added, separated by a space character.
If you want to overrule the definition in the configuration file, use the URL
parameter natparam instead. See
Starting a
Natural Application with a URL in the Natural
Web I/O Interface documentation.
It is now possible to define the following new settings in the configuration file for the sessions. The headings below correspond to the options that are used in the new configuration tool (see Overview of Session Options in the Natural Web I/O Interface documentation). These new options are only available for Java EE-based servers, not for IIS.
Natural for Ajax only.
By default, the users can switch to another style sheet during a running session. You can disable this feature.
Corresponds to the styleselect
attribute of the screen element in
sessions.xml.
Natural for Ajax only.
When the name for a style sheet is specified, a fixed style sheet is used. In this case, the corresponding field does not appear on the logon page and the user is thus not able to select a different style sheet.
Corresponds to the style_sheet element in
sessions.xml.
You can enable SSL. A secure connection is then established between the Natural Web I/O Interface client or Natural for Ajax on the application server and the Natural Web I/O Interface server.
Corresponds to the ssl attribute of
the session element in
sessions.xml.
Natural for Ajax only. Applies only to applications that are designed as Application Designer workplaces.
By default, the default behavior of the option Share session user applies. You can change this default so that the user credentials (user ID and password) are not saved in the Application Designer session and are therefore not available for an Application Designer subsession.
Corresponds to the savesessionuser
attribute of the session element in
sessions.xml.
Natural for Ajax only. Applies only to applications that are designed as Application Designer workplaces.
By default, the user credentials of the main Application Designer session are automatically used in an Application Designer subsession if the server and port of the subsession is the same as in the main session. If the server and port are not the same, the user has to specify the user ID and password in a logon dialog. You can change this default so that the user credentials of the Application Designer main session are always used for all Application Designer subsessions on all involved servers - even if the server and port are different.
Corresponds to the sharesessionuser
attribute of the session element in
sessions.xml.
You can determine whether the PF key numbers are shown next to the PF keys.
Corresponds to the showfkeynumbers
attribute of the screen element in
sessions.xml.
It is now possible to specify a trust file in the configuration file for the sessions. Trust files are used for a secure connection between the Natural Web I/O Interface server and the Natural Web I/O Interface client or Natural for Ajax. The headings below correspond to the options that are used in the new configuration tool (see Global Settings in the Natural Web I/O Interface documentation). These new options are only available for Java EE-based servers, not for IIS.
The path to your trust file. For further information, see Trust Files in the Natural Web I/O Interface documentation.
Corresponds to the trustfile_name
element of the global section in
sessions.xml.
If your trust file is password-protected, the appropriate password is required.
Corresponds to the trustfile_password
element of the global section in
sessions.xml.
Natural Remote Procedure Call (RPC) is available as a separate subcomponent of Natural. It has its own version number. This measure takes into account that Natural RPC is a cross-platform component and makes it possible to provide new Natural RPC versions independent of new Natural versions for the various platforms supported.
With Natural Version 6.3.5, an enhanced Natural Remote Procedure Call Version 6.3.2 is delivered that replaces the existing Natural RPC Version 6.3.1.
As of Version 6.3 of Natural Remote Procedure Call (RPC), the following changes, enhancements and new features are provided:
The following new profile parameters are available:
SRVCMIT - Server Commit
Time
SRVTERM - Server Termination
Event
RPCSDIR - Library for Service
Directory
The following profile parameter has been changed:
MAXBUFF - Maximum Buffer
Size
Reliable RPC is the Natural RPC implementation of a reliable messaging system. It combines the Natural RPC technology and persistence, which is implemented by means of units of work that are offered by the EntireX Broker. Reliable RPC is characterized by following features:
The Natural RPC client executes a CALLNAT statement
without waiting for a reply from the server (the RPC message is sent in
asynchronous mode).
An RPC server needs not be active at the time the
CALLNAT is executed.
The reliable RPC message is stored in the Broker’s persistent store until an RPC server is available.
The Natural RPC server executes the reliable RPC by calling the requested subprogram but does not send a reply to the RPC client.
A Natural RPC client may ask the status of the sent reliable RPC messages.
A Natural RPC client may send a reliable RPC message to an EntireX RPC server.
A Natural RPC server may receive a reliable RPC message from an EntireX RPC client.
For further information, see Reliable RPC in the Natural Remote Procedure Call (RPC) documentation.
The Natural RPC client provides the name of the subprogram that is to be executed and the name of the library from which the subprogram is to be executed to the EntireX Broker.
The Natural RPC server returns the name of the subprogram that has been executed and the name of the library from which the subprogram has actually been executed.
For further information, see EntireX Broker Support in the Natural Remote Procedure Call (RPC) documentation.
The Natural RPC server shows the system variable content
*SERVER-TYPE=RPC already during the processing of the commands
that have been placed on the Natural stack with the Natural profile parameter
STACK. With this enhancement, all Natural objects that
are executed by the Natural RPC server can check the system variable
*SERVER-TYPE for
RPC.
In previous versions, *SERVER-TYPE=RPC was only available
during the execution of an RPC request.
The size of the buffer which is used to exchange data between client
and server will be dynamically increased on demand. The size specified with the
profile parameter MAXBUFF is used as default
value.
This measure will avoid most Natural errors that are reported with Natural error message NAT6964 and reason codes 4, 5 and 7.
The following RPC-specific application programming interfaces have been added:
| API | Purpose |
|---|---|
USR6304N |
Set/get reliable state for RPC
execution
This API is used to set the reliable RPC mode. |
USR6305N |
Commit/rollback reliable RPC
message(s)
This API is required if the reliable RPC state has been set to "client commit". |
USR6306N |
Status of UOWs of current EntireX Broker
user
This API retrieves the status of all reliable RPC messages of the user who is currently logged on to the EntireX Broker. |
Purpose and use of these application programming interfaces are described in detail in the section Reliable RPC in the Natural Remote Procedure Call (RPC) documentation.
The following enhancements are provided with Natural Security Version 6.3.5:
The following enhancements are provided in Administrator Services:
The general option Logging of Maintenance Functions has been enhanced: When you activate the logging for user and library security profiles, you have the option to log the following additional data (extended logging):
When the functions Copy User and Copy Library are used with the with links option, any relationship which the copying has established between the user/library and other objects is logged.
When the Delete User function is used, any relationship which existed between the user and other objects and which was removed by the deletion is logged.
When a link between a group and a library is maintained, a list of the group's members is logged.
When the Disallow/Allow Modules section of a library (or special link) profile is maintained, information on the changed status of any module is logged.
A new Log File Maintenance function, List Log Records Extended, is available to view the additional data.
The modifications which are logged for a type of security profiles now
also include the transfer of security profiles of this type via the Natural
Security data transfer programs SECULD2 and
SECLOAD.
With the
Maintenance Log Records
functions you can display for each log record the screen which was modified.
These screens now also show the Natural Security version and the
FSEC system file with/on which the modification was performed.
Note:
This information is not shown for log records which were written
with Natural Security versions prior to 4.2.5 on mainframes and 6.3.5 on
non-mainframes.
The new option Module Protection Mode affects how the Disallow/Allow Modules settings in library security profiles are evaluated: You can set it so that they are evaluated in the same way on mainframes and non-mainframe platforms. This may be useful if you transfer a Natural application from a mainframe to a non-mainframe platform and wish to keep your module protection unchanged.
For details, see Module Protection Mode under Library and User Preset Values in the Administrator Services section of the Natural Security documentation.
The new Administrator Services function Definition of Undefined Libraries serves the same purpose as the library maintenance enhancement described under Undefined Libraries below.
The new option Disable Rename and Delete of Library Node allows you to prevent the inadvertent deletion/renaming of a library in the mapped environment of the Natural Development Server. If it is set, the actions Rename and Delete cannot be selected from the context menu of the library node.
For details, see Disable Rename and Delete of Library Node under Library and User Preset Values in the Administrator Services section of the Natural Security documentation.
The following enhancements are provided for libraries:
Source locking in the case of concurrent updates of Natural source
members - as controlled for the Natural session by the Natural profile
parameter SLOCK - can now also be controlled for
individual libraries by a corresponding setting in the
Session Parameters section of
library profiles.
Library maintenance has been enhanced allowing you to search for
undefined libraries - that is, libraries which exist on the system file, but
for which no security profiles have been created in Natural Security: You can
expand the Library Maintenance selection list to list either all (defined and
undefined) libraries or only the undefined ones. You can apply the search for
undefined libraries to the current FUSER system file or to another
system file of your choice.
For details, see Listing Undefined Libraries in the Library Maintenance section of the Natural Security documentation.
The following enhancement is provided for DDMs:
If a central system file for non-mainframe DDM storage (outside of
libraries) is specified with the Natural profile parameter
FDDM, the protection of non-mainframe DDMs and the
maintenance of their security profiles is performed in the same way as with
mainframe DDMs (as described in the section
Protecting DDMs On Mainframes of
the Natural Security documentation.
The following enhancements are provided for utilities:
In a utility profile, you allow or disallow each option by marking it with "A" or "D" respectively. For ease of maintenance, you can now set all options in a utility profile simultaneously to "A" or "D" by pressing PF16 or PF17 respectively.
A new SYSDDM function SQL Services
(NSB) for Natural SQL Gateway support is provided with this Natural
version. Its use can also be controlled in
SYSDDM utility profiles.
In the default utility profile of the SYSMAIN utility, a
new Additional Option named
Utilities Option is available. With it, you can make the
Utilities option in library profiles apply to
SYSMAIN.
Several new Object Handler functions are provided with this Natural version. Their use can also be controlled in SYSOBJH utility profiles.
The following other enhancements are provided:
Whenever you invoke a link function, a window appears before the list of objects to be linked is displayed. This window, which also allows you to specify a start value for the list to be displayed, used to provide an option Select only defined ones. This option has been enhanced and is now called Selection Criterion: It allows you to select whether the list is to contain:
all objects (linked and not linked),
only objects which are already linked,
only objects which are not yet linked.
This enhancement is provided for all Natural Security maintenance functions available to link users to libraries, users to applications, users to external objects, and libraries to files.
A new option in the security profiles of environments allows you to
control the use of the Natural system command TEST
in an environment. You can allow or disallow it altogether, or restrict the use
of the debugger. For details, see
Components of an Environment
Profile in the section Protecting
Environments of the Natural Security
documentation.
This option only applies to environments on mainframe computers.
The application programming interface (API) NSCLI has
been enhanced: It allows you to list library profiles (and special link
profiles) which contain a specific Adabas password, and you can then change the
password. For details, see example program PGMLI006 and text
member TXTLI006 in the library SYSSEC.
A new user exit,
LOGONEX5, is available; it is invoked by
the Natural Security logon program whenever the
LOGOFF system command is executed.
The documentation for the Natural Web I/O Interface has been revised.
An introduction to the Natural Web I/O Interface is now available.
In addition to the information about the new configuration tool, the configuration information for the Natural Web I/O Interface service has been moved to the Natural Web I/O Interface documentation. This information was previously available in the Operations documentation.
The general term "Natural Web I/O Interface server" is now used instead of "Natural Web I/O Interface service".
Natural for Ajax is also a client of the Natural Web I/O Interface server. Therefore, more information about Natural for Ajax documentation is now available the new Configuring the Client section of the Natural Web I/O Interface documentation.
As of Natural Version 6.3.5, Natural for Ajax Version 1.2.1 or above is required. Natural Version 6.3.5 is not compatible with Natural for Ajax Version 1.1.
