DMSSPCQ - Query Address Space

Read syntax diagramSkip visual syntax diagram DMSSPCQ , retcode , reascode , name , owner , blocks , asit

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

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

  1. 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.
  2. 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.
  3. 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.