DMSQSFSL - Query File Pool Server Level

Read syntax diagramSkip visual syntax diagram DMSQSFSL , retcode , reascode , filepoolid , length1 , server_level ,wuerror,length2

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.