Executing a start operator message command

• US 8,799,522 B2
• Filed: 06/10/2011
• Issued: 08/05/2014
• Est. Priority Date: 06/10/2011
• Status: Active Grant

• 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): Unelus, Ernest
• Application Number:
  US13/157,910
• Publication Number:
  US 20120317402A1
• Time in Patent Office: 1,152 Days
• Field of Search: 710/5, 710/2
• US Class Current: 710/5
• 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 processing a start command in a computing environment comprising a coupling facility coupled to one or more processor images of the computing environment, 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;

receiving by the coupling facility from a processor image coupled thereto a start operator message command, the start operator message command comprising a message command block including a message header, an indication of the start operator message command, an operator message request that includes an operator message command to be processed by the coupling facility, an operator message request length and an operator message token;

based on receiving the start operator message command, processing the start operator message command, wherein the processing comprises;

storing within a selected buffer of one or more buffers the operator message token, the operator message request and the operator message request length, wherein the operator message token uniquely identifies the operator message command and associates the selected buffer with the operator message command;

setting within the selected buffer a timer to current time;

setting a state of the selected buffer; and

providing a response code for the start operator message command.

2. The computer program product of claim 1, wherein the response code indicates that an operator message has been started.

3. The computer program product of claim 1, wherein the state of the selected buffer is set to active and in process.

4. The computer program product of claim 1, wherein the method further comprises:

determining whether an idle buffer exists, wherein an idle buffer is indicated by a token field of the buffer being zero;

selecting an idle buffer as the selected buffer, based on the determining indicating an idle buffer exists;

checking whether an active buffer has timed out, based on the determining indicating there are no idle buffers; and

selecting an active buffer that has timed out as the selected buffer, based on the checking indicating there is an active buffer that has timed out.

5. The computer program product of claim 1, wherein based on receiving the start operator message command, performing an action specified by the operator message request and storing an operator message response in the selected buffer.

6. The computer program product of claim 5, wherein the method further comprises obtaining, by the coupling facility, a read operator message command to read the selected buffer to obtain the operator message response.

7. The computer program product of claim 6, wherein the read operator message command comprises a message command block comprising a message header, the operator message token and a command specifying the read operator message command.

8. The computer program product of claim 7, wherein the method further comprises processing the read operator message command, wherein the processing comprises:

determining that the selected buffer has the operator message token matching the operator message token of the read operator message command;

based on determining the selected buffer has the operator message token matching the operator message token of the read operator message command, checking whether an operator message response is pending within the selected buffer having the operator message token matching the operator message token of the read operator message command; and

based on the determining indicating the operator message response is pending, copying the operator message response from the selected buffer to a data block, copying a response length to a message response block of the read operator message command, and providing to the processor image the message response block and at least an indication of the data block.

9. The computer program product of claim 1, wherein the method further comprises:

receiving, by the coupling facility, a delete operator message command; and

processing the delete operator message command to place the selected buffer in an idle state.

10. The computer program product of claim 9, wherein the delete operator message command comprises a message command block comprising a message header, a command specifying the delete operator message command, and the operator message token, and wherein the processing comprises:

determining that the selected buffer has the operator message token matching the operator message token in the delete operator message command;

based on determining the selected buffer has the operator message token matching the operator message token in the delete operator message command, checking whether an operator message response is pending within the selected buffer having the operator message token matching the operator message token in the delete operator message command;

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

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

11. The computer program product of claim 10, wherein the resetting includes setting the operator message token to zero.

18. The computer program product of claim 1, wherein the method further comprises:

determining whether an idle buffer exists;

selecting an idle buffer as the selected buffer, based on the determining indicating an idle buffer exists;

checking whether an active buffer has timed out, based on the determining indicating there are no idle buffers; and

selecting an active buffer that has timed out as the selected buffer, based on the checking indicating there is an active buffer that has timed out.

19. The computer program product of claim 1, wherein the operator message command is to take action on the coupling facility, and wherein the method further comprises receiving operator message commands by the coupling facility to test the coupling facility, the operator message commands received from a plurality of types of sources remote from the coupling facility, including a coupling facility console and the processor image.

20. The computer program product of claim 1, wherein the setting the state comprises setting within the selected buffer the state.

12. A computer system for processing a start command in a computing environment comprising a coupling facility coupled to one or more processor images of the computing environment, 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;

receiving by the coupling facility from a processor image coupled thereto a start operator message command, the start operator message command comprising a message command block including a message header, an indication of the start operator message command, an operator message request that includes an operator message command to be processed by the coupling facility, an operator message request length and an operator message token;

based on receiving the start operator message command, processing the start operator message command, wherein the processing comprises;

storing within a selected buffer of one or more buffers the operator message token, the operator message request and the operator message request length, wherein the operator message token uniquely identifies the operator message command and associates the selected buffer with the operator message command;

setting within the selected buffer a timer to current time;

setting a state of the selected buffer; and

providing a response code for the start operator message command.

13. The computer system of claim 12, wherein the method further comprises:

determining whether an idle buffer exists, wherein an idle buffer is indicated by a token field of the buffer being zero;

selecting an idle buffer as the selected buffer, based on the determining indicating an idle buffer exists;

checking whether an active buffer has timed out, based on the determining indicating there are no idle buffers; and

selecting an active buffer that has timed out as the selected buffer, based on the checking indicating there is an active buffer that has timed out.

14. The computer system of claim 12, wherein based on receiving the start operator message command, performing an action specified by the operator message request and storing an operator message response in the selected buffer.

15. The computer system of claim 14, wherein the method further comprises obtaining, by the coupling facility, a read operator message command to read the selected buffer to obtain the operator message response, and wherein the read operator message command comprises a message command block comprising a message header, the operator message token and a command specifying the read operator message command.

16. The computer system of claim 15, wherein the method further comprises processing the read operator message command, wherein the processing comprises:

determining that the selected buffer has the operator message token matching the operator message token of the read operator message command;

based on determining the selected buffer has the operator message token matching the operator message token of the read operator message command, checking whether an operator message response is pending within the selected buffer having the operator message token matching the operator message token of the read operator message command; and

based on the determining indicating the operator message response is pending, copying the operator message response from the selected buffer to a data block, copying a response length to a message response block of the read operator message command, and providing to the processor image the message response block and at least an indication of the data block.

17. The computer system of claim 12, wherein the method further comprises:

receiving, by the coupling facility, a delete operator message command; and

processing the delete operator message command to place the selected buffer in an idle state, wherein the delete operator message command comprises a message command block comprising a message header, a command specifying the delete operator message command, and the operator message token, and wherein the processing comprises;

determining that the selected buffer has the operator message token matching the operator message token in the delete operator message command;

based on determining the selected buffer has the operator message token matching the operator message token in the delete operator message command, checking whether an operator message response is pending within the selected buffer having the operator message token matching the operator message token in the delete operator message command;

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

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