Controlling the selectively setting of operational parameters for an adapter

• US 9,383,931 B2
• Filed: 05/02/2012
• Issued: 07/05/2016
• Est. Priority Date: 06/23/2010
• Status: Active Grant

• Current Assignee: International Business Machines Corporation
• Original Assignee: International Business Machines Corporation
• Inventors: Craddock, David, Farrell, Mark S., Glendening, Beth A., Gregg, Thomas A., Greiner, Dan F., Sittmann, Gustav E. III, Szwed, Peter K.
• Primary Examiner(s): Partridge, William B
• Application Number:
  US13/461,930
• Publication Number:
  US 20120216022A1
• Time in Patent Office: 1,525 Days
• Field of Search: None
• US Class Current: 1/1
• CPC Class Codes: G06F 21/6218 to a system of files or objects, e.g. local or distributed file system or database
• CPC Class Codes: G06F 21/71 to assure secure computing or processing of information
• CPC Class Codes: G06F 21/85 interconnection devices, e.g. bus-connected or in-line devices
• CPC Class Codes: G06F 2221/2101 Auditing as a secondary aspect
• CPC Class Codes: G06F 2221/2105 Dual mode as a secondary aspect
• CPC Class Codes: G06F 2221/2141 Access rights, e.g. capability lists, access control lists, access tables, access matrices
• CPC Class Codes: G06F 3/0619 in relation to data integrity, e.g. data losses, bit errors
• CPC Class Codes: G06F 3/065 Replication mechanisms
• CPC Class Codes: G06F 3/067 Distributed or networked storage systems, e.g. storage area networks [SAN], network attached storage [NAS]
• CPC Class Codes: G06F 9/30003 Arrangements for executing specific machine instructions
• CPC Class Codes: G06F 9/4411 Configuring for operating with peripheral devices; Loading of device drivers

Abstract

An instruction is provided to establish various operational parameters for an adapter. These parameters include adapter interruption parameters, input/output address translation parameters, resetting error indications, setting measurement parameters, and setting an interception control, as examples. The instruction specifies a function information block, which is a program representation of a device table entry used by the adapter, to be used in certain situations in establishing the parameters. A store instruction is also provided that stores the current contents of the function information block.

Claims

1. A method of executing a machine instruction in a central processing unit, the 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.

2. The method 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 method of claim 1, 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 method of claim 3, wherein both the device table entry and the another entry are updated.

5. The method 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 method 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 method 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 method 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 method 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 method 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 method 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 method 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. The method 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.