Version 4.2.6 for Mainframes
 —  Utilities  —

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.

Start of instruction set To activate individual profile settings

  1. Save the text object PROFILE under the name PROFILES in the library SYSOBJH.

  2. In the text object PROFILES, set the parameters required and save the modifications.

  3. Invoke the Object Handler to activate PROFILES.

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

Start of instruction set To deactivate individual profile settings

This section covers the following topics:


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 90 bytes.

This section covers the following topic:

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.

Top of page

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 work file used for the PC file (Work File 7).

Unload
Load
Scan

Work Files

Only applies if Entire Connection is installed.

Report-File-Name The name of the text member in the Workplan library to be used for the report.

Unload
Load
Scan

Write report in Work File and Report Options

Restart-File-Name The name of the text member in the Workplan library to be used for the restart information. Load

Write restart information in Work File and Report Options

Trace-File-Name The name of the text member in the Workplan library to be used for the trace. All functions

Traces in Tools

Top of page