ICL 1900 Series George 3 Operating System Commands

ARCHIVE (AR)

Function

Enables a user to nominate files owned by him that are to be thrown off-line whenever the backing store unjammer is called in to unjam on-line filestore. Also enables the operations manager (or any user with the NOTOWNER privilege) to nominate files belonging to other users that are to be similarly dealt with.

Format

ARCHIVE file description1,file description2,... file descriptionn

Forbidden contexts

NO USER

Execution

Each file description is checked and, if valid, the file's directory entry will be updated to indicate that the file is user-ARCHIVEd or manager-ARCHIVEd; the file is user-ARCHIVEd if the user does not possess NOTOWNER privilege, and manager-ARCHIVEd if he does. Note that the files are not thrown off-line immediately: the on-line copy is only erases should the backing store unjammer be called in.

If a file description is invalid, an error will be reported. An error is caused if an attempt is made to ARCHIVE a work file, a directory or a file marked 'do not throw off-line' (files so marked are system files and ones for which an ALWAYSDUMP restore time GIN macro has been issued). If file description refers to a multifile or part of a multifile, the whole multifile will be ARCHIVEd.

Files that are ARCHIVEd will not be thrown off-line by the backing store unjammer should any of the following conditions exist:-

  1. The file is being used
  2. The file is ALLOCATEd to a special residence
  3. The file needs to be dumped
  4. The file is to be LISTFILEd or is HLS-saved
  5. A RETRIEVE has been issued for the file during the last 150 minutes GEORGE has been running. If however, a user-ARCHIVE is issued after the RETRIEVE command, the file will not be retained by the unjammer

If the file ARCHIVEd is allocated to a special residence the message

    file description ARCHIVED BUT ALLOCATED TO SPECIAL RESIDENCE n

is output in the COMMENT category to the monitoring file.

Note that a user may find out which of his files are ARCHIVEd by a HIGH level LISTDIR command.

A user may ARCHIVE a file even of it or its directory is user-frozen.

Example

ARCHIVE FRED,:ME.BERT,:APSEYDO.JOHN(3)

Error Messages

YOU DO NOT OWN file description
file description MAY NOT BE ARCHIVED

CANCEL ARCHIVE

Function

Cancels a previously issued ARCHIVE command. Note that a user's attempts to CANCEL ARCHIVE a manager-ARCHIVEd file owned by him will have no effect.

Format

CANCEL ARCHIVE file description1,file description2,... file descriptionn

Forbidden contexts

NOT USER

Execution

If the user owns the file, his previously issued ARCHIVE command for that file will be cancelled (but of course the file could still remain manager-ARCHIVEd). If the user does not own the file and does not have the NOTOWNER privilege, an error will be reported. If the command is issued by a user with NOTOWNER privilege, the fact that the file is manager-ARCHIVEd will be cancelled (though the file may still be user-ARCHIVEd unless the user is also he owner of the file).

Error Messages

YOU ARE NOT THE OWNER OF file description
file description MAY NOT BE ARCHIVED