HP 3000 Manuals

HP ALLBASE/4GL Run-Time Administration Manual

Defining an Application 

To complete the details for an application definition, select the
Applications option on the administrator main menu.  This selection takes
you to the application definition screen.

This screen allows you to define a password for an application, and to
specify the users for the application.  If the application uses an HP
ALLBASE/SQL database, this screen also allows you to specify some details
for the database.


            

Application Name 

Enter the name of an existing application in the Application field.

The HP ALLBASE/4GL run-time environment does not allow you to define a
new application or rename an existing application.  If you enter a name
that is not the name of an application that exists on your system, HP
ALLBASE/4GL displays an error message.

There are several reserved application names; administ, developr, HPlogo 
and hpqm.

The HPlogo application stores customized sign-on screen windows, and the
hpqm application provides direct access to HP ALLBASE/QUERY (if HP
ALLBASE/QUERY is installed on the system).  You may alter the definitions
for these applications.

You cannot use the administ and developr reserved application names.

Application Passwords 

The next three fields allow you to define a password for the application,
or change an existing password.

Application passwords are optional.  You don't need to define an
application password if you don't have any security requirements for this
application.

Defining a New Password.   

If you haven't defined a password for the application, the Current 
Password field is not active, and the cursor moves to the New Password 
field.

To define a password, enter the password in the New Password field.
Application passwords must start with an alphabetic character and can be
up to eight characters long.  Passwords can use alphabetic characters, 0
to 9, _ (underscore), and trailing spaces.  HP ALLBASE/4GL is case
sensitive with respect to application passwords.  HP ALLBASE/4GL does not
echo the password to the screen as you type it in.

You must enter exactly the same password in the Repeat New Password 
field.  If you don't enter the same password, HP ALLBASE/4GL displays an
error message and returns the cursor to the New Password field.

If you don't require a password for the application leave these fields
blank by pressing Return twice to bypass the fields.

Changing a Password.   

If you have already defined a password for the application, the Current 
Password field is an active input field.  If you want to change or delete
the current password, you must enter the current password in this field.
If you enter an incorrect password the next two fields are bypassed and
the cursor moves to the first Valid Users/Groups field.

If you enter the correct password in the Current Password field, the
cursor moves to the New Password field.  You can now enter the new
password for the application.  Remember that HP ALLBASE/4GL is case
sensitive with respect to passwords.  You must now reenter the new
password in the Repeat New Password field.

If you want to delete an existing application password, enter the current
password in the Current Password field.  Leave the New Password and
Repeat New Password fields blank by pressing Return twice to step through
them.  The cursor moves to the first Valid Users/Groups field.

Initial Action Name and Type 

These are display-only fields.  The display in these fields shows the
name and type of the first action performed by the application.  These
entries are defined by the application developer and cannot be changed.

HP ALLBASE/SQL Database Definition 

If you are defining the details for an application that uses an HP
ALLBASE/SQL database, you must specify the name of the database on the
application definition screen.

Before users can use the application, the database must exist and the
application end users must have the appropriate authorities to access the
database.  Appendix A contains more information about setting up HP
ALLBASE/SQL database environments for HP ALLBASE/4GL applications.

If the application you are defining does not use an HP ALLBASE/SQL
database, you can ignore the next two fields, and go on to the Valid 
Users/Groups fields.

SQL Owner Group.     

This field is a display-only field that shows the name of the SQL owner
group for the application.  This name is defined in the HP ALLBASE/4GL
development environment.  Ownership of all HP ALLBASE/SQL database tables
and executable modules for the application is automatically transferred
to this owner group while the application is under development.

SQL Database Name.     

If the application uses an HP ALLBASE/SQL database, enter the name of the
HP ALLBASE/SQL DBEnvironment configuration file.  This file is commonly
known as the DBECon file.  You can specify a fully qualified file name in
the form FILE.GROUP.ACCOUNT. If you don't specify a fully qualified file
name, HP ALLBASE/4GL appends the current value of the variable HP4SQLPATH
to the name of the file you specify.

When you first access this screen for an application that uses an HP
ALLBASE/SQL database, this field contains the name of the database
environment used in the HP ALLBASE/4GL development environment to develop
the application.  This name is written into the HP ALLBASE/4GL run-time
system when the application is first loaded.

It's possible that an HP ALLBASE/4GL application has been written to
access an existing HP ALLBASE/SQL database.  In this case, you may need
to change the name shown in this field to the name of the database you
want to use.  Your HP ALLBASE/4GL support service can provide you with
the details of the database requirements for your applications.


NOTE  You cannot change the name in the SQL Data Base Name field
      arbitrarily to use an HP ALLBASE/4GL application to access a
      different database.  Applications are designed and written to use
      specific tables or views in the database.  If you attempt to use an
      application with the wrong database, the application will not work,
      and you may corrupt the database.


Valid Users and Groups 

Enter the names of the users or user groups for the application.

You can specify that all system users are valid users for the application
by entering *ALL in the first field.

Alternatively, you can enter up to 12 user names or user group names.
There is no specific limit to the number of users in each user group as
long as the total number of user names and group names doesn't exceed
254.

The user names or group names must exist before you can enter them on
this screen.

HP TurboIMAGE/iX Database Definition 

If you are defining an application that uses one or more HP TurboIMAGE/iX
databases, you must complete several tasks after defining the
application, namely:

   *   Define each HP TurboIMAGE/iX database on the database definition
       screen.

   *   Grant the application access to each database on the parameters
       for database access screen.

For more information, refer to "Maintaining Database Security" .

MPE/iX 5.0 Documentation