Filter
Top Products
Chapter 2 45
Command Definitions A-B
ALLOCATE
ALLOCATE
Loads a compatibility mode program or procedure into virtual memory.
Syntax
ALLOCATE [ PROCEDURE, | PROGRAM, ] name
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.