ALLOCATE



ALLOCATE

     Permanently loads a Compatibility Mode program or procedure
     into main memory (CM).

SYNTAX

     ALLOCATE [PROCEDURE,] name
              [PROGRAM,  ]


PARAMETERS

PROCEDURE           The procedure in SL.PUB.SYS 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

     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 will not increase
     execution speed.  However, it will reduce the time taken to
     load the program for execution.

CAUTION


Use care in deciding which programs or procedures to load with
ALLOCATE. The number of CST table entries is limited, and if you
exceed the limit, you run the risk of losing data.


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.

The user issuing the ALLOCATE command 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.

This command may be issued from a session or program.
Pressing [Break] has no effect on this command. A user must
have system supervisor (OP) capability to use this command.

NOTE

NM and CM loader error messages are reported differently, allowing you
to determine the system in which the error occurred. If there is an NM
Loader Error, you see the text of the message followed by (LDRERR nnnn).
If there is a CM Loader Error, the error message text is followed by
(LOAD ERR nnnn)


EXAMPLE(S)

     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) will not be allocated.  Attempts to do so will result
     in a LOAD ERR 92 message.

ADDITIONAL INFORMATION

Commands:  DEALLOCATE