Function
Enables a user with the FREEZE privilege to user-freeze a directory or terminal file and thus stop any non-privileged user from accessing it (and, in the case of directories, terminal files and Librarian entrants within it). A directory might, for instance, be user-frozen while some of that user's files are updated on another machine.
Format
FREEZE file description1,file description2, ....file descriptionn
Up to 24 file descriptions may be given in a single FREEZE command, each being the name of a directory or terminal file.
Forbidden contexts
NO USER
Execution
A check is made to ensure that the user has FREEZE privilege; if not, a command error is reported. Each file description is then validated, but no trap checking is performed. If the file is a terminal file, its directory entry is updated to indicate it is user-frozen. If it is a directory, a command error will be reported if jobs are at present running under that user; in assessing this, jobs in the well for that user, and those that specified a FROZEN parameter to the job initiation command, will be ignored, but HLS-saved jobs for that user will be included. If no jobs are being run for that user, the directory entry is marked as user-frozen. Any MOP jobs in the well are marked as non-candidates for starting.
A command error will be reported if an attepmt is made to user-freeze a workfile, :MASTER, an individual element of a multifile (though while multifiles may be frozen), or Librarian entrants. Note also that freezing a directory does not automatically freeze inferior directories.
The effect of freezing
A check as to whether a file is user-frozen is performed whenever any attempt is made to access it and, in the case of a directory, to access terminal files and Librarian entrants within it. A command error is then normally reported if it is frozen. However, if a user has the FREEZE privilege, he is allowed access to frozen entrants (traps permitting) provided he specifies the FROZEN qualifier to the appropriate entrant description. Such a privileged user may also start a job in a user-frozen directory by specifiying the parameter FROZEN to the job initiation command.
Note that freeze checking on multifiles is performed onlky when the multifile is opened and not as each individual component is opened.
Example
FREEZE :FRED,:BERT.FILE1,:BERT.FILE2(3/RRRR)
Error Messages
TEMPORARY DIRECTORIES ARE NOT ALLOWED WITH THIS COMMAND
LIBRARIAN ENTRANTS ARE NOT ALLOWED WITH THIS COMMAND
MULTIFILE ELEMENTS ARE NOT ALLOWED WITH THIS COMMAND
THIS USER HAS STARTED JOBS WHICH MAY NOT BE RUN UNDER A FROZEN
DIRECTORY
Function
Enables a user with the FREEZE privilege to cancel the freeze on a user-frozen directory or terminal file.
Format
CANCEL FREEZE file description1,file description2, ....file descriptionn
Up to 24 file descriptions may be given in a single FREEZE command, each being the name of a directory or terminal file.
Execution
If the user possesses the FREEZE privilege, each entrant description is validated, but no trap checking is performed. The user-frozen indicator is removed from the directory entry of the file. In addition, if the file is a directory, the job well is updated to indicate that jobs for this user can now be considered for starting.
Error Messages
TEMPORARY DIRECTORIES ARE NOT ALLOWED WITH THIS COMMAND
LIBRARIAN ENTRANTS ARE NOT ALLOWED WITH THIS COMMAND
MULTIFILE ELEMENTS ARE NOT ALLOWED WITH THIS COMMAND