DEALLOCATE



DEALLOCATE

     Deallocates a program or procedure previously loaded into
     memory with the ALLOCATE command.

SYNTAX

     DEALLOCATE [PROGRAM,  ]NAME
                 [PROCEDURE,]


PARAMETERS

PROGRAM             THE PROGRAM FILE INDICATED BY NAME IS DEALLOCATED.
                    DEFAULT.

PROCEDURE           THE CODE SEGMENT CONTAINING THE PROCEDURE SPECIFIED
                    BY NAME IN SL.PUB.SYS IS DEALLOCATED.  DEFAULT IS
                    PROGRAM.

NAME                THE NAME OF THE PROGRAM FILE OR PROCEDURE TO BE
                    DEALLOCATED.


OPERATION

     DEALLOCATE WILL IMMEDIATELY RELEASE TABLE ENTRIES BELONGING
     TO A PROGRAM FILE OR PROCEDURE THAT HAS BEEN ALLOCATED. IF
     THE PROGRAM IS CURRENTLY EXECUTING, THE COMMAND WILL TAKE
     EFFECT ONCE THE PROGRAM OR PROCEDURE IS NO LONGER IN USE.

     NM AND CM LOADER ERROR MESSAGES ARE REPORTED DIFFERENTLY,
     ALLOWING YOU TO DETERMINE THE SYSTEM IN WHICH THE ERROR
     OCCURRED.

     NM LOADER ERROR:  ERRMESSAGE (LDERR nnnn)

     CM LOADER ERROR:  ERRMESSAGE (LOAD ERR nnnn)


     THIS COMMAND MAY BE ISSUED FROM A SESSION, JOB, PROGRAM, OR
     IN BREAK.  PRESSING [BREAK] HAS NO EFFECT ON THIS COMMAND.
     ANY PROGRAM FOR WHICH A USER HAS EXECUTE ACCESS CAN BE
     DEALLOCATED.  A USER WITH OP CAPABILITY CAN DEALLOCATE ANY
     PROGRAM.


EXAMPLE(S)

     TO DEALLOCATE A PROGRAM FILE NAMED PROGEX, ENTER

     DEALLOCATE PROGEX

     DEALLOCATE DOES NOT GIVE BACK MEMORY; IT GIVES BACK TABLE
     ENTRIES.

ADDITIONAL INFORMATION

COMMANDS:   ALLOCATE

MANUALS :   INTRODUCTION TO MPE XL FOR MPE V PROGRAMMERS (30367-60004)