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:
- Rx and Ry cannot be the same register.
- Rx and Ry must be even-numbered registers.
- 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.