Getting started

The different layers in a DID and thus the ITP/SDK for iSeries are best introduced by the fastest way to create a working DID:

Step

Action

Result

Level

1

Start the ITP/SDK for iSeries by entering the command ITPPGM35/STRITP on a command line.

The ITP Main menu is displayed.

2

Choose option 30. ITP Quick start.

The Create DID display is prompted.

DID

3

Enter a name for the DID, a 3-letter identification and a descriptive text.

The DID is created.

The Create DID-source display is prompted.

DID

4

Enter a name for the DID Source, the names for two iSeries libraries (they may be the same library), and a descriptive text

The DID Source and the libraries are created.

The Link DID Source display is prompted.

DID Source level

5

The name of the DID Source from the previous step is already filled in, press Enter.

The DID Source is linked to the DID.

The ITP Main menu is displayed.

DID

Two major items of the ITP administration are now set up: a DID and a DID Source. All the work that remains will be done in the context of either the DID or the DID Source.

In the context of the DID Source:

Step

Action

Result

Level

6

From the ITP Main menu choose option "2. Work with DID Sources".

The panel Work with DID Sources is displayed.

DID Source level

7

Choose option "16=Work with DID-source" for the subfile record containing the DID Source created in step 4.

The DID-source menu is displayed.

8

Choose option "1. Work with Entries"

The panel Work with Entries is displayed.

Entry level

9

Press the function key F20 = Generate.

The display Generate Entry is prompted.

10

Enter a name for the Entry (starting with an uppercase letter and containing no blanks) and the library and file you want to describe. Do not change the defaults already filled in for the other fields.

The Entry is generated.
The Work with Entry fields panel is displayed.

11

Type option "7=Convert to valid ITP name" at the first field displayed on the subfile and press the key F13 = Repeat. Then press Enter

All field names that ITP extracted from the file are converted to valid ITP names.
The Work with Entry fields panel is still displayed.

Field level

12

Press the function key F20 = Add fields to entry.

The Fields are added to the Entry.
If the file is not keyed the Create Main entry panel is prompted (the next step is skipped).
If a file is keyed the panel Work with Formal parameters is displayed.

13

Press the function key F20 = Add formal parameters to entry.

The Formal parameters are added to the Entry.
The panel Work with Entries is displayed.

14

Press the function key F3 = Exit

The menu DID-source is displayed.

Entry level

15

Press the function key F3 = Exit

The panel Work with DID-sources is displayed.

DID Source level

16

Press the function key F3 = Exit

The ITP Main menu is displayed.

 

After step 13 the Entry is created and can be used. More Entries, User defined functions and Entry-Subentry relations may be added to the DID-source.

Before an Entry can be used in an ITP Model it must be "accessible in the DID". There are two ways in which an Entry is accessible in the DID:

  1. The Entry is Subentry to an Entry that is already accessible in the DID;
  2. The Entry is a Main entry of the DID.

The registration of an Entry as a main entry is done in the DID context:

Step

Action

Result

Level

17

From the ITP Main menu choose option "1. Work with DIDs".

The. Work with DIDs panel is displayed.

DID-level

18

Choose option "11=Main entries" for the subfile record containing the DID created in step 3.

The Work with Main entries panel is displayed.

 

19

Press function key "F6=Create".

The Create Main entry display is prompted.

 

20

Enter the name of the Entry (created in step 10) and the name of the DID-source (created in step 4) and press Enter.

The newly created Entry is registered as a Main entry of the DID.

The Work with Main entries panel is displayed.

 

21

Press function key "F3=Exit"

The Work with DIDs panel is displayed.

 

22

Press function key "F3=Exit"

The ITP Main menu is displayed.

 

After step 20 the DID is finished and ready for download. The download must either be initiated from a PC on which the ITP/MDK Repository cliënt version 3.5.18 or up is installed or from a PC on which ITP/Workstation is installed.

For download using the ITP/MDK Repository, refer to the online help that comes with the action "Download ISeries DID...".

For download using ITP/Workstation, please refer to the iSeries DID Management chapter from the ITP Administrator manual for more information about how to proceed from this point on.

The previous steps resulted in:

AS400-Database