Controlling the Selectively Setting of Operational Parameters for an Adapter

1. A computer program product for executing a machine instruction in a central processing unit, the computer program product comprising: a non-transitory computer readable storage medium readable by a processing circuit and storing instructions for execution by the processing circuit for performing a method comprising: obtaining a machine instruction for execution, the machine instruction being defined for computer execution according to a computer architecture, the machine instruction comprising: an opcode field identifying a modify function controls adapter instruction, the modify function controls adapter instruction configured to establish operational parameters for an adapter function, the operational parameters to be set for a particular operation to be performed for or on behalf of the adapter function, the particular operation to be selected from a plurality of operations the modify function controls adapter instruction is configured to perform, and wherein the particular operation to be performed in a particular execution of the modify function controls adapter instruction is specified in an operation control provided by a first field of the modify function controls adapter instruction, the first field being separate from the opcode field; the first field identifying a location, the contents of which include a function handle identifying a handle of the adapter function, a designation of an address space associated with the adapter function to which the particular operation applies, and the operation control specifying the particular operation to be performed for the adapter function, the operation control specifying one operation of the plurality of operations that can be selected; and a second field for identifying an address of a function information block to be used by the modify function controls adapter instruction; and executing the machine instruction, the executing comprising: determining a value of the operation control; and modifying, based on the operation control, a selected table entry that includes parameters associated with the adapter function, wherein the modifying comprises selectively updating one or more parameters of the selected table entry based on the value of the operation control and based on one or more checks that depend on the value of the operation control.

2. The computer program product of claim 1 , wherein the instruction is issued by an operating system, and wherein the modifying comprises using information in the function information block to modify the one or more parameters, the function information block fetched from memory accessible to the operating system.

3. The computer program product of claim 2 , wherein the table entry comprises a device table entry located in a hub coupled to the adapter function and the processor or another entry associated with the adapter function.

4. The computer program product of claim 3 , wherein both the device table entry and the another entry are updated.

5. The computer program product of claim 2 , wherein the operation control comprises registering adapter interruptions for the adapter function, and wherein the modifying comprises modifying one or more parameters specific to adapter interruptions, said one or more parameters comprising an address of an adapter function interruption vector for the adapter, an offset within the adapter function interruption vector, an address of an adapter interruption summary vector, an offset within the adapter interruption summary vector, a summary notification control and a number of interruptions supported by the adapter function.

6. The computer program product of claim 2 , wherein the operation control comprises registering input/output address translation parameters, and wherein the modifying comprises modifying one or more parameters specific to address translation, said one or more parameters including a base address of the address space, a limit of the address space, a translation pointer that indicates a highest level address translation table to be used, a size of a unit of memory and an address translation format.

7. The computer program product of claim 2 , wherein the operation comprises a reregister of address translation parameters, and wherein the modifying comprises modifying one or more parameters specific to reregistering address translation, the one or more parameters including a limit of the address space and an address translation pointer that indicates a highest level address translation table to be used, and wherein the modifying uses the one or more controls to indicate a particular ordering of updates related to reregistering the address translation parameters.

8. The computer program product of claim 7 , wherein another address translation parameter comprises a base address of the address space, and wherein based on a request to modify the base address, the one or more controls are used to prevent the base address from being updated.

9. The computer program product of claim 2 , wherein the operation control comprises setting adapter function measurement parameters, and wherein the modifying comprises modifying one or more parameters specific to adapter function measurement, the one or more parameters comprising a sample count, one or more instruction counts, and one or more direct memory access counts.

10. The computer program product of claim 1 , wherein the operation control comprises a reset error state indication, and wherein the modifying comprises resetting one or more status indicators in the table entry.

11. The computer program product of claim 1 , wherein the operation control comprises an unregistering of adapter function interruption, and wherein the modifying comprises resetting one or more parameters specific to adapter function interruptions, the one or more parameters including an address of an adapter interruption vector for the adapter function, an offset within the adapter interruption vector, an address of an adapter summary vector, an offset within the adapter interruption summary vector, a summary notification control, and a number of interruptions supported by the adapter function.

12. The computer program product of claim 1 , wherein the operation control comprises an unregistering of input/output address translation, and wherein the modifying comprises resetting one or more parameters specific to address translation, the one or more parameters including a base address of the address space, a limit of the address space, an address translation pointer that indicates a highest level address translation table to be use, a size of a unit of memory and an address translation format.

13. A computer system for executing a machine instruction in a central processing unit, the computer system comprising: a memory; and a processor in communications with the memory, wherein the computer system is configured to perform a method, said method comprising: obtaining, by a processor, a machine instruction for execution, the machine instruction being defined for computer execution according to a computer architecture, the machine instruction comprising: an opcode field identifying a modify function controls adapter instruction, the modify function controls adapter instruction configured to establish operational parameters for an adapter function, the operational parameters to be set for a particular operation to be performed for or on behalf of the adapter function, the particular operation to be selected from a plurality of operations the modify function controls adapter instruction is configured to perform, and wherein the particular operation to be performed in a particular execution of the modify function controls adapter instruction is specified in an operation control provided by a first field of the modify function controls adapter instruction, the first field being separate from the opcode field; the first field identifying a location, the contents of which include a function handle identifying a handle of the adapter function, a designation of an address space associated with the adapter function to which the particular operation applies, and the operation control specifying the particular operation to be performed for the adapter function, the operation control specifying one operation of the plurality of operations that can be selected; and a second field for identifying an address of a function information block to be used by the modify function controls adapter instruction; and executing the machine instruction, the executing comprising: determining a value of the operation control; and modifying, based on the operation control, a selected table entry that includes parameters associated with the adapter function, wherein the modifying comprises selectively updating one or more parameters of the selected table entry based on the value of the operation control and based on one or more checks that depend on the value of the operation control.

14. The computer system of claim 13 , wherein the instruction is issued by an operating system, and wherein the modifying comprises using information in the function information block to modify the one or more parameters, the function information block fetched from memory accessible to the operating system.

15. The computer system of claim 14 , wherein the table entry comprises a device table entry located in a hub coupled to the adapter function and the processor or another entry associated with the adapter function.

16. The computer system of claim 14 , wherein the operation control comprises registering adapter interruptions for the adapter function, and wherein the modifying comprises modifying one or more parameters specific to adapter interruptions, said one or more parameters comprising an address of an adapter function interruption vector for the adapter, an offset within the adapter interruption vector, an address of an adapter function interruption summary vector, an offset within the adapter interruption summary vector, a summary notification control and a number of interruptions supported by the adapter function.

17. The computer system of claim 14 , wherein the operation control comprises registering input/output address translation parameters, and wherein the modifying comprises modifying one or more parameters specific to address translation, said one or more parameters including a base address of the address space, a limit of the address space, a translation pointer that indicates a highest level address translation table to be used, a size of a unit of memory and an address translation format.

18. The computer system of claim 14 , wherein the operation control comprises setting adapter function measurement parameters, and wherein the modifying comprises modifying one or more parameters specific to adapter measurement, the one or more parameters comprising a sample count, one or more instruction counts, and one or more direct memory access counts.

19. The computer system of claim 14 , wherein the operation comprises a reregister of address translation parameters, and wherein the modifying comprises modifying one or more parameters specific to reregistering address translation, including the one or more parameters, a limit of the address space and an address translation pointer that indicates a highest level address translation table to be used, and wherein the modifying uses the one or more controls to indicate a particular ordering of updates related to reregistering the address translation parameters.

20. The computer program product of claim 1 , wherein the operation control is configured to indicate a registering adapter interruptions for the adapter function, registering input/output address translation parameters to be used by a hub coupled to the adapter function, a reregister of address translation parameters, setting adapter function measurement parameters, a reset error state indication, unregistering of adapter interruption, and unregistering of input/output address translation parameters to be used by the hub.

21. The computer system of claim 13 , wherein the operation control is configured to indicate a registering adapter interruptions for the adapter function, registering input/output address translation parameters to be used by a hub coupled to the adapter function, a reregister of address translation parameters, setting adapter function measurement parameters, a reset error state indication, unregistering of adapter interruption, and unregistering of input/output address translation parameters to be used by the hub.