Access
To display, create or modify the general characteristics of a join entity, select the corresponding option in the context-sensitive menu (or the equivalent button) in the Join entities tab of the LDM/PDM screen.
Reminder: Join entities are taken into account only in AS/400 native generation.
Data entry
Name
Name of the join entity.
This name must be a valid join entity name (as defined by IBM), unique in the repository.
Length: 15 characters maximum.
Mandatory entry.
Description
Description clearly identifying the join entity.
Length: 250 characters maximum.
If, in the environment's attributes the "Size 50 exceeded warning" option for AS/400 object description has been activated, then the text turns red when the description exceeds 50 characters.
Mandatory entry.
File name
Name of the future generated join logical file.
Default: first 10 characters of the join entity name if the Generate real file name option is checked in the environment attributes; otherwise the first 8 characters of the join entity name.
Radio buttons
Visibility
The visibility of a join entity can be either public or private.
Only the owner of the join entity, or a software engineer with modification authorities, can change the visibility.
A public join entity cannot be changed into a private join entity if it is attached to more than one application area.
In creation mode, the visibility is initialized as public.
Lists
Join entity
To select the logical entity pairs which form a join entity, click the list boxes.
A filter located above each list can be used to limit the logical entities displayed.
The Add button becomes active once the two logical entities are selected. You simply click this button to add the selected entity pair to the list.
The sequence of the entity pairs in the list can be modified.
Join properties
Properties on which the join entity is defined.
To select join properties for each entity pair of the list, select a pair in the JOIN ENTITY list, then click each join property list box.
The Add button can then be used the selected property pair to add to the list of join properties.
The sequence of properties in the list can be modified.
Buttons
Add (join entity)
This button adds to the list the logical entity pairs entered in the fields located above the list.
Delete (join entity)
This button deletes from the list one or several join entity pairs.
Add (join property)
This button adds to the list of existing join property pairs, the property pairs entered in the fields located above the list.
Delete (join property)
This button deletes from the list one or several existing join property pair.
Display/Assign
This button opens a dialog box displaying the list of management rules assigned to the join entity, as well as the list of available management rules which can be assigned to the join entity.
Sequence
This button opens a dialog box displaying the list of management rules assigned to the join entity, in order to resequence this list by modifying the sequence numbers of the listed management rules.
This button is not active in display mode.
Format
This button opens a dialog box which is used to display or modify the format of a join entity.
Information
This button opens a dialog box displaying information on the current join entity, such as the name of the software engineer-owner, the dates and times of creation and modification.
Comments
This button opens a dialog box for entering a comment text which will be associated with the current join entity.
Enter/Create/Modify (validation)
The Enter button (in display mode) closes the dialog box.
The Create button (in creation mode) or Modify button (in modification mode) validates the dialog box.
The various fields of the dialog box are verified. If all are valid, the join entity definition is updated in the database before the box is closed; otherwise, an error message is displayed.
Cancel
This button closes the dialog box without validating the choices made.
Keyboard shortcut: Esc.