HP 3000 Manuals

HP ALLBASE/4GL Developer Self-Paced Training Guide

Training Application Definition 

The following paragraphs describe the procedure for creating the
application definition for the training application.  Developers may
choose to develop their application using one of three data managers;
KSAM data files, HP ALLBASE/SQL databases, or HP TurboIMAGE/iX databases.
Make sure that you complete the correct instructions.

The application definition screen allows you to define the essential
details about the administration of an application.  You must define the
application name, password, and the users or user groups.  You must also
define the name and the type of the first action to be executed when the
application starts.

You don't have to strictly adhere to the following suggested entries.
They are the minimum requirements.  There may be some administrative
standards implemented at your site that require you to alter some of the
values specified here.  The following text draws attention to fields that
must not be changed.


            

Training Application Definition (Continued) 

Entering the Field Values 

Application.  Enter training

This is the name that developers and end users will use to access this
application.

You don't need to use the name training.  However, if you do use a
different name, ensure that you use that name in place of any reference
to the application name training throughout the Developer Self-Paced 
Training Guide.  Remember that the names administ and developr are
reserved names, and cannot be used as application names.

Application Password Definition.   

The next three fields allow you to define a user password for this
application.  If you do define a password, any end user wanting to use it
must enter the password before gaining access to the application.

Current Password.  No entry is possible in this field as no password
exists for a new application.

This field is bypassed as no password is set when the application is
first defined.  When the application does have a password you must enter
it in this field before you can change the existing password.

New Password.  Leave this field blank.

If you want to enter a password for this application then you can enter a
password in this field.  Passwords can use alphabetic characters, 0 to 9,
and _ (underscore).  The first character of a password must be
alphabetic.  As with all other names, HP ALLBASE/4GL is case sensitive
with respect to passwords.

Repeat New Password.  Leave this field blank.

If you want to enter a password for this application then you should
re-enter the password in this field.  If the two password entries don't
match, you must re-enter the new password in the New Password field.

Development Security Code 

The next three fields allow you to define a development security code for
the application.  If you do define a security code, any developer wishing
to change secured components in the application must enter the correct
security code when signing on to the application.

Current Development Security Code.  No entry is possible in this field.

This field is only active if a security code already exists for the
application.

New Development Security Code.  Leave this field blank.

This is where you can enter a security code for this application.  If you
do enter a code, it is not echoed to the screen.

Repeat New Security Code.  Leave this field blank.

If you enter a new security code, you must repeat it in this field.  If
the two entries don't match, you must re-enter the New Development 
Security Code.

Other Fields 

Initial Action Name.  Enter main

This field defines the name of the first item in the application that HP
ALLBASE/4GL executes when the application starts.  You must enter main
for this application.

Type.  Enter M

This field specifies the action type for the initial action.  It can be
either a menu or a process.

SQL Owner Group. 

If the developer is going to develop the KSAM based or HP TurboIMAGE/iX
based application, leave this field and the next field blank.

If the developer is going to develop the HP ALLBASE/SQL based
application, enter sqlgrp

HP ALLBASE/4GL allows application developers to create base tables in the
application database environment.  HP ALLBASE/4GL also creates a database
module when an application is generated.  HP ALLBASE/SQL requires that
base tables and modules have an owner.

HP ALLBASE/4GL transfers ownership of all base tables and the module for
this application to the owner group specified in this field.

You can enter a different name in this field if required.  However, if
you do use a different owner group name, all references to the owner
group sqlgrp in this manual must be replaced with the correct owner group
name.


NOTE  You cannot change the SQL owner group name for an application after
      development of the application has commenced.


SQL Data Base Name. 

If the developer is going to develop the HP ALLBASE/SQL based
application, enter sqldbase

Otherwise, leave this field blank.

This is the name of the database environment for the application.  The
name of a database environment is the name of the DBEConfile for the
database.

HP ALLBASE/4GL uses a MPE/iX variable HP4SQLPATH to identify the account
and group containing the database DBEConfile.  Refer to the HP 
ALLBASE/4GL Developer Administration Manual for more information about
the MPE/iX variables used by HP ALLBASE/4GL.

Once again, you can use a different name for the database environment
provided you substitute the new name for all references to sqldbase in
this guide.  You cannot change the database environment name after
application development has commenced.

Users and Groups List.   

The next 12 fields list the valid user names or groups who can access a
particular application.  Only the developers and end users listed here
can access this application.

Valid Users/Groups.  Enter *ALL.

*ALL is a special entry specifying that anyone gaining access to HP
ALLBASE/4GL may access this application.  You may wish to enter specific
user names in these fields.

Leave the remaining Valid Users/Groups fields blank.

Description.  Enter a suitable description of the application:

     Training application
     This is the training application for ...

This is a brief description of the application that is used for
documentation purposes.

When the Entries are Complete 

Press the  Commit Data  function key to complete this screen.

If you are defining the application for KSAM developers, you have
completed the application definition, and users can proceed with
developing the application.  Return to the main menu by pressing the  
Previous Menu  function key, and then press the  Sign on Screen  function
key to return to the sign-on screen.

If you are defining the application for HP ALLBASE/SQL developers,
continue reading below.

If you are defining the application for HP TurboIMAGE/iX developers, turn
to HP TurboIMAGE/iX Database Creation.

MPE/iX 5.0 Documentation