ALLOCATE

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.