Managing operator message buffers in a coupling facility

• US 8,560,737 B2
• Filed: 06/10/2011
• Issued: 10/15/2013
• Est. Priority Date: 06/10/2011
• Status: Expired due to Fees

• Current Assignee: International Business Machines Corporation
• Original Assignee: International Business Machines Corporation
• Inventors: Elko, David A., Goss, Steven N., Shaw, Thomas C.
• Primary Examiner(s): Alrobaye, Idriss N
• Assistant Examiner(s): Huson, Zachary K
• Application Number:
  US13/157,918
• Publication Number:
  US 20120317312A1
• Time in Patent Office: 858 Days
• Field of Search: 710/5, 710/52
• US Class Current: 710/5
• CPC Class Codes: G06F 13/102 where the programme performs an interfacing function, e.g. device driver G06F13/105 takes precedence; scheduling within device drivers G06F9/52; contention policies within device drivers G06F9/4881
• CPC Class Codes: G06F 2213/0058 Bus-related hardware virtualisation
• CPC Class Codes: G06F 9/544 Buffers; Shared memory; Pipes
• CPC Class Codes: G06F 9/546 Message passing systems or structures, e.g. queues

Abstract

A facility is provided to enable operator message commands from multiple, distinct sources to be provided to a coupling facility of a computing environment for processing. These commands are used, for instance, to perform actions on the coupling facility, and may be received from consoles coupled to the coupling facility, as well as logical partitions or other systems coupled thereto. Responsive to performing the commands, responses are returned to the initiators of the commands.

Claims

1. A computer program product for managing buffers of a computing environment, said 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;

setting, by a coupling facility of the computing environment, one or more buffers of the coupling facility to either an active state or an idle state, the setting comprising;

based on obtaining an operator message command in which a buffer of the coupling facility is to be set to the active state, setting a selected buffer of the coupling facility to the active state, the setting comprising storing an operator message token value of the operator message command in the selected buffer, and setting a state of the selected buffer to active, the operator message command obtained by the coupling facility from a processor image coupled to, but separate from the coupling facility, the operator message command to perform an action on the coupling facility;

determining that the selected buffer is to be reset, the selected buffer including information relating to processing the operator message command sent remotely to the coupling facility from the processor image coupled to, but separate from, the coupling facility, the selected buffer including a token field having the operator message token value relating the selected buffer to operator messages having operator message (OM) tokens having the same operator message token value; and

based on determining the selected buffer is to be reset, resetting the selected buffer, the resetting comprising setting the selected buffer to an idle state and setting one or more fields of a plurality of fields of the selected buffer to one or more predefined values, the plurality of fields including a timer to indicate a length of time an operator message has been active for the selected buffer, an operator message request length, and an operator message response length.

2. The computer program product of claim 1, wherein the determining is based on an explicit operator message command received by the coupling facility, the explicit operator message command having a token for selecting a buffer having a token field value matching the token.

3. The computer program product of claim 2, wherein the explicit operator message command comprises a delete operator message command.

4. The computer program product of claim 2, wherein the explicit operator message command comprises a start operator message command.

5. The computer program product of claim 4, wherein the determining comprises determining, based on processing the start operator message command, that the buffer is active and has timed out.

6. The computer program product of claim 1, wherein the determining is based implicitly on a defined criterion considered by the coupling facility.

7. The computer program product of claim 6, wherein the defined criterion includes determining that the buffer is active with a pending response and a timeout value associated with the buffer has exceeded a predetermined time value.

8. The computer program product of claim 1, wherein the resetting comprises processing a delete operator message command, the delete operator message command comprising a message command block including a message header, a command indicating the delete operator message command, and the operator message token.

9. The computer program product of claim 8, wherein the processing comprises:

determining that the operator message token in the buffer matches the operator message token in the delete operator message command;

based on the determining indicating the operator message token in the buffer matches the operator message token in the delete operator message command, checking whether an operator message response is pending;

based on the determining indicating the operator message response is pending, setting one or more fields of the buffer to one or more predefined values and setting a state of the buffer to idle; and

providing a message response block indicating that an operator message is deleted.

10. The computer program product of claim 9, wherein the method further comprises setting the operator message token to zero.

11. The computer program product of claim 1, wherein the coupling facility comprises a plurality of buffers, and wherein the method includes choosing the selected buffer from the plurality of buffers.

12. A computer system for managing buffers of a computing environment, said 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;

setting, by a coupling facility of the computing environment, one or more buffers of the coupling facility to either an active state or an idle state, the setting comprising;

based on obtaining an operator message command in which a buffer of the coupling facility is to be set to the active state, setting a selected buffer of the coupling facility to the active state, the setting comprising storing an operator message token value of the operator message command in the selected buffer, and setting a state of the selected buffer to active, the operator message command obtained by the coupling facility from a processor image coupled to, but separate from the coupling facility, the operator message command to perform an action on the coupling facility;

determining that the selected buffer is to be reset, the selected buffer including information relating to processing the operator message command sent remotely to the coupling facility from the processor image coupled to, but separate from, the coupling facility, the selected buffer including a token field having the operator message token value relating the selected buffer to operator messages having operator message (OM) tokens having the same operator message token value; and

based on determining the selected buffer is to be reset, resetting the selected buffer, the resetting comprising setting the selected buffer to an idle state and setting one or more fields of a plurality of fields of the selected buffer to one or more predefined values, the plurality of fields including a timer to indicate a length of time an operator message has been active for the selected buffer, an operator message request length, and an operator message response length.

13. The computer system of claim 12, wherein the determining is based on an explicit operator message command received by the coupling facility, the explicit operator message command having a token for selecting a buffer having a token field value matching the token.

14. The computer system of claim 12, wherein the determining is based implicitly on a defined criterion considered by the coupling facility.

15. The computer system of claim 14, wherein the defined criterion includes determining that the buffer is active with a pending response and a timeout value associated with the buffer has exceeded a predetermined time value.

16. The computer system of claim 12, wherein the resetting comprises processing a delete operator message command, the delete operator message command comprising a message command block including a message header, a command indicating the delete operator message command, and the operator message token.

17. The computer system of claim 16, wherein the processing comprises:

determining that the operator message token in the buffer matches the operator message token in the delete operator message command;

based on the determining indicating the operator message token in the buffer matches the operator message token in the delete operator message command, checking whether an operator message response is pending;

based on the determining indicating the operator message response is pending, setting one or more fields of the buffer to one or more predefined values and setting a state of the buffer to idle; and

providing a message response block indicating that an operator message is deleted.

18. The computer system of claim 17, wherein the method further comprises setting the operator message token to zero.

19. A method of managing buffers of a computing environment, said method comprising:

setting, by a coupling facility of the computing environment, one or more buffers of the coupling facility to either an active state or an idle state, the setting comprising;

based on obtaining an operator message command in which a buffer of the coupling facility is to be set to the active state, setting a selected buffer of the coupling facility to the active state, the setting comprising storing an operator message token value of the operator message command in the selected buffer, and setting a state of the selected buffer to active, the operator message command obtained by the coupling facility from a processor image coupled to, but separate from the coupling facility, the operator message command to perform an action on the coupling facility;

determining that the selected buffer is to be reset, the selected buffer including information relating to processing the operator message command sent remotely to the coupling facility from the processor image coupled to, but separate from, the coupling facility, the selected buffer including a token field having the operator message token value relating the selected buffer to operator messages having operator message (OM) tokens having the same operator message token value; and

based on determining the selected buffer is to be reset, resetting the selected buffer, the resetting comprising setting the selected buffer to an idle state and setting one or more fields of a plurality of fields of the selected buffer to one or more predefined values, the plurality of fields including a timer to indicate a length of time an operator message has been active for the selected buffer, an operator message request length, and an operator message response length.

20. The method of claim 19, wherein the determining is based on an explicit operator message command received by the coupling facility, the explicit operator message command having a token for selecting a buffer having a token field value matching the token.

21. The method of claim 19, wherein the resetting comprises processing a delete operator message command, the delete operator message command comprising a message command block including a message header, a command indicating the delete operator message command, and the operator message token.