DIAGNOSE Code X'26C' – Access Certain System Information

Privilege Class: B, E; Subcode X'00000024' and Subcode X'00000030' - G

Addressing Mode: 24-bit or 31-bit

Use DIAGNOSE code X'26C' to access certain system information.

Entry Values:
Rx
Contents depend on the value of subcode. Rx must be an even-numbered register and cannot be the same as Ry.
Rx+1
Contains the address of an output buffer on a doubleword boundary.
Ax
Is used only for XC virtual machines in access-register mode, in which case it contains the ALET for the address space containing the doubleword passed as input. If Rx designates general register 0, if Ax contains X'00000000', or if the virtual machine is not in XC mode, the input doubleword is in the host-primary address space.
Ry
The second data register contains the function subcode. Ry must be an even-numbered register and cannot be the same as Rx.
  • Subcode X'00000004' Return the BYUSER ID for a given user ID.
  • Subcode X'00000008' Return virtual LAN system information.
  • Subcode X'0000000C' Return controller list.
  • Subcode X'00000010' Return controller information.
  • Subcode X'00000014' Return guest LAN list.
  • Subcode X'00000018' Return guest LAN information.
  • Subcode X'0000001C' Return virtual switch list.
  • Subcode X'00000020' Return virtual switch information.
  • Subcode X'00000024' Return virtual port, virtual NIC or HiperSockets logical port information.
  • Subcode X'00000030' MAC Services.
Ax+1
Is used only by XC virtual machines in access-register mode. Ax+1 contains the ALET for the address space containing the output doubleword. If an XC-mode virtual machine is not in access register mode, or if the virtual machine is not in XC mode, Ax+1 is ignored.
Exit Values:
Ry+1
Contains a return code value. Meaning is determined by subcode.

Common Usage Notes:

  1. Rx and Ry cannot be the same register.
  2. Rx and Ry must be even-numbered registers.
  3. Many subcodes use version as input parameter. Version indicates the desired format of the information in the output buffer. Note that the version defines the length of the output data, not the content of reserved fields. For example, reserved fields in version N may actually contain some content defined for level N+1.

    Use CSI66219 to provide information in the format described below.

    Valid versions are defined by HCPCSIBK COPY and include:

    Table 1. Version definitions. This describes the versions that may be specified on subcodes that accept a version indicator on input.
    Value HCPCSIBK equate Description
    0000 0001 CSICPVER z/VM® 5.3.0, no service
    0000 0001 CSIVERS1 z/VM 5.3.0, no service
    0001 0001 CSI64281 z/VM 5.3.0, with APAR VM64281
    0002 0001 CSI64277 z/VM 5.3.0, with APAR VM64277
    0000 0002 CSIVERS2 z/VM 5.4.0, no service
    0000 0003 CSIVERS3 z/VM 6.1.0, no service
    0001 0003 CSI64780 z/VM 6.1.0, with APAR VM64780
    0000 0004 CSIVERS4 z/VM 6.2.0, no service
    0001 0004 CSI65042 z/VM 6.2.0, with APAR VM65042
    0000 0005 CSIVERS5 z/VM 6.3.0, no service
    0001 0005 CSI65583 z/VM 6.3.0, with APAR VM65583
    0000 0006 CSIVERS6 z/VM 6.4.0 no service
    0001 0006 CSI65925 z/VM 6.4.0 with APAR VM65925
    0002 0006 CSI65918 z/VM 6.4.0 with APAR VM65918
    0000 0007 CSIVERS7 z/VM 7.1.0, no service
    0001 0007 CSI66219 z/VM 7.1.0 with APAR VM66219

    Programs written to use HCPCSIBK COPY on one release of z/VM can be executed on a new release of z/VM without change. To exploit the function provided by a follow-on release, examine your program for necessary changes and use the new value for version.

    An error is returned if the version supplied is not supported by the current level of CP.