Function
Permits a specified user to have access to an entrant that belongs to the proper user.
Format
TRAPGO entrant description, user name, access mode, access mode ...
There are five possible access modes, for an individual user:
| EXECUTE | The contents of the file may be loaded into core and run | ||
| READ | The file contents may be read | ||
| APPEND | Information may be written to the end of the file | ||
| WRITE | The contents of the file may be overwritten | ||
| ERASE | The file may be erased |
Forbidden contexts
NO USER
Execution
A user trap is set in the relevant entry of the proper user's directory. This contains the name of the user who is being allowed access to this entrant and indicators which specify the modes in which access is permitted.
If GROUP is included as a mode parameter, access will be granted to the named user and to all users inferior to him. A separate trap is set for the named user's group.
Examples
| TRAPGO MYFILE,:JAMES,GROUP,ALL | :JAMES and all users inferior to him will be granted access to MYFILE as a GROUP in every mode |
| TRAPGO TAPEDATA(/230),WRITE | The proper user will be granted WRITE access to the named magnetic tape |
| TRAPGO :Z.F120,:FRED,READ,EXECUTE | :FRED will be granted READ and EXECUTE
access to :Z.F120 :Z is a pseudo user whose directory belongs to the proper user |
Error Messages
ENTRANT DESCRIPTION PARAMETER IS MISSING
TRAPMODE PARAMETER MISSING
YOU ARE NOT OWNER OF THIS ENTRANT
z IS A XENOTAPE AND MAY NOT BE REFERRED TO BY THIS COMMAND
UNRECOGNISED TRAPMODE PARAMETER
THIS USER IS A PSEUDO USER AND MAY NOT BE GIVEN TRAPS