Usage notes

  1. This service is intended only for use by a z/OS UNIX file system and by z/OS UNIX servers. The service contains support for z/OS UNIX servers, but cannot be directly invoked by a z/OS UNIX server.
  2. Two sets of audit bits exist for a file, one for auditor-specified options and one for user-specified options. The audit flag in the parameter list indicates which type of options should be set.

    If the audit flag indicates auditor options, the user must have auditor authority. Auditors can set the auditor options for any file, even those they do not have path access to or authority to use for any other reason.

    If the audit flag indicates user options, the user must be a superuser or must be the owner of the file (that is, the effective UID of the calling process is equal to the owner UID of the file.)

  3. Start of changeIf the audit flag indicates auditor options, the user must have auditor authority or the caller must pass in a system CRED.End of change
  4. An audit record is optionally written, depending on the audit options in effect for the system.