Usage Notes

  1. For a discussion of how z/VM® processes addresses, see How Addresses Are Processed.
  2. Execution of the DIAGNOSE code X'00' instruction makes a copy of the information shown in Table 1 available to your virtual machine at the location specified by Rx (and in Ax if your virtual machine is an XC virtual machine in access-register mode).

    Please note that the service level reported assumes that all service has been applied for this level. If the service updates have been applied selectively, then the service level reported may be incorrect.

    Table 1. DIAGNOSE code X'00' — Bit Map Fields
    Field Characteristics Description
    Reserved (formerly System name) 8 bytes, EBCDIC Contains the constant ‘VM/ESA’ (for compatibility with the prior product name)
    Environment 2 bytes, binary Identifies the z/VM execution environment. See 2.a for more information.
    Version Information 1 byte, hexadecimal The version number of the product identified in the System Name field. It is an unsigned binary number. See usage note 5.
    Version code 1 byte, hexadecimal Bits 0-7 of the host system's CPUID. This field will always be 00 when the z/VM host system is running in a logical partition. This field will always be FF when the z/VM host system is running on z/VM.
    reserved 2 bytes, hexadecimal z/VM stores zeros in this field.
    Processor address 2 bytes, hexadecimal The address of the processor on which z/VM is currently running
    User ID 8 bytes, EBCDIC The user ID of the virtual machine issuing the DIAGNOSE
    Licensed program bit map 8 bytes, hexadecimal The level of CP that is installed. See 2.b for the bit settings.
    Time zone differential 4 bytes, hexadecimal Represents the time zone differential in seconds from Coordinated Universal Time (UTC) (see note 2.c below).
    Release Information 4 bytes, hexadecimal The first byte is the release number, the second byte is the release modification level, and the third and fourth bytes are the service level. All three subfields are unsigned binary numbers.
    Notes:
    1. The z/VM execution environment bits contain:
      • When bit 0 = 1, CP is running in a logical partition (LPAR mode). Bit 0 will always have a value of 1 because the machines supported by z/VM V6.1 and later provide only LPAR mode.
      • When bit 1 = 1, CP is running in 64-bit mode. Bit 1 will always have a value of 1 because the DIAGNOSE code X'00' instruction can be issued only when CP runs in 64-bit mode.
      • Bits 2 to 15 are reserved and are currently zeros.
    2. The bit map contains:
      X'0000000000000000'
      for VM/XA SF 1
      X'4000000000000000'
      for VM/XA SF 2
      X'6000000000000000'
      for VM/XA SP™ 1
      X'7000000000000000'
      for VM/XA SP 2
      X'7800000000000000'
      for VM/XA SP 2 with APSS
      X'7C00000000000000'
      for VM/XA SP 2.1
      X'7E00000000000000'
      for VM/XA SP 2.1 spool file origin enhancements
      X'7F00000000000000'
      for VM/ESA Version 1 Release 1.0 ESA Feature
      X'7F80000000000000'
      for VM/ESA Version 1 Release 1.1
      X'7FC0000000000000'
      for VM/ESA Version 1 Release 2.0
      X'7FE0000000000000'
      for VM/ESA Version 1 Release 2.1
      X'7FF0000000000000'
      for VM/ESA Version 1 Release 2.2
      X'7FF8000000000000'
      for VM/ESA Version 2 Release 1.0
      X'7FFE000000000000'
      for VM/ESA Version 2 Release 2.0
      X'7FFF000000000000'
      for VM/ESA Version 2 Release 3.0
      X'7FFF800000000000'
      for VM/ESA Version 2 Release 4.0
      X'7FFFC00000000000'
      for z/VM Version 3 Release 1.0
      X'7FFFE00000000000'
      for z/VM Version 4 Release 1.0
      X'7FFFF00000000000'
      for z/VM Version 4 Release 2.0
      X'7FFFF80000000000'
      for z/VM Version 4 Release 3.0
      X'7FFFFC0000000000'
      for z/VM Version 4 Release 4.0
      X'7FFFFE0000000000'
      for z/VM Version 5 Release 1.0
      X'7FFFFF0000000000'
      for z/VM Version 5 Release 2.0
      X'7FFFFF8000000000'
      for z/VM Version 5 Release 3.0
      X'7FFFFFC000000000'
      for z/VM Version 5 Release 4.0
      X'7FFFFFE000000000'
      for z/VM Version 6 Release 1.0
      X'7FFFFFF000000000'
      for z/VM Version 6 Release 2.0
      X'7FFFFFF800000000'
      for z/VM Version 6 Release 3.0
      X'7FFFFFFC00000000'
      for z/VM Version 6 Release 4.0
      X'7FFFFFFE00000000'
      for z/VM Version 7 Release 1.0
      X'7FFFFFFF00000000'
      for z/VM Version 7 Release 2.0
      X'7FFFFFFF80000000'
      for z/VM Version 7 Release 3.0
      Start of changeX'7FFFFFFFC0000000'End of change
      Start of changefor z/VM Version 7 Release 4.0End of change

      Bit 13 (X'0004000000000000') indicates whether Year 2000 support is present in CP.

      To determine what VM environment you are in and what CP resources are available to you, use the high-order bit from this bit map. Specifically, if the high-order bit is on, the environment is VM/SP, VM/SP HPO, or VM/ESA® (370 Feature). If the high-order bit is off, the environment is VM/XA SP, VM/ESA (ESA Feature), or z/VM. Do not try to get this information from the first five bytes returned by DIAGNOSE code X'00'.

    3. The time zone differential is a signed hexadecimal fullword value in seconds. Negative values represent differentials west of Coordinated Universal Time (UTC), and positive values represent differentials east of Coordinated Universal Time.
  3. If z/VM is executing in a virtual machine, up to 40 bytes of extended identification data is appended to the first 40 bytes described above. Up to five nested levels of z/VM virtual machines are supported by this DIAGNOSE instruction. Thus, a maximum of 200 bytes of data can be returned to the virtual machine that initially issued the DIAGNOSE instruction.
  4. The CP level does not indicate the release of CMS. To determine the release of CMS, use the Query Functional Level of CP and CMS routine (DMSQEFL), which is described in z/VM: CMS Callable Services Reference. DMSQEFL also returns the release of CP.
  5. In VM/ESA Version 2 Release 1.0, the Version Information byte was created from the third byte of the Environment field. Because VM releases prior to VM/ESA Version 2 Release 1.0 are not being updated by APAR, the Version Information for all of these releases is X'00'. For VM/ESA Version 2 Release 1.0 and later, the Version Information will reflect the true version number. For example, the Version Information for VM/ESA Version 2 Release 1.0 is X'02'.
  6. When part of an SSI cluster, the diagnose x'00' output depends on the relocation domain to which the issuing user is assigned. This output shows the virtual CP level that is being presented to the issuer of the diagnose. Virtual CP levels may differ among users on the same system when they belong to different relocation domains. See the explanation of relocation domains in z/VM: CP Planning and Administration for more details. Also see the documentation of the CP SET VMRELOCATE and CP QUERY VMRELOCATE commands and the VMRELOCATE directory statement for details about how a user is assigned to a relocation domain.