Permanently loads a Compatibility Mode program or procedure
into main memory (CM).
ALLOCATE [PROCEDURE,] name
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
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.
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
The user issuing the ALLOCATE command must have EXECUTE
access for any file referenced in the name parameter of this
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.
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)
To allocate a procedure identified as PROC1, that resides in
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.