This Natural profile parameter can be used to translate a database ID/file number into
another database ID/file number during the execution of an application. It corresponds to
the macro NTTF
in the Natural parameter
module.
Possible settings | See TF Parameter Syntax. | |
---|---|---|
Default setting | none | |
Dynamic specification | yes | This parameter can only be specified dynamically. In the Natural parameter
module, the macro NTTF is used
instead.
|
Specification within session | no | |
Application programming interface | USR1034N |
See SYSEXT - Natural Application Programming Interfaces in the Utilities documentation. * Recommended. |
USR2005N *
|
Notes:
This parameter applies to user files only. It does not apply to system files.
This feature is relevant when developing an application in a production environment.
It enables you to develop an application in a test database and then transfer the
finished application to the production database without having to change or re-compile
the application. The Natural objects are cataloged with the production DBID/FNR, but
whenever a database access is executed, the production DBID/FNR is translated into the
test DBID/FNR according to the TF
parameter specifications;
that is, the test database is used. This means that testing can take place in the
actual production environment, but not with production data.
The TF
parameter or the NTTF
macro can
be specified several times so as to specify different combinations of file
numbers.
If multiple TF
parameters are specified, the following
applies:
The list of TF
definitions is searched in the sequence
they are defined. The first entry that exactly matches in DBID and FNR (no
asterisk) is used.
If no exact match is found, the TF
definitions are
searched for a second time. This time, the first wildcard entry (either DBID or
FNR is an asterisk) that matches is used.
The following topics are covered below:
The TF
profile parameter is specified as follows:
TF=(production-dbid,production-fnr,test-dbid,test-fnr) |
Where:
Syntax Element | Value | Explanation |
---|---|---|
production-dbid |
0 - 254 or 256 - 65535 or
* |
Identification of the production database. An asterisk (*) can
be used as a wildcard for all database IDs.
Note: |
production-fnr |
1 - 65535 or * |
File number of the production database. An asterisk (*) can be used as a wildcard for all file numbers. |
test-dbid |
0 - 254 or 256 - 65535 or
* |
Identification of the test database. An asterisk (*) can be used, which leaves the database ID unchanged. |
test-fnr |
1 - 65535 or * |
File number of the test database. An asterisk (*) can be used, which leaves the file number unchanged. |
The NTTF
macro is specified as follows:
NTTF production-dbid,production-fnr,test-dbid,test-fnr
For explanations of the syntax elements and possible values, see TF Parameter Syntax.
TF=(777,39,17,88),TF=(251,*,9,*)
Equivalent specification in the Natural parameter module:
NTTF 777,39,17,88 NTTF 251,*,9,*