Rational Developer for System z, Version 7.5

New Data Element wizard

Fill in all the fields of this wizard to create a Data Element.

Project
Choose a project in the dropdown list or enter the name of the project in which the instance will be saved.

A project represents the physical distribution of your instances in your workspace. It groups directories and files. It is used to organize resources which will be built, shared or versioned.

A Pacbase project contains a sub-set of files which correspond to the models and/or generated sources making up a Pacbase application.

There can be various projects for each location (a location is the equivalent of a database).

Package
Choose a package in the dropdown list or enter the name of a new package.

A package corresponds to a logical group of information.

The logical resources contained in a package can be distributed into various projects.

In the 'Navigator' view of the 'Design' perspective, you will see that the packages represent the branches of your projects. Each package contains its own instances.

So naming a package after a library is a good idea. To reflect the library hierarchy, you can enter the library names (starting from the highest-level library), and separate each with a period (ex: 'COM.CIF') . This way, the 'Navigator' view will display a first-level branch, COM, with its instances, and a second-level branch, CIF, with its own instances.

Project
Choose a project in the dropdown list or enter the name of the project in which the instance will be saved.

A project represents the physical distribution of your instances in your workspace. It groups directories and files. It is used to organize resources which will be built, shared or versioned.

A Pacbase project contains a sub-set of files which correspond to the models and/or generated sources making up a Pacbase application.

There can be various projects for each location (a location is the equivalent of a database).

Name
This name references the Data Element independently of any Data Structure, Report or Screen to which the Data Element might belong (there is no need to include a Report, Screen or Segment name in the Data Element name since the System does it automatically).

This name consists of alphabetic or numeric characters only. The following table lists the Data Element names that cannot be created:

Name Reserved for
FILLER Field alignment

ENPR

GRPR

ERUT

Error check fields on transaction files (options of the Batch Function)

Data Element error check

Segment error check

User-defined errors

Internal format
This format, displayed in the Overview tab, is required, except if the Data Element is a Property.

The internal format is used when the Data Element is called:

  • in an application file (permanent file, database, temporary file),
  • in a Screen as an input field, if no conversational format has been specified. (See the 'type of line' field in the '-D Lines' tab of the Data Element editor).
This format is automatically transferred into the Segments where the Data Element is called. But you eventually select the appropriate format in the -CD Lines tab of the Programs which call these Segments.

The internal format must be coded like a COBOL picture (without print characters).

Note: for ’Unicode’-type Data Elements (’U’ type in the Definition tab), you must indicate ’N(n)’ or a signed or unsigned numeric format

If the format of a numeric Data Element is more than 10 characters long, you must omit the ’9’ that would normally be entered after the ’V’ (for example: S9(10)V9(3) must be entered as S9(10)V(3)). This way of coding must not be used when the format is shorter than 10 characters.

Note: For ’Unicode’-type Data Elements, you must indicate ’N(n)’ or a signed or unsigned numeric format. The usage is always Display, except for ’Unicode’-type Data Elements, whose usage is ’N’ (default), ’X’ or ’1’.
The ’INTERNAL USAGE’ clause is associated with this format.
Note: if ’Unicode’-type Data Elements have a signed numeric internal format, their internal usage must be ’X’ or ’1’.
Data Elements that represent a date can be assigned a symbolic format:
Symbolic value Meaning
D Without century (DDMMYY or MMDDYY)
C With century (DDMMCCYY or MMDDCCYY)
I Without century (YYMMDD)
S With century (CCYYMMDD)
E Without century (DD/MM/YY or MM/DD/YY)
M With century (DD/MM/CCYY or MM/DD/CCYY)
G Gregorian format (CCYY-MM-DD)
T Timestamp format
Note: For the formats which include a separator (E, G, M and T), you can specify, after the character which represents the format, a separator if you do not want to use the separator included by default in the format (For example, A ’G/’ format will generate CCYY/MM/DD instead of CCYY-MM-DD, which is the default Gregorian format).

For details on the use of the formats with the various types of database blocks, see the summary tables in chapter 'Columns: Data Elements' of the 'Relational SQL Database Description' Manual at this URL:

http://www-1.ibm.com/support/docview.wss?rs=37&context=SSEP67&uid=swg27005478

Label
Enter the label, which identifies the new instance. It will then constitute a search criterion for a subsequent search.
Generation parameters
Generation parameters are specified in libraries. These parameters are related to the adaptation to the operating system in use.

You select the library by clicking the Browse... button.

Open editor on finish
Check this box if you want the editor of the instance you are creating to open up automatically. The editor will open up on the Overview tab. From there, you will be able to access the other tabs to specify all the characteristics of the instance.
Related concepts
Data Element
Related tasks
Creating a Data Element

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)