Workspace Configuration Settings

You can specify an IP address for the email server and a sender address. If the server is secured, you can specify the credentials for connecting to the server. You can also test your email connection from the E-mail Settings pane.

To access these settings, click Workspace on the sidebar. Click Settings, point to Workspace SET, and click SMTP Server Settings.

The E-Mail SMTP Server page opens, as shown in the following image.

The following settings are saved in the odin.cfg file:

smtp_host

Indicates the IP address of the SMTP email server using the notation that is supported for your IP version (for example, for IPv4, use base 256 standard dot notation. When IPv6 is supported on a platform, and enabled, you can use either 256 standard dot notation or IPv6 notation.)

port

Indicates the TCP port number that a client is connecting to. The default value is 25.

smtp_user

Is the user ID to authorize access to the SMTP server.

smtp_password

Is the password for the smtp_user.

sender_email

Is the sender email address (the address that appears in the From field in emails).

server_admin_email

Is a list that can consist of email addresses, user IDs and procedure names (for example, %myfex.fex), each on a separate line, with no delimiters.

Note: If email send operations fail, verify that the smtp host is active and/or that a virus scanner is not blocking edachkup.

When you have completed your entries, optionally click the Send Test E-mail button to test your connection, then click Save and Restart Server.

You can control aspects of profile execution from the Profile Settings pane.

To access these settings, click Workspace on the sidebar. From the ribbon, click Settings, point to Workspace SET, and click Profile Settings.

The Profile Settings pane opens, as shown in the following image.

The following Profile Settings are saved in the edaserv.cfg file:

profile_parameter

By passing parameters to profiles, you can submit different session parameters at different connection times. When this parameter is activated, any unresolved variables are prompted for during your initial logon to the Web Console.

Available settings are y and n.

If the server, user, or group profiles contain any unresolved variables, set the profile parameter keyword to y. The default setting is n.

profile_no_domain *

In the Windows Server, to control whether the domain name is included in or excluded from a user profile name, choose:

n to add the domain name to the profile name (for example, user ibi/edaport becomes ibi_edaport.prf). N is the default value.

y to omit the domain name from the profile name (for example, user ibi/edaport becomes edaport.prf). This setting is required for compatibility with earlier releases of the Server.

Note: The y setting can be safely employed if a single domain is in use and there are no local user IDs that could interfere with domain IDs. If there is potential for interference between local user IDs and domain IDs that are connected to the server, the n setting is required to ensure that each user has a unique profile name.

Note that server must be restarted when this parameter is changed.

When you have completed your entries, click Save.

When you want to be able to reuse data within the same browser session, you can store the data in the form of a HOLD, SAVE, or SAVB file in the foccache directory, which is automatically created when the connection to the server is established. This becomes the first directory in the application path.

As long as the browser session remains active, the stored files remain in the foccache directory and can be referenced in requests using standard two part names. For example, the first request below creates a HOLD file in foccache, which is referenced by the second request:

TABLE FILE CAR
PRINT CAR
ON TABLE HOLD AS FOCCACHE/myfile
END

TABLE FILE FOCCACHE/myfile
PRINT * 
END

When the maximum foccache retention time is reached (180 minutes by default), the foccache directory is removed by the server and can no longer be referenced.

This feature provides an important mechanism for caching and running multiple instances of WebFOCUS active and drill-down reports. You can use any WebFOCUS graphical tool to create the request and generate a report.

Note: Each time a WebFOCUS user logs into the Managed Reporting (MR) environment, a new session with its own foccache directory is created. Files that were stored in a prior foccache directory are no longer accessible. When the user logs out of MR the foccache directory used within that MR session is no longer accessible.

To access these settings, click Workspace on the sidebar. From the ribbon, click Settings, point to Workspace SET, and click Application Settings.

The Application Settings pane opens, as shown in the following image.

The following Application Settings are saved in the edaserve.cfg file.

foccache_dir

Defines the location of the foccache directory. The default is edatemp/foccache/....

foccache_maxage

Defines the maximum number of minutes that a foccache directory will last. The default is 180 minutes. When the foccache directory expires, the session also expires.

0 means unlimited (that is, the directory will be remain active as long as the session lasts or the server is running).

nested_app

For applications containing subfolders or multiple-level subfolder trees, this parameter controls whether subfolders will be automatically added to the application path.

The valid values are:

• A positive integer - Enable nested application, and only a specific number of subfolder levels in the active application path.
• n - Disables nested applications. Only applications explicitly in the APP PATH will be used.
• y - Enables nested applications. The entire application subfolder tree under each application in the APP PATH is included into active application path.

The default value is 5.

Note: For z/OS servers, this setting is only applicable to directory-style applications, it is not applicable to PDS-style applications nor to applications mapped as a collection of ddnames.

homeapps

If nested_app is set to y or a number, homeapps defines the location of the home application root directory. With homeapps defined, each connected user will see a My Home applications folder on the Application tree. Users can create new applications (home applications) in this folder. These applications will be visible and available only to the connected user and the server administrator. The user will have full access to his home applications.

Note: Only available with a DataMigrator or Managed Reporting license. A WebFOCUS Reporting Server requires a homeapps license to enable home applications.

upload_allowed

Lists the extensions allowed for upload. You can remove extensions from the list to prevent files with those extensions from being uploaded.

When you have completed your entries, click Save and Restart Server.

Miscellaneous Settings allow you to set additional Workspace operating parameters, including automatic recovery, transaction coordination, soft and hard kill delays, maximum session log rows, time window for running response time averages, and proxy server settings.

To access these settings, click Workspace on the sidebar. From the ribbon, click Settings, point to Workspace SET, and click Miscellaneous Settings.

The Miscellaneous Settings pane opens, as shown in the following image.

The following Miscellaneous Settings are saved in the edaserv.cfg file:

automatic_recovery

Determines whether the server will automatically recover crashed listeners and/or special services. The default is n.

transaction_coordination_mode

Selecting y, activates the iWay Transaction Coordinator. A Two-Phase Commit will be used when XA-Compliant databases participate in a transaction. The default is n.

tscom3_kill_delay1

Defines the time (in seconds) allowed for an agent to stop before soft kill is sent. The default is 16.

tscom3_kill_delay2

Defines the time (in seconds) allowed for a soft kill to work before a hard kill is sent. The default is 32.

crashed_cleanup

By default, crashed agents are kept in the agents table for diagnostics purposes, and are only removed when they are explicitly killed. When this set to y, crashed agents are automatically removed from agents list when the Workspace Manager detects a crash. The default value is n.

crashed_max_dump

If crashed_cleanup is set to y, this determines the number of memory dump files retained for later diagnosis.

stats_runningavg

Defines the time window in seconds for the calculation of running response time averages. The default is 600.

htmlencode

Specifies whether to encode HTML tags in data as plain text in order to prevent attacks by inserting executable code into data. Valid values are y and n. The default value is n.

proxy_server

Defines a proxy server, which acts as an intermediary on requests for resources from other servers.

proxy_port

Defines the port number of the proxy server.

proxy_user

Defines a user ID for the proxy server.

proxy_password

Defines a password for the user ID connecting to the proxy server.

outbound_ssl_certificate_file

Required for SSL when using self-signed certificates on i5 systems.

outbound_ssl_certificate_passphrase

Required for SSL when using self-signed certificates on i5 systems.

outbound_ssl_certificate_label

Required for SSL when using self-signed certificates on i5 systems.

outbound_ssl_certificate_keyfile

Required for SSL when using self-signed certificates on i5 systems.

outbound_ssl_auth_server

Required for SSL when using self-signed certificates on i5 systems.

seslog_max_lines

Defines the upper limit for the number of rows in a session log. When the limit is exceeded, only the latest records will be kept in the session log and the number of records will equal the limit. The default is 1000.

popup_timer

Defines the time in seconds to wait before the popup timer appears. The default is 5.

z/OS Specific Parameters

tmpalloc_primary

tmpalloc_secondary

Allocation (in CYLs) for temporary Web Console files allocated by the HTTP listener. The default is 5 and 50, respectively.

submit_opt

Customizes the call of the IKJEFF10 exit when submitting jobs with the DYNAM SUBMIT command.

smf_recno

Defines the SMF record number that the server will use to record utilization statistics.

smf_subtype

Defines which pairs of SMF subtype records are cut. The options are:

• all. Cut all records. This is the default.
• logon. Cut logon/logoff subtype only.
• query. Cut query begin/query end subtype only.

privatedd

Defines how server will handle allocations for duplicated ddnames (same ddname allocated both to IRUNJCL and from a customer application using DYNAM) and what the search strategy will be.

When you have completed your entries, click Save.

To access these settings, click Workspace on the sidebar or right-click Workspace on the resources tree. Then point ot Locale and click Configuration Wizard. The NLS Configuration Wizard opens, as shown in the following image.

The following NLS settings are saved in the nlscfg.err file:

CODE_PAGE

Is the code page of the data sources accessed by the server.

Select a code page from the drop-down list of supported code pages, including Unicode.

The default value is 1252 for Windows and UNIX, and 37 for IBM i (formerly known as i5/OS) and z/OS.

The current value of CODE_PAGE is available to applications as the &FOCCODEPAGE variable.

Optional customization

Customize code page conversion tables

Select this check box to display a list of code pages and descriptions for the possible data sources accessed by the server or the client code page.

Several code pages are always selected by default and cannot be deselected. These are:

37 --IBM MF United States

137 --U.S. English/Western Europe (Latin 1)

437 --U.S. English

1047 --IBM MF Open Systems (Latin 1)

1252 --Windows Latin; 65001 --Unicode (UTF-8)

65001 Unicode (UTF-8)

65002 Unicode (UTF-EBCDIC)

Other code pages may also be selected by default, depending on the LANG attribute chosen.

The NLS Configuration Wizard creates conversion tables for these code pages to make them available for subsequent conversion.

Select any additional code pages for which you want tables to be created. For example, if you want to designate a particular code page to be generated in synonyms for flat (fixed) files or VSAM files, you must already have created a code page conversion table using the Customize code page conversion table option during NLS configuration.

Recreate ETLLOG, ETLSTATS and FOCUSSU system files

Check this box if you wish to load FOCUS internal files in the server code page (as defined in the CODE_PAGE field).

This is recommended if the compatibility of the new and prior code pages is unknown.

Recreate FOCUS sample files

Check this box if you wish to load the sample files (in the ibisamp application) in the server code page (as defined in the CODE_PAGE field).

TSGU command

TSGU is a utility program to configure NLS settings. It is usually not required, but in the following cases it must be executed manually.

• To create PDFXTBL. When TYPE 1 fonts should be included in PDF format file, the TYPE 1 font transcoding table must be generated using the following syntax:

  PDFX {font-name}

• To create PDFYTBL. When Unicode fonts should be used in PDF format file, the special font information tables (PDFYTBL) must be generated using the following syntax:

  KTBL {pdfy-name} 

Complete the configuration, then click Save/Rebuild NLS Files and Restart Server. The server creates the necessary transcoding, sorting, and monocasing tables for the selected code page.

The Web Console provides parameters for configuring locale-based date, time, and currency parameters.

To access these settings, click Workspace on the sidebar or right-click Workspace on the resources tree. Then click Locale and select Locale (Language, Numbers, Currency, Dates). The Change Core Engine Settings in edasprof.prf page opens, as shown in the following image.

The following parameter values can be set and stored in edasprof.prf.

LANGUAGE

Controls the default value of the code page, and the language of server error messages, if available in translation.

Choose a language name or abbreviation from the drop-down list.

The default value is AMENGLISH (American English) on all platforms.

Localized error message files exist for certain languages. If you choose a language for which localized error message files do not exist, the server messages and console appear in English. If you would like the messages and console to appear in a language for which the server has not been localized, you can provide translation yourself. To localize the console, translate the file wceng.lng and rename it to wcXXX.lng where 'XXX' is the three-letter language code for the server. For error messages, translate all or any relevant *.err files and append the same three-letter language code to it. All files are located in the \home\nls folder.

The current value of LANG is available to applications as the &FOCLANGCODE variable. However, it will be blank if it is not configured.

COLLATION

Establishes a binary or case-insensitive collation sequence. The values are:

• CODEPAGE. Bases the collation sequence on the code page in effect. This is the default value.
• BINARY. Bases the collation sequence on binary values.
• SRV_CS. Bases the collation sequence on the LANGUAGE setting, and is case-sensitive.
• SRV_CI. Bases collation sequence on the LANGUAGE setting, and is case-insensitive.

When code page files are not modified, CODEPAGE is the same as BINARY, except for Danish, Finnish, German, Norwegian, or Swedish in EBCDIC environment.

The SET COLLATION command has the same effect, and overrides this default setting.

CDN

Defines the punctuation symbols to be used for numbers. Valid values are:

• COMMAS_DOT. Uses a dot (.) as the decimal separator and comma (,) as the thousands separator. The alias is OFF. This is the default value.
• DOTS_COMMA. Uses a comma as the decimal separator and dot as the thousands separator. The alias is ON.
• SPACES_COMMA. Uses a comma as the decimal separator and space as the thousands separator. The alias is SPACE.
• SPACES_DOT. Uses a dot as the decimal separator and space as the thousands separator. The alias is SPACEP.
• QUOTES_COMMA. Uses a comma as the decimal separator and single quotation mark (') as the thousands separator. The alias is QUOTE.
• QUOTES_DOT. Uses a dot as the decimal separator and single quotation mark as the thousands separator. The alias is QUOTEP.

CURRENCY_ISO_CODE

Is a standard three-character currency code such as USD for US Dollars or JPY for Japanese Yen. The default value is default, which uses the currency code for the configured language code.

CURRENCY_DISPLAY

Defines the position of the currency symbol relative to a number. The default value is default, which uses the position for the format and currency symbol in effect. Valid values are:

• LEFT_FIXED. The currency symbol is left-justified preceding the number.
• LEFT_FIXED_SPACE. The currency symbol is left-justified preceding the number, with at least one space between the symbol and the number.
• LEFT_FLOAT. The currency symbol precedes the number, with no space between them.
• LEFT_FLOAT_SPACE. The currency symbol precedes the number, with one space between them.
• TRAILING. The currency symbol follows the number, with no space between them.
• TRAILING_SPACE. The currency symbol follows the number, with one space between them.

CURRENCY_PRINT_ISO

Defines what will happen when the currency symbol cannot be displayed by the code page in effect. Valid values are:

• DEFAULT. Replaces the currency symbol with its ISO code, when the symbol cannot be displayed by the code page in effect. This is the default value.
• ALWAYS. Always replaces the currency symbol with its ISO code.
• NEVER. Never replaces the currency symbol with its ISO code. If the currency symbol cannot be displayed by the code page in effect, it will not be printed at all.

DATE_ORDER

Defines the order of date components for display. Valid values are:

• DEFAULT. Respects the original order of date components. This is the default value.
• DMY. Displays all dates in day/month/year order.
• MDY. Displays all dates in month/day/year order.
• YMD. Displays all dates in year/month/day order.

DATE_SEPARATOR

Defines the separator for date components for display. Valid values are:

• DEFAULT. Respects the separator defined by the USAGE format of the field.
• SLASH. Uses a slash (/) to separate date components.
• DASH. Uses a dash (-) to separate date components.
• BLANK. Uses a blank to separate date components.
• DOT. Uses a dot (.) to separate date components.
• NONE. Does not separate date components.

TIME_SEPARATOR

Defines the separator for time components for the &TOD system variable. Valid values are:

• DOT. Uses a dot (.) to separate time components. This is the default value.
• COLON. Uses a colon (:) to separate time components.

BUSDAYS

Defines which days are business days for date-time functions. The default value is _MTWTF_.

HDAY

Specifies a holiday file for listing dates that are non-business days for use with date functions. The default value is OFF (no holiday file).

WEEKFIRST

Defines the first day of the week for the WEEK and WEEKDAY components of date and date-time functions.

This chart provides information generated by the ? LANG SET command from the Windows and UNIX platforms.

This chart provides information generated by the ? LANG SET command from the IBM i and z/OS platforms.