Function
Enables the system manager to specify that:
Format
Format 1 specifies the filestore residence and the files to be held on that residence. residence number need not be the first parameter, but the first numeric parameter will be used as the residence number. Residences with numbers in the range 48 to 63 are known as special residences. Workfiles or whole multifiles may not be ALLOCATEd, but it is possible to ALLOCATE individual multifile elements.
Format 2 is used to specify PUBLIC files.
Up to 24 file descriptions may be specified with both formats.
Forbidden contexts
This command can only be issued by the central operator or by a job running under user :MANAGER.
Execution
Each file description is treated independently, so that an error in one does not affect the allocation of the others.
The specified files are ALLOCATEd to the filestore residence specified. No traps traps are checked, and any files may be specified, including directories. If the files are already on another residence they are moved across to the one specified, even if they are open at the time. If the files are off-line they are not brought on-line, but when they are next retrieved or emptied they are put on the specified residence
It is advisable to ALLOCATE :MASTER to the fastest filestore residence, as it has been found that :MASTER is usually the most frequently accessed file within filestore.
Examples
ALLOCATE 50,:MASTER.DICTIONARY,:MANAGER,:SYSTEM
ALLOCATE :SYSTEM.INCINDEX,:SYSTEM.SERIAL,48
Error Messages
THIS COMMAND IS NOT FOR GENERAL USE
z IS NOT A VALID RESIDENCE NUMBER
RESIDENCE NUMBER NOT SPECIFIED
FILES ALLOCATED BUT RESIDENCE z DOES NOT EXIST
Function
Enables the system manager to cancel the ALLOCATion of specified files.
Format
CANCEL ALLOCATE file description,file description,file description,...
Up to 24 file descriptions may be specified; in NO USER context each file description must include a user name.
Forbidden contexts
This command can only be issued by the central operator or by a job running under user :MANAGER.
Execution
All the files specified that were PUBLIC files will cease to be be so, files which were ALLOCATEd to residences will no longer be so ALLOCATEd, and files which were on special residences will be moved across to non-special residences.