Function
Enables a user to check in what modes he, another user, or a group of users is allowed to open a named entrant.
Format
TRAPCHECK entrant description, user name, GROUP
The second parameter may be omitted, in which case the proper user is
assumed to be referring to himself.
The GROUP parameter is also optional.
Except for the first parameter, null parameters are ignored. Duplicated
trapmodes are commented on.
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 may only enquire about his own access to an entrant or about another user's access to one of his own entrants. The enquiry includes a check on any modes of access permitted to the named or assumed user as a result of his membership of a group (see TRAPGO).
If the GROUP parameter is given, a check is only made on the group traps of the given user and his superiors; any trap that applies to him individually is ignored.
A reply is sent to the monitoring file system (COMMENT category) specifying the modes in which the user is allowed access to the entrant.
Examples
TRAPCHECK MYFILE,:JONES,GROUP
TRAPCHECK (1010,MFDATA(/200),GROUP
TRAPCHECK OTHERFILE
TRAPCHECK MYFILE,:FRED
Error Messages
ENTRANT DESCRIPTION PARAMETER MISSING
YOU DO NOT HAVE THE AUTHORITY TO ASCERTAIN THE ACCESS OF THIS USER IN
THIS ENTRANT
UNRECOGNISED TRAPMODE PARAMETER
THIS USER IS A PSEUDO USER AND MAY NOT BE GIVEN TRAPS
TRACING AND REPORTING ARE SUCH THAT YOU WILL GET NO OUTPUT FROM THIS
COMMAND