HP 3000 Manuals

MPE/iX Commands Reference Manual Volume I

ALLOCATE 

Loads a compatibility mode program or procedure into virtual memory.

Syntax 

ALLOCATE [PROCEDURE,]name 
         [PROGRAM,  ]
Parameters 

PROCEDURE             The procedure in SL.PUB.SYS to be allocated.  The
                      default is PROGRAM.

PROGRAM               The program file to be allocated.  Default.

name                  The name of the program file or procedure to be
                      allocated.

Operation Notes 

A program or procedure is allocated by resolving external references and
assigning code segment table (CST) or extended code segment table (XCST)
entries to the program's code segments.  Table entries are also allocated
for any procedures called by the allocated program or procedure.
Allocating a program or procedure does not increase execution speed but
it does reduce the time it takes to load the program for execution.


CAUTION  Use care in deciding which programs or procedures to load with
         the ALLOCATE command.  The number of CST table entries is
         limited and, if the limit is exceeded, data may be lost.


Segments remain loaded until they are deallocated with the DEALLOCATE
command, or until the system is shut down or a system failure occurs.
Programs or procedures must be reallocated with the ALLOCATE command
following any start up.

To issue the ALLOCATE command a user must have EXECUTE access for any
file referenced in the name parameter of this command.

Any external procedures referenced by a program being allocated by this
command must reside in SL.PUB.SYS.


NOTE  Native mode (NM) and Compatibility Mode (CM) loader error messages
      are reported differently, allowing you to determine the system in
      which the error occurred.

      NM Loader Error:  ErrMessage (LDRERRnnnn)

      CM Loader Error:  ErrMessage (LOAD ERRnnnn)


Use 

This command may be issued from a session or program.  Pressing Break has
no effect on this command.  System supervisor (OP) capability is required
to use this command.

In addition to comma (,) a semicolon (;) and equal sign (=) may be used
as a delimiter.

Example 

To allocate a procedure identified as PROC1, that resides in SL.PUB.SYS,
enter:

     ALLOCATE PROCEDURE,PROC1 

Program files residing in the nonsystem domain (a volume set) are not
allocated.  Attempts to do so result in a LOAD ERR 92 message.

Related Information 

Commands      DEALLOCATE

Manuals       Introduction to MPE XL for MPE V Programmers (30367-60004)

MPE/iX 5.0 Documentation