DMSSPCQ - Query Address Space
Call Format
The format for calling a CSL routine is language dependent. DMSSPCQ is called only through DMSCSL. The routine name is the first parameter in DMSCSL’s parameter list:
- DMSSPCQ
- (input, CHAR, 8) can be passed as a literal or in a variable.
DMSSPCQ
must be padded with blanks to eight characters.
For more information and examples of the call formats, see Calling VMLIB CSL Routines.
Purpose
Use the DMSSPCQ routine to query information about an address space that your virtual machine owns or is authorized to access.
For information on using address space and access list services provided in CMS, see the z/VM: CMS Application Development Guide.
Parameters
Note: See Syntax Conventions for CSL Routines.
- retcode
- (output, INT, 4) is a variable for the return code from DMSSPCQ.
- reascode
- (output, INT, 4) is a variable for the reason code from DMSSPCQ.
- name
- (input, CHAR, 24) is a variable used for specifying the name of the address space for which information is to be extracted by this call. The name is a string of 1 to 24 characters. Only uppercase letters (A through Z), numbers (0 through 9), and certain special characters (# $ @ _ -) are allowed. If the name contains incorrect characters, the query is not performed. The name must be padded on the right with blanks if it is not 24 characters long.
- owner
- (input, CHAR, 8) is a variable used for specifying the user ID of the virtual machine that owns the address space for which information is being requested. Specifying an asterisk (*) indicates that the virtual machine from which this routine is being called owns the address space for which information is being requested. If the value specified for this parameter is less than 8 characters long, you must pad it on the right with blanks.
- blocks
- (output, INT, 4) is a variable used for returning the number of 4096-byte blocks in the address space queried.
- asit
- (output, CHAR, 8) is a variable used for returning the address space identification token (ASIT), the unique system-wide identifier for the address space being queried.
Usage Notes
- Your application can call DMSSPCQ to obtain the address space identification token (ASIT) of its own primary address space for the purpose of permitting other users to access it, or for releasing pages within the primary address space. Specify BASE for the name parameter to obtain the ASIT of your own virtual machine's primary address space.
- If you specify a user ID (to obtain information about another user's address space), the address space owner must have previously specified your user ID on a call to the Permit (DMSSPCP) CSL routine.
- For detailed information on the query function, see the ADRSPACE QUERY macro description in z/VM: CP Programming Services.
Return Codes and Reason Codes
For lists of the possible return codes from DMSSPCQ, see Return Codes.
The following table lists the reason codes returned by DMSSPCQ. ERROR indicates that the request failed. Errors cause return code 8 or 12.
Severity | Reason Code | Description |
---|---|---|
ERROR | 85004 | You do not own or have access to the address. No information was returned. |
ERROR | 85016 | The specified address space name contains incorrect characters. No information was returned. |
ERROR | 85100 | This support is not provided by the processor on which VM is running. |
ERROR | 96100 | Insufficient CMS virtual storage was available to perform the service. |