HP 3000 Manuals

Command Line Options [ HP ALLBASE/4GL Developer Reference Manual Vol. 1 ] MPE/iX 5.0 Documentation


HP ALLBASE/4GL Developer Reference Manual Vol. 1

Command Line Options 

HP ALLBASE/4GL allows you to use command line options to run the program
in a number of different ways.  These options are available to developer
users and end users.  When used with options, the command line becomes:

     :HP4GL ["options"] [variable = value] ...

In this command, options can be any of the options shown below separated
by spaces.

Option                         Description 

-a [application_name]          This is the form of the -a option used by an end user.
[:application_passwd]          It invokes HP ALLBASE/4GL and passes control directly to
                               the initial action defined for application_name.  If
                               application_name is not specified, the application
                               defaults to that specified for the end user in the
                               administrator end user validation screen.  If the end
                               user has no default application, HP ALLBASE/4GL exits
                               with an error message.  The -u option must be specified
                               with this option.

-a application_name            This is the form of the -a option used by a developer.
[:security_code]               It invokes HP ALLBASE/4GL and passes control directly to
                               the developr main menu (developing the application
                               specified by application_name).  The security_code field
                               is the development security code for the application.
                               The -u option must be specified with this option.

-i [delay]                     Turns on logic tracing with a pause on trace messages of
                               delay seconds.  The delay value can be any value from 0
                               through 9.  If delay is not specified, the pause
                               defaults to 3 seconds.  All messages are logged into a
                               temporary file named HP4TRACE in the user's current
                               group.

          Table 2-0.  (cont.) 

Option                         Description 

-l [logo_screen]               This option allows you to display a customized window
[:logo_application]            (logo_screen) on the sign on screen.  If logo_screen is
                               not specified or cannot be found, HP ALLBASE/4GL
                               attempts to display the default window, logo.  If this
                               cannot be found, HP ALLBASE/4GL displays the standard
                               logo window.  HP ALLBASE/4GL searches the application
                               specified by logo_application for the window
                               logo_screen.  If logo_application is not specified, HP
                               ALLBASE/4GL searches the default application, HPlogo.
                               If the application HPlogo is not defined, HP ALLBASE/4GL
                               displays the standard HP ALLBASE/4GL logo window.  Refer
                               to Customized Sign-On, page 2 - 20 for further
                               information.

-m [delay]                     Sets the pause on each HP ALLBASE/4GL message to delay 
                               seconds.  Delay can be any value from 0 to 9.  If delay 
                               is not specified, the pause defaults to 3 seconds.     

-n                             Activates the Tab key for use with Name Recall function.
                               This function allows developers to use the Tab key to
                               scroll through item names previously defined for an
                               active field on an ALLBASE/4GL screen.

-s                             Turns on logging of HP ALLBASE/4GL messages.  When
                               logging is turned on, all messages are logged into a
                               temporary file named HP4TRACE in the user's current
                               group.

-u user_name                   Bypasses the standard sign on screen and logs the user
[:user_passwd]                 specified by user_name into the HP ALLBASE/4GL
                               application specified by the -a option.  If user_name is
                               a developer, HP ALLBASE/4GL runs the developer
                               application.  The -a option must be specified with this
                               option.

The variable option on this command line allows you to set values for the
MPE/iX variables or job control words used by HP ALLBASE/4GL.

You can set values for the following variables and job control words:

   *   HP4SPATH

   *   HP4DATAPATH

   *   HP4SQLPATH

   *   HP4TIPATH

   *   HP4FSPATH

   *   HP4APPNPATH

   *   HP4DBMPATH

   *   HP4TERM

   *   NLUSERLANG (job control word)

   *   NLDATALANG (job control word)

Values specified on the command line apply only for the current HP
ALLBASE/4GL session.  The existing values (if any) for these variables
and job control words are restored when you exit from HP ALLBASE/4GL.

An example of a command line that includes options and variables would
be:

     hp4gl "-m1" HP4SPATH=SGROUP

Refer to appendix D for more information about these variables and job
control words.



MPE/iX 5.0 Documentation