Creating Synonyms for JD Edwards EnterpriseOne

How to:

Reference:

Before you can use the Adapter for JD Edwards EnterpriseOne, you must create synonyms for the data you will be reporting against using one of the data adapters that is supported on your platform, and set the paths required to access those synonyms:


Top of page

x
Procedure: How to Create Synonyms for JD Edwards EnterpriseOne

Note: To create a synonym under IBM i, see How to Create Synonyms for JD Edwards EnterpriseOne Under IBM i

From the Web Console or the Data Management Console:

  1. Configure the adapter you wish to use to create synonyms for the JD Edwards EnterpriseOne data.
  2. Use the configured adapter to create synonyms for the JD Edwards EnterpriseOne tables you wish to use. During this process, you will select the tables for which you wish to create synonyms and specify the application in which the tables will be stored.

For details about configuration and synonym creation steps for supported data adapters, see Using the Adapter for DB2, Using the Adapter for Microsoft SQL Server, or Using the Adapter for Oracle.

Note: JD Edwards EnterpriseOne synonyms can only be refreshed or re-created using the JD Edwards EnterpriseOne adapter. Right-clicking on any JD Edwards EnterpriseOne synonym to refresh the synonym should never be used.


Top of page

x
Procedure: How to Create Synonyms for JD Edwards EnterpriseOne Under IBM i
  1. From the navigation pane of the Adapters page, right-click the JD Edwards EnterpriseOne adapter and select Create Synonym.

    The Select adapter to configure or Select connection to create synonym page opens.

  2. Double-click a DB2 connection.

    The first of a series of synonym creation panes opens.

  3. Enter values for the parameters required by the adapter as described in Synonym Creation Parameters for JD Edwards EnterpriceOne Under IBM i.
  4. After entering the parameter values, click Create Synonym.

The Status pane indicates that the synonym was created successfully.The synonym is created and added under the specified application directory.


Top of page

x
Reference: Synonym Creation Parameters for JD Edwards EnterpriceOne Under IBM i

The following list describes the parameters for which you will need to supply values, and related tasks you will need to complete in order to create a synonym for the adapter. These options may appear on multiple panes. To advance from pane to pane, click the buttons provided, ending with the Create Synonym button, which generates the synonym based on your entries.

Select Synonym Candidates for DB2 (CON) Step 1

Restrict Object Type to

Restrict candidates for synonym creation based on the selected object type(s): Tables, Views, External SQL Scripts, and any other supported objects.

Choosing External SQL Scripts from the drop-down list enables you to represent an SQL Query as a synonym for read-only reporting. A Synonym candidate can be any file that contains one (and only one) valid SQL Query and does not contain end-of-statement delimiters (";" or "/") and comments.

Depending on the adapter, you can further restrict your search by choosing check boxes for listed objects.

Library

Type a string for filtering the Library (or DB2 Collection), inserting the wildcard character (%) as needed at the beginning and/or end of the string. For example, enter: ABC% to select tables or views whose owner IDs begin with the letters ABC; %ABC to select tables or views whose owner IDs end with the letters ABC; %ABC% to select tables or views whose owner IDs contain the letters ABC at the beginning, middle, or end.

Object Name

Type a string for filtering the table, view, or object names, inserting the wildcard character (%) as needed at the beginning and/or end of the string. For example, enter: ABC% to select all tables, views, or objects whose names begin with the letters ABC; %ABC to select all whose names end with the letters ABC; %ABC% to select all whose names contain the letters ABC at the beginning, middle, or end.

Note: When you create a synonym for DB2 on the IBM i platform, standard IBM i naming conventions apply to the target data source. Therefore, the Adapter for DB2 supports the use of double-quotation marks around any library name and/or file name that contains lowercase or NLS characters.

Create Synonym for DB2 (CON) Step 2 of 3

Cardinality

Select the Cardinality check box to reflect the current cardinality (number of rows or tuples) in the table during metadata creation. Cardinality is used for equi-joins. The order of retrieval is based on the size (cardinality) of the table. Smaller tables are read first.

If the cardinality of the tables to be used in the application are dynamic, it may not be beneficial to choose this setting.

With foreign key

Select the With foreign key check box to include within this synonym every table related to the current table by a foreign key. The resulting multi-table synonym describes all of the foreign key relationships of this table.

Dynamic columns

To specify that the Master File created for the synonym should not contain column information, select the Dynamic columns check box.

If this option is selected, column data is retrieved dynamically from the data source at the time of the request.

One-part name

On the IBM i platform, the One-part name check box is unchecked by default. The unchecked behavior generates a table name that includes the explicit name of the library containing the table. For example, if you specified a library on the first Create Synonym pane, a qualified name like the following is automatically created in the Access File:

TABLENAME=MYLIB/MYTABLE

With this explicit type of entry in the Access File, at run-time the library is directly located and searched for the table name. If you select the check box, the explicit library name is not stored in the metadata (Access File). When the synonym is generated, the library portion of the table name is omitted from the Access File, and appears as follows:

TABLENAME=MYTABLE

With this type of entry in the Access File, at run time the library path of the user is searched until the table name is located.

For Subquery

Only available when External SQL Scripts is selected from the Restrict objects type to drop-down menu. When selected, a SUBQUERY keyword is added to the Access File of the generated synonym. If the corresponding SQL string is not parameterized (that is, does not contain parameter markers, such as ? or :), it will be processed as a subquery embedded into a FROM clause of the generated SELECT query. Otherwise, the setting will be ignored, and a FOC1782 warning message will be issued. The default is selected (SUBQUERY=Y).

Application

Select an application directory. The default value is baseapp.

Prefix/Suffix

If you have tables with identical table names, assign a prefix or a suffix to distinguish them. For example, if you have identically named human resources and payroll tables, assign the prefix HR to distinguish the synonyms for the human resources tables. Note that the resulting synonym name cannot exceed 64 characters.

If all tables and views have unique names, leave the prefix and suffix fields blank.

Customize data type mappings

To change the data type mappings from their default settings, select this check box. The customizable mappings are displayed.

Overwrite Existing Synonyms

To specify that this synonym should overwrite any earlier synonym with the same fully qualified name, select the Overwrite existing synonyms check box.

Note: The connected user must have operating system write privileges in order to recreate a synonym.

Create Synonym for DB2 Step 3 of 3

Select date format

The options are: YMD, YYMD, DMY, MDY, MDYY, DMYY, MYY,YYM. (YYMD is the default setting.) The selected format will be used only if the field is described as a DATE in the DataDictionary.

Presumptive Join

Select the Presumptive Joins check box to include additional DEFINEs (virtual fields) for presumptive join fields in the synonym.

The default default setting is ON.

Field Names

Select the Long Fieldname radio button (the default) to display the field descriptions as names on reports. Select the Short Fieldname radio button to use the JDE aliases as field names on reports. The default setting is Long Fieldname.

Language Code

Enter the appropriate Language Code, which exists in the JDE F9292 file. (Leave the field blank for English.)

UDC

Select the UDC check box to ensure that UDC description fields are generated as DEFINEs (virtual fields) in the synonym. The default setting is ON.

Combine UDC

Select the Combine UDC check box to Combine User Defined Code. The default setting is OFF.


Top of page

x
Reference: Ensuring Master File Compatibility Between IBM i and Windows

Before you begin the configuration procedure, it is advisable to consider whether you have procedures that were designed to run on the IBM i platform, which you may wish to run in a Windows environment. If you anticipate this need, your first task is to synchronize the Master Files generated on Windows with those generated on IBM i using the amper variable &MFDCOMP in the jdegdinc.fex file.

The default variable setting is:

-DEFAULT &MFDCOMP='N';

To ensure matching field names on IBM i and Windows, revise the setting to:

-DEFAULT &MFDCOMP='Y'; 

iWay Software