Reporting Server > Using the Adapter for NATURAL > Configuring the Adapter for NATURAL

Configuring the Adapter for NATURAL

Topics:

x

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.

Declaring Connection Attributes

How to:

Reference:

In order to connect to NATURAL, the adapter requires connection and authentication information. You supply this information using the SET CONNECTION_ATTRIBUTES command. You can:

  • Enter connection and authentication information in the Web Console or the Data Management Console configuration panes. The consoles add the command to the profile you select: the global server profile (edasprof.prf), a user profile (user.prf), or a group profile (if supported on your platform).
  • Manually add the command in the global server profile (edasprof.prf), in a user profile (user.prf), or in a group profile (if supported on your platform).

You can declare connections to more than one data source by including multiple SET CONNECTION_ATTRIBUTES commands. The actual connection to NATURAL takes place when the first query that references that connection is issued. If you issue multiple SET CONNECTION_ATTRIBUTES commands:

  • The connection named in the first SET CONNECTION_ATTRIBUTES command serves as the default connection.
  • If more than one SET CONNECTION_ATTRIBUTES command contains the same connection name, the adapter uses the attributes specified in the last SET CONNECTION_ATTRIBUTES command.

Procedure: How to Configure an Adapter

  1. From the Web Console sidebar, click Connect to Data.

    or

    From the Data Management Console, expand the Adapters folder.

    In the DMC, the Adapters folder opens. In the Web Console, the Adapters page opens showing your configured adapters.

  2. In the Web Console, click the New Datasource button on the menu bar and find the adapter on the page or, in the DMC, expand the Available folder if it is not already expanded.
    On the Web Console, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.
  3. In the DMC, expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Adapters list in the DMC resources tree or the Configured list in the Web Console.
    In the Web Console, the adapter remains on the Available Adapters list with an asterisk to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

Reference: Connection Attributes for NATURAL

The NATURAL Batch adapter is under the Procedures group folder

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

Connection name

Logical name used to identify this particular set of connection attributes. The default is CON01.

Natural driver

Is the name of the NATURAL driver. This required value is installation dependent.

Security

There are three methods by which a user can be authenticated when connecting to a database server:

  • Explicit. The user ID and password are explicitly specified for each connection and passed to the database, at connection time, for authentication.
  • Password Passthru. The user ID and password received from the client application are passed to the database, at connection time, for authentication.
  • Trusted. The adapter connects to the database using the database rules for an impersonated process that are relevant to the current operating system.
User

Primary authorization ID by which you are known to the data source.

Password

Is the password associated with the user name. This field is only displayed when the security mode of the server is non-trusted.

Natural Session Parameters

NATURAL session dynamic parameters (system specific). These parameters are required:

  • FDIC is a system file containing cross-reference information and DDMs. If Predict is installed at your site, FDIC is the Predict dictionary file. If Predict is not installed at your site, FDIC is identical to either FNAT or FUSER and on the mainframe contains DDMs only. FDIC is specified with the FDIC profile parameter. FDIC includes two parameters with the values Database number and File number.
  • INTENS. For related information, see System-Specific Usage Notes.

See your Natural Reference documentation for details.

Adabas Session Parameters

On USS platforms, these parameters are usually provided in the DDCARD DD statement. They include four parameters: database number, device type, SVC number, and MODE. See the Software AG documentation for details.

Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).

Syntax: How to Declare Connection Attributes Manually

Explicit authentication. The user ID and password are explicitly specified for each connection and passed to NATURAL, at connection time, for authentication. 

ENGINE NATB SET CONNECTION_ATTRIBUTES [connection]/userid,password: "parameters_list"

Password passthru authentication. The user ID and password are explicitly specified for each connection and passed to NATURAL CICS, at connection time, for authentication. 

ENGINE NATB SET CONNECTION_ATTRIBUTES [connection]/: "parameters_list"

Trusted. The adapter connects to NATURAL as an operating system login using the credentials of the operating system user impersonated by the server data access agent. 

ENGINE NATB SET CONNECTION_ATTRIBUTES [connection]/,: "parameters_list"

where:

NATB

Indicates the adapter. You can omit this value if you previously issued the SET SQLENGINE command.

connection

Is a logical name used to identify this particular set of connection attributes. In the Access File, it becomes the CONNECTION=connection_name value. For details, see Access File Attributes.

userid

Is the primary authorization ID by which you are known to the Adapter for NATURAL.

password

Is the password associated with the primary authorization ID.

parameters_list

The following parameters are supported (some optional and some required):

natnuc_name is the name of the NATURAL driver. This required parameter is NATURAL installation dependent.

natuser_id is the userid for NATURAL security. This parameter is optional.

natpwsd_pswd is the password for NATURAL security. This parameter is optional.

'natparm_value' is the NATURAL session dynamic parameters (system specific). These parameters are required. For details, see System-Specific Usage Notes.

'adaparm_value' is applicable only on USS platforms, ADABAS session parameters, usually provided in the DDCARD DD statement, include four parameters: database#, device type, SVC#, and MODE. See the Software AG documentation for details.

Reference: System-Specific Usage Notes

  • On z/OS, the NATPARM value contains parameters usually provided in the PARM parameter of the EXEC statement for the NATURAL Batch driver. For details, consult the NATURAL DBA. Providing the parameter INTENS=1 is highly recommended.
  • On Windows, the NATPARM value contains dynamic parameters accepted by NATURAL in batch mode. For details, see the SAG documentation.

    In addition, a list of parameters may provide the name of the NATURAL parameter file in the form PARM=filename. The PARM parameter is mandatory if the file name is different from natparm. The parameter file is created and maintained by the SAG provided program natparm, as described in Preparing the NATURAL Environment.

  • In UNIX, the NATPARM value contains the same information as on Windows, but, in addition, it may contain a buffer pool name in form BP=name. For information on Buffer pool usage, see the SAG documentation.

Example: Sample Connection Declarations

Windows:

ENGINE NATB SET CONNECTION_ATTRIBUTES CON3 /,: "NATNUC natural NATPARM 
'PARM=IWAYPARM'"

UNIX:

ENGINE NATB SET CONNECTION_ATTRIBUTES CON3 /,: "NATNUC natural NATPARM 
'PARM=IWAYPARM BP=NATBP'"

z/OS:

ENGINE NATB SET CONNECTION_ATTRIBUTES CON3 /,: "NATNUC NAT314BA NATPARM 
'FDIC=(,21),INTENS=1' ADAPARM 'ADARUN DB=003,DE=3390,SVC=240,MODE=MULTI'"

 WebFOCUS

Feedback