DMSQUSGD - Query User Storage Group - Deblocker
Context
File Pool Administration
Call Format
The format for calling a CSL routine is language dependent. DMSQUSGD is called only through DMSCSL. The routine name is the first parameter in DMSCSL’s parameter list:
- DMSQUSGD
- (input, CHAR, 8) can be passed as a literal or in a variable.
For more information and examples of the call formats, see Calling VMLIB CSL Routines.
Purpose
Use the DMSQUSGD routine to obtain specific information about user storage groups in a file pool from the array of information returned by the DMSQUSG (Query User Storage Group) routine. You must have file pool administration authority to use this routine.
Parameters
- retcode
- (output, INT, 4) is a variable for the return code from DMSQUSGD.
- reascode
- (output, INT, 4) is a variable for the reason code from DMSQUSGD.
- buffer
- (input, CHAR, length) is the buffer in which the information was returned from DMSQUSG. It must be the same length as the buffer returned from DMSQUSG.
- length
- (input, INT, 4) is a signed integer variable containing the length of the preceding character parameter buffer. It must have the same value as the length used in DMSQUSG.
- array_element
- (input, INT, 4) specifies which element in the array from the buffer is to be deblocked. Specify 1 for the first element.
- num_recs
- (output, INT, 4) returns the number of elements in the array.
- num_user_storage_groups
- (output, INT, 4) returns the number of user storage groups about which information was requested. If storage_group on the original DMSQUSG request was a storage group number, then num_user_storage_groups is 1. If storage_group was 0, then the number of user storage groups in the file pool is returned.
- storage_group
- (output, INT, 2) is a variable containing the number of the storage group.
- groupthresh
- (output, INT, 2) is a variable containing the GROUPTHRESH value. (This is a SFS start-up parameter and is the same for all storage groups.)
- total_blocks
- (output, INT, 4) is a variable in which the total number of 4K blocks in the storage group is returned.
- blks_free
- (output, INT, 4) is a variable in which the number of 4K blocks free in the storage group is returned.
Usage Notes
- If the value in num_user_storage_groups is greater than num_recs, then the buffer was not large enough to hold all the information returned by DMSQUSG.
- If the value in array_element is greater than num_recs, then the array element number is considered invalid and an error reason code is returned.
- If no errors occur, the deblocked information is returned in the appropriate parameters.
Return Codes and Reason Codes
For lists of the possible return codes from DMSQUSGD, see Return Codes.
The following table lists the special reason code returned by DMSQUSGD. ERROR means the request failed, or the request was unsuccessful. Errors cause return code 8 or 12.
DMSQUSGD can also return the common CSL reason codes, which are codes that can occur with most file system management and related routines. For a list of the common reason codes, see Common Reason Codes.
Severity | Reason Code | Description |
---|---|---|
ERROR | 90217 | The requested element is less than or equal to zero, or the requested element is greater than the number of records being returned in the buffer. |