Step 2: Name the Application

Defining an Application Structure Using ADSA › Instructions › Step 2: Name the Application

Step 2: Name the Application

The ADSA Main Menu screen allows you to specify the name of the application, its version number, and the dictionary in which it resides. This dictionary name overrides the current default (if one has been set) and becomes the new default dictionary.

Screen prompts

When you begin an application definition, you typically enter information after one or more of the following Main Menu screen prompts:

Application name— You must supply an application name. The name you specify must be unique among all program names (including applications, dialogs, maps, tables, help modules, etc.)
Application version— You can optionally type a version number for the application after this prompt. When following the example in this manual, use the default version number of 1.
In a development environment, you might select a different test version number, such as 5. You would give all test components the same test version number. You would then set up the system so that, when you execute the application, test components are executed rather than production components.

For more information on maintaining separate test and production definitions in the same data dictionary, see CA IDMS System Operations Guide
Dictionary name—A dictionary name may already be displayed after the Dictionary name prompt on your terminal. A sample dictionary name (DEMO) is shown in examples throughout this manual.
If a dictionary name is not displayed, check with others at your site to find out if you need to specify one. You typically need to enter the name of your group's dictionary only when you are not using the default dictionary in a multiple-dictionary environment.
Dictionary node—A dictionary node name may already be displayed after the Dictionary node prompt on your terminal. Sample definition screens in this manual do not show a node name.
If a dictionary node is not displayed, check with others at your site to find out if you need to specify one.

You can use the tab key to move the cursor quickly and easily between prompts. Begin defining your application on the Main Menu screen as shown below:

Add Modify Compile Delete Display Switch .__________________________________________________________________________. CA ADS Application Compiler CA, Inc. Application name . . . . xxxappl_ Application version . . 1___ Dictionary name . . . . demo____ Dictionary node . . . . ________

Adding the application

To add the application, position the cursor on the Add item on the action bar and press [Enter]. You can position the cursor on Add by:

Pressing [PF10] move to the action bar and then tabbing to Add and pressing [Enter]
Tabbing to Add and pressing [Enter]
Typing add on the command line and pressing [Enter]

Add Modify Compile Delete Display Switch ._____________________________________________________________________________. │ │ │ Copy from application│A-ADS Application Compiler │ Name ________ │ │ Version 1 │ter Associates International, Inc. │-----------------------│ │ F3=Exit │ │_______________________│ Application name . . . . XXXAPPL_ Application version . . . 1 Dictionary name . . . . . DEMO____ Dictionary node . . . . . ________

Once you have displayed the Add action item, press [Enter] to add the application to the dictionary. The action is confirmed.

ADSA redisplays the Main Menu screen with an appropriate message:

A confirming message is returned when your definition contains no errors.
An error message is returned if ADSA detects any errors. Read the message to see what problem has occurred. You can type over any fields in error and then press [Enter] again.