Function

fchaudit invokes the fchaudit callable service to change audit flags for a file identified by a file descriptor. The file descriptor is specified by a number.

Parameters

fd

The file descriptor for the file.

audit_flags

One or more numeric values that indicate the type of access to be tested. You can specify a numeric value (see REXX predefined variables) or the predefined variable used to derive the appropriate numeric value. The predefined variables you can specify are:

Variable	Description
AUD_FREAD	Audit failed read requests
AUD_SREAD	Audit successful read requests
AUD_FWRITE	Audit failed write requests
AUD_SWRITE	Audit successful write requests
AUD_FEXEC	Audit failed execute or search requests
AUD_SEXEC	Audit successful execute or search requests

option

A number indicating whether user-requested or auditor-requested auditing is being changed:

• 0 if user-requested auditing is being changed.
• 1 if auditor-requested auditing is being changed.

Usage notes

1. If option indicates that the auditor audit flags are to be changed, you must have auditor authority for the request to be successful. If you have auditor authority, you can set the auditor options for any file, even those to which you do not have path access or authority to use for other purposes.

   You can get auditor authority by entering the TSO/E command ALTUSER AUDITOR.

2. If option indicates that the user audit flags are to be changed, you must have appropriate privileges or be the owner of the file.