DMSQSFSL - Query File Pool Server Level
Context
File Pool Administration
Call Format
The format for invoking a CSL routine is language dependent. This CSL routine can be called only called indirectly, through DMSCSL. The routine name is the first parameter in DMSCSL’s parameter list:
- DMSQSFSL
- (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 DMSQSFSL routine to identify the functional level of the file pool server machine.
Parameters
- retcode
- (output, INT, 4) is the return code from DMSQSFSL.
- reascode
- (output, INT, 4) is the reason code from DMSQSFSL.
- filepoolid
- (input, CHAR, 1-8) is a variable containing the name of the file pool, without the colon.
- length1
- (input, INT, 4) is the length of the filepoolid parameter.
- server_level
- (output,INT,4) is a unique code for the functional level of CMS in which the file pool server is
running:
Table 1. CMS Level Codes Code Level Introduced 4 6 VM/SP Release 6 8 7 VM/ESA Version 1 Release 1.0 12 8 VM/ESA Version 1 Release 1.1 16 9 VM/ESA Version 1 Release 2.0 20 10 VM/ESA Version 1 Release 2.1 24 11 VM/ESA Version 1 Release 2.2 28 12 VM/ESA Version 2 Release 1.0 32 13 VM/ESA Version 2 Release 2.0 36 14 VM/ESA Version 2 Release 3.0 40 15 VM/ESA Version 2 Release 4.0 44 16 z/VM® Version 3 Release 1.0 48 17 z/VM Version 4 Release 1.0 52 18 z/VM Version 4 Release 2.0 56 19 z/VM Version 4 Release 3.0 60 20 z/VM Version 4 Release 4.0 64 21 z/VM Version 5 Release 1.0 68 22 z/VM Version 5 Release 2.0 72 23 z/VM Version 5 Release 3.0 76 24 z/VM Version 5 Release 4.0 80 25 z/VM Version 6 Release 1.0 84 26 z/VM Version 6 Release 2.0 88 27 z/VM Version 6 Release 3.0 92 28 z/VM Version 6 Release 4.0 96 29 z/VM Version 7 Release 1.0 100 30 z/VM Version 7 Release 2.0 - wuerror
- (output, CHAR, length2) is an area for returning extended error information. If it is specified, it must be followed by a length field. See wuerror under Common Parameters for more information.
- length2
- (input, INT, 4) is the length of the preceding character parameter (wuerror). Specifying 0 has the effect of omitting the wuerror parameter. To use the wuerror parameter, specify a length of 12 plus 136 bytes for each group of extended error information that may be passed back. Specifying a nonzero length less than 12 is incorrect and will result in an error return code.
Return Codes and Reason Codes
For lists of the possible return codes from DMSQSFSL, see Return Codes.
The following table lists the special reason codes returned by DMSQSFSL. ERROR means the request failed. Errors cause return code 8 or 12.
DMSQSFSL 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 | 57000 | The storage group to which this user belongs is being restored. |
ERROR | 86400 | File pool server level information could not be determined, possibly because of corrupted storage. |
ERROR | 90210 | Extraneous characters in file pool ID. |
ERROR | 90415 | Incorrect length specified for the wuerror parameter. A nonzero length must be at least 12 bytes. |
ERROR | 90476 | Incorrect file pool ID specified. |