Profile Settings

Natural provides the option to customize the default settings of your current Object Handler utility environment. For this purpose, Natural provides the text member PROFILE in the Natural system library SYSOBJH. PROFILE is used to specify environment-specific default values for flags and options that appear when entering the corresponding Object Handler screens.

To activate individual profile settings

Save the text object PROFILE under the name PROFILES in the library SYSOBJH.
In the text object PROFILES, set the parameters required and save the modifications.
Invoke the Object Handler to activate PROFILES.

If activated, the following Natural confirmation message appears: Defaults from SYSOBJH profile (PROFILES) read.

To deactivate individual profile settings

Delete the text object PROFILES from the library SYSOBJH.

This section covers the following topics:

Editing PROFILES
Parameter Specification

Editing PROFILES

The following section provides general instructions for editing the text object PROFILES.

Empty lines or lines that start with an asterisk (*) or /* are considered comments and therefore ignored.

Each line is limited to 250 bytes.

This section covers the following topic:

General and User-Specific Settings

General and User-Specific Settings

You can specify general profile settings that apply to all users, and individual profile settings that apply only to single users.

Parameters used for general settings are entered within the general block delimited by [General-Start] and [General-End].

Parameters used for individual settings are entered within any number of user-specific blocks, each of which is delimited by [User-Start UID-EXAM] and [User-End UID-EXAM] where UID-EXAM represents the user ID as assigned by the Natural system variable *USER (see the System Variables documentation). Each user-specific block only applies to the user whose ID is entered within the block delimiters.

Parameter settings made in a user-specific block override respective parameter settings made in the general block.

Example of a User-Specific Block

[User-Start SAG]
  Advanced-Mode             Y
  Option-Write-Report       N
[User-End SAG]

In the example above, regardless of the corresponding settings made in the general block, for User SAG, the field Advanced mode appears activated (selected) in the Main Menu and the field Write report appears deactivated (not selected) on the Object Handler Options screen.

Parameter Specification

The table below lists the parameters contained in PROFILE, the possible values that can be entered and the Object Handler functions to which the parameters apply. In addition, the table provides a brief description of the parameters or a reference to the corresponding Object Handler documentation section. Default parameter values are underlined.

Parameter	Possible Values	Function	Description/ Documentation Section
`Advanced-Mode`	`N` (No) or `Y` (Yes)	Unload Load Scan	Advanced User in Functions
`Display-Cmd-in-Advanced-Mode`	`N` or `Y`	Unload Load Scan	Displays the Object Handler command generated for a function executed in advanced-user mode.
`Display-ExecutionMsg`	`N` or `Y`	Unload Load Scan	Activates a window that displays the processing status.
`Workplan-Library`	`WORKPLAN` or any other Workplan library	Unload Load Scan Administration	Workplans and Change the Workplan Library in Administration
`Workplan-Library-DBID`	`0` (current FNAT/FUSER) or any other Adabas database ID (DBID)	Unload Load Scan Administration	Change the Workplan Library
`Workplan-Library-FNR`	`0` (current FNAT/FUSER) or any other Adabas file number (FNR)	Unload Load Scan Administration	Change the Workplan Library
`TRACE`	`N` or `Y`	Unload Load Scan	Traces in Tools
`TRACE-TARGET`	`S` (Screen) or `W` (Work file)	Unload Load Scan	Traces
`Option-Replace`	`N` or `Y` or `O` (Obsolete) `E` (Except)	Load	Replace Options in Settings
`Option-TRANSFER-FORMAT`	`N` or `Y`	Unload Load Scan	Work File Format in Work Files
`Option-TR-INCLUDE-LINE-NUMBERS`	`N` or `Y`	Unload	Include line numbers in Transfer Options
`Option-TR-SUBSTITUTE`	`N` or `Y`	Unload	Substitute line numbers in Transfer Options
`Option-TR-TRANSLATE-TO-UPPER`	`N` or `Y`	Load	Translate to upper case in Set Additional Options
`Option-TR-USE-CONVERSION-TABLE`	`N` or `S` (System table) or `U` (User table)	Unload Load	Use conversion table in Transfer Options
`Option-TR-CONV-TABLE-NAME-LOAD`	`OTNCONEA` or a user-written subprogram	Load	Use conversion table
`Option-TR-CONV-TABLE-NAME-UNLD`	`OTNCONAE` or a user-written subprogram	Unload	Use conversion table
`Option-Write-Report`	`N` or `Y`	Unload Load Scan	Reports in Tools Write report in Work File and Report Options
`Option-Write-Restart-Info`	`N` or `Y`	Load	Write restart information in Work File and Report Options
`USE-OPTION-WORKPLAN`	`N` or `Y`	Unload Load Scan	Workplans
`OPTION-WORKPLAN-Name`	`OPTIONWP` or any other Workplan of the type OPTION	Unload Load Scan	Workplans
`USE-PARAMETER-WORKPLAN`	`N` or `Y`	Unload Load	Workplans
`PARAMETER-WORKPLAN-Name`	`PARAWPLN` or any other Workplan of the type PARAMETER	Unload Load	Workplans
`WORK-FILE-1-Name`	The complete path name assigned to Work File 1.	Unload Load Scan	Work Files
`Report-File-Name`	The complete path name assigned to Work File 4.	Unload Load Scan	Write report in Work File and Report Options
`Restart-File-Name`	The complete path name assigned to Work File 6.	Load	Write restart information in Work File and Report Options
`Trace-File-Name`	The complete path name assigned to Work File 10.	All functions	Traces in Tools