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 OBJHPROF in the Natural system library SYSOBJH. OBJHPROF 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. In online mode, enter the Object Handler internal command PROFILE (or SHOW PROFILE).

    This command invokes the Profile Maintenance tool that

    • displays a map with the general or user-specific profile parameters and their current values;

    • creates a new Object Handler profile with default values used internally in case an Object Handler profile does not exist;

    • allows you to modify general settings for the profile parameters in the Object Handler profile (controlled by Natural Security);

    • allows you to modify user-specific settings for the profile parameters in the Object Handler profile (controlled by Natural Security);

    • provides a description and help information for each profile parameter.

Enter PF4 to toggle user profile settings. You can use a Line Command to add, modify, or delete parameters from the user-specific profile.

Notes:

  1. If new parameters are added, the Profile Maintenance tool internal command UPDATE updates the changes into the Object Handler profile. For more information, invoke Help.
  2. The Object Handler profile itself is named OBJHPROF. It is located in library SYSOBJH. The default profile that is used for updates of the Object Handler profile is named OBJHDEFP. It is also located in library SYSOBJH.

Start of instruction set To deactivate individual profile settings

  • Delete the text object OBJHPROF from the library SYSOBJH.

The remainder of this document covers:

PF Keys

The following PF keys are available:

PF key Description
PF1 (Help) Invoke general or context-sensitive help.
PF2 (Print) Print the current profile settings.
PF3 (Exit) Save the profile data and terminate the Profile Maintenance tool.
PF4 (Gener/User) Toggle between general (Gener) and user-specific (User) profile settings.
PF5 (Modif) Modify the parameter (marked by cursor selection) in a separate menu.
PF6 (--) Scroll to the beginning of the parameter list.
PF7 (-) Scroll one page backwards.
PF8 (+) Scroll one page forward.
PF9 (++) Scroll to the end of the parameter list.
PF10 (ALLDU/ALLAU) For every parameter: insert line command DU or AU.
PF12 (Canc) Terminate the Profile Maintenance tool.

Line Commands

The following line commands are available :

Line Command Description
MO Modify parameter value in extended mode.
AU Add entry to user profile
DU Delete entry from user profile
DI Display description of the parameter
HE Display help information on the parameter

Profile Parameters

The table below lists the parameters contained in the Object Handler profile OBJHPROF, 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

Input-Mode W

Unload
Load
Scan

Wizards
A Advanced User
C Compact Mode
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.
Display-Statistics

N
or
Y

Unload
Load
Scan

Displays statistics on objects processed after the function has been executed. (equivalent to direct command SHOW STATISTICS).
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

Report-Library

WORKPLAN
or
any other Workplan library

Unload
Load
Scan

REPORT-LIBRARY in Direct Commands, option-setting
Report-Library-DBID

0 (current FNAT/FUSER)
or
any other Adabas database ID (DBID)

Unload
Load
Scan

REP-LIB-DBID in Direct Commands, option-setting
Report-Library-FNR

0 (current FNAT/FUSER)
or
any other Adabas file number (FNR)

Unload
Load
Scan

REP-LIB-FNR in Direct Commands, option-setting
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-Use-PC-Work-File

N
or
Y

Unload
Load
Scan

See

Use PC File in Set Additional Options

Option-TR-INCLUDE-LINE-NUMBERS

N
or
Y

Unload Include line numbers in

Transfer Options (Settings)
or
Transfer Options (Direct Commands)

Option-TR-LINE-NUMBER-INCREMENT

N
or
Y

Unload
Load

USE-LINE-NUMBER-INCREMENT in Transfer Options (Direct Commands)

Option-TR-SUBSTITUTE

N
or
Y

Unload

Substitute line references in Transfer Options (Settings)
or
SUBSTITUTE in Transfer Options (Direct Commands)

Option-TR-TRANSLATE-TO-UPPER

N
or
Y

Load

Translate to upper case in Transfer Options(Settings)
or
UPPERCASE-TRANSLATION in Transfer Options (Direct Commands)

Option-TR-USE-CONVERSION-TABLE

N
or
S (System table)
or
U (User table)

Unload
Load

Use conversion table in Transfer Options (Settings)
or
CONVERSION-TABLE in Transfer Options (Direct Commands)

Option-TR-CONV-TABLE-NAME-LOAD

OTNCONEA
or
a user-written subprogram

Load

Use conversion table in Transfer Options (Settings)
or
CONVERSION-TABLE in Transfer Options (Direct Commands)

Option-TR-CONV-TABLE-NAME-UNLD

OTNCONAE
or
a user-written subprogram

Unload

Use conversion table in Transfer Options (Settings)
or
CONVERSION-TABLE in Transfer Options (Direct Commands)

Option-TR-DA-FORMAT

N
or
*

Unload
Load

Data area format in Transfer OptionsOptions
or
DA-FORMAT in Transfer Options (Direct Commands)

Option-TR-UNICODE-WORK-FILE

N
or
Y

UNLOAD

Unicode work file in Settings Screen Fields

Option-TR-LOAD-CODE-PAGE

Code page name
or
*CODEPAGEY

LOAD

Use load code page in Tansfer Options (Settings)

Option-Write-Report

N
or
Y

Unload
Load
Scan

Reports in Tools

Write report in Work File and Report Options

Default-Report-Direct-Command

B
or
N
or
Y

Unload
Load
Scan

Defines the kind of report to be written when a direct command is executed and no report option is specified in the Object Handler command.
B Write a batch report. Report data is written directly to the output device. Corresponds to option BATCHREPORT.
Y Write a report using a text member. Corresponds to option REPORT.
N Do not write a report. Corresponds to option NOREPORT.
Default-Report-Option-1

A
or
E
or
S

Unload
Load
Scan
Delete

Defines the option for the report to be written when a direct command is executed and option REPORT-OPTION-1 is not specified in the Object Handler command. For possible values, see REPORT-OPTION-1.
Default-Report-Format

S
or
T

Unload

Defines the format of the report to be written when a direct command is executed and option REPORT-FORMAT is not specified in the Object Handler command. For possible values, see REPORT-FORMAT.
Default-Report-Mode

S
or
L

Unload
Load
Scan

Defines the report mode to be used when a direct command is executed and option REPORT-MODE is not specified in the Object Handler command. For possible values, see REPORT-MODE.
Option-Write-Restart-Info

Y
or
N

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

DELETE-TEMPORARY-REPORT-TEXT

N
or
Y

Unload Load Scan Valid on mainframe only: Y = temporary text members for the report are deleted when the Object Handler is terminated (default value) N = temporary text members for the report are not deleted when the Object Handler is terminated