Settings - Parameters

On the tabbed page Parameters of the Settings window you can specify the following:

Item Explanation
Do not use parameters If selected (default setting), no parameters are set.
Use global parameters

Used in connection with Set (see below).

Global parameters are used. See also Set Global Parameters below.

Set

(global parameters)

Only activated if Use global parameters has been selected.

Invokes the Unload/Load Parameters window. See Set Global Parameters below for descriptions of keywords and valid input values.

Use Parameter Workplan If selected, a Workplan of the type PARAMETER is used.

Select a Workplan from the combo box or type the name of a Workplan of the type PARAMETER.

See also Workplans.

List

(Parameter Workplan)

Only activated if Use Parameter Workplan (see above) has been selected and the name of a valid Workplan of the type PARAMETER was entered.

Displays the contents of the Workplan specified.

This section describes windows and tabs that are associated with the tabbed page Parameters.


Set Global Parameters

Only applies to the load or unload function.

You can use global parameter to change the settings for the objects to be processed with the load or unload function, and to change the target environment for the load function. For example, you can specify new names (or name ranges) under which the selected objects are unloaded to the work file, or you can specify a different library into which the selected objects are loaded from the work file.

If global parameters are specified during the unload function, the parameter settings affect the objects before they are written to the work file. If they are specified during the load function, the parameter settings affect the objects before they are written to the target environment.

Global parameters are set in the Unload/Load Parameters window.

Start of instruction set To invoke the Unload/Load Parameters window

  • In the Settings window, on the tabbed page Parameters, select the Use global parameters option button and choose Set.

The tabbed page Parameters contains the group boxes General and Load Target. The items provided in these group boxes and the data you can specify are described in the following section.

General

The tabbed page General contains a table where the relevant parameters are listed in the Parameters column. The values that can be specified to change the settings of the parameters are entered in the columns Value and New Value.

New Value does not apply to the parameter Error number difference and target system file specifications for load functions.

If no value has been entered in Value, the value entered in New Value affects all objects to which the specific parameter setting applies. If a value has been entered in Value, the value entered in New Value only affects objects to which the specific parameter setting and the value entered in Value apply.

If a value or new value is not relevant to the type of object to be processed, any value entered in either column will be ignored. For example: Natural system error messages have no library name. Therefore, when processing Natural system error messages, a value entered in Value or New Value for the parameter Library will be ignored.

For valid parameter settings, see also parameter-setting in the section Direct Commands.

On the tabbed page General you can specify the following:

Parameter Explanation
Name Value/New Value:

A single object name or a range of names: see Name in Name, Date and Time Specification and Rules for New Values.

Library Value/New Value:

A single library name or a range of names: see Name and Rules for New Values.

Date Value/New Value:

A single date or a range of dates: see Date and Time in Name, Date and Time Specification, and Rules for New Values.

User ID Value/New Value:

A single user ID or a range of user IDs: see Name and Rules for New Values.

Language code Only applies when processing Natural system error messages or user-defined error messages.

Value/New Value:

Up to 8 valid language codes such as code 4 for Spanish. If more than one language code is specified, Value must contain the same number of language codes. In this case, the language code in Value is replaced by the language code in the corresponding New Value.

Note: New Value does not apply to the long texts of Natural system error messages for which English (code 1) is the only valid language.

Error number difference Only applies when processing Natural system error messages or user-defined error messages.

A 4-digit positive or negative value (+/-nnnn) to be used as a new number range for error messages. Start and end values must be provided in the Number from/to or Message from/to boxes to validate whether the new range can be applied to the selected error messages.

Example:

If Number from/to selects message numbers 1 to 10 and Error number difference is set to 2000, the messages will be renumbered from 2001 to 2010. A value of -1000 in Error number difference would cause a validation error.

FDT DBID Value/New Value:

A valid database ID (DBID) for the Adabas FDT.

FDT FNR Value/New Value:

A valid file number (FNR) for the Adabas FDT.

External path Value/New Value:

The name of the path for external files.

Rules for New Values

The following applies to New Value for Name, Library, Date and User ID:

If New Value contains a range with an asterisk (*) such as ABC*, the number of characters before the asterisk (*) determines the number of characters to be replaced in Value. This is also valid if Value is shorter than the range specified in New Value (see the second example in Examples 2 below).

Examples:

  1. If Name is ABCDEFG and New Value is set to ZYX*, the resulting object name is ZYXDEFG.

  2. If Name is AB and New Value is set to ZYX*, the resulting object name is ZYX.

  3. If Date is 2005-03-26 and New Value is set to 2006*, the resulting object date is 2006-03-26.

Load Target

The tabbed page Load Target only applies to the load function.

The page contains the group boxes Load FNAT, Load FUSER and Load NCP where you can specify the following:

Item Explanation
Load FNAT:

DBID
FNR
Password
Cipher key

The database ID (DBID) and file number (FNR) of the target FNAT system file. This system file is used for all library objects whose library name starts with SYS, but not SYSTEM.

In remote environments, you can also specify the Adabas password and cipher code.

Load FUSER:

DBID
FNR
Password
Cipher key

The DBID and FNR of the target FUSER system file. This system file is used for all library objects whose library name does not start with SYS, and for the library SYSTEM.

In remote environments, you can also specify the Adabas password and cipher code.

Load NCP:

DBID
FNR
Password
Cipher key

The DBID and FNR of the target Adabas file into which the Natural command processor sources are to be loaded. Additionally, you can specify the Adabas password and cipher code.