This data structure is defined in the DASD.H header file and is used with these APIs:

• NetDASDAdd
  
• NetDASDEnum
  
• NetDASDGetInfo
  
• NetDASDSetInfo

struct dasd_info_0 {       unsigned char LSFAR * LSPTR    d0_resource_name;
       unsigned long                  d0_max;
       unsigned long                  d0_use;
       unsigned char                  d0_flag;
       unsigned char                  d0_thresh;
       unsigned char                  d0_delta;
};

• d0_resource_name points to the name of the directory upon which the API is to act. The directory name is specified as a standard OS/2 directory path, beginning with the drive letter and ending without the backslash (\). For the NetDASDAdd and NetDASDSet APIs, the path specified by this d0_resource_name field can be on a redirected drive. If so, the pszServername parameter submitted with the NetDASDAdd or NetDASDSet call must be NULL.

• The d0_max field contains the amount of disk space allotted to this directory by directory limits. Specified in KB, this field can be set from 1 to 67108863. Note however, that subsequent access to this directory is functionally limited to the smaller of the following:

  • Any directory limits restrictions on any parent directory
    
  • The total free space on the drive
  If the NetDASDGetInfo API returns a value of 0 to the d0_max field in this data structure, the specified directory (and any parent directory) does not have directory limits set.

d0_use is the amount (in KB) of disk space already occupied within the specified directory resource. This field is ignored for ADD or SET operations.

The d0_flag field can take one of the following values:

• DASD_VALIDATE_LIMIT_ON, which compares a newly specified limit (d0_max field) to the amount of disk space already taken by the directory. If the directory tree size exceeds the new limit, NERR_MaxValidationFailed is returned.

• DASD_VALIDATE_LIMIT_OFF, which sets the new limit regardless of the present size of the directory tree.

d0_thresh specifies the initial alert threshold as a percentage of the total directory limit space allotted, with values ranging from 0 to 99. Zero specifies that no threshold alert is to be generated, and 99 specifies that an alert is generated when 99% of the allotted directory limit for this directory has been reached. Note that a minimum of 1KB of disk space must be allotted to a threshold; the value obtained by multiplying the d0_thresh decimal-point value (where 5% = 0.05) by d0_max must be at least 1KB.

This threshold setting generates only 1 alert when this boundary is crossed. Subsequent alerts (generated incrementally after this threshold has been reached but before the entire limit is reached) are specified according to the next field, d0_delta.


d0_delta specifies the increment in which alerts are to be generated after the d0_thresh threshold has been crossed but before all of the allotted disk space has been used. This field also is specified as a percentage of the total allotted directory limit space and can range from 0 upward, as long as its value is less than 99 - d0_thresh. Note that a minimum of 1KB of disk space must be allotted to an increment; the value obtained by multiplying the d0_delta decimal-point value (where 5% = 0.05) by d0_max must be at least 1KB.

---

[Back] [Next]