AUTH

Specify the directory name, file mode, or namedef and AUTH. The file name and file type (or namedef) parameter is optional. When you use AUTH, later DMSGETDI calls only returns information about authorizations that the issuer has and those that the issuer has granted.

You must have read authority on the file name specified. If special characters (* and %) are specified to designate a set of files, you must have read authority on the directory.

Information returned in later DMSGETDI and DMSGETDT calls consists of:
  • File identifier (can be a file name and file type or a subdirectory)
  • File mode number
  • Type (base, alias, erased, revoked, or directory)
  • Read authority
  • Write authority
  • External protection
  • User ID of the owner
  • Directory attribute.
  • Migration indicator.

DMSGETDI also returns the type of open (has a value of 5 for AUTH).