Executing a start operator message command

• US 8,788,719 B2
• Filed: 11/20/2012
• Issued: 07/22/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): SUN, SCOTT C
• Application Number:
  US13/681,604
• Publication Number:
  US 20130081058A1
• Time in Patent Office: 609 Days
• Field of Search: None
• 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 method of processing a start command in a computing environment comprising a coupling facility coupled to one or more processor images of the computing environment, the 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 method of claim 1, wherein the response code indicates that an operator message has been started.

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

4. The method of claim 1, further comprising:

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 method 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 buffer.

6. The method of claim 5, further comprising obtaining, by the coupling facility, a read operator message command to read the buffer to obtain the operator message response.

7. The method 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 method of claim 7, further comprising processing the read operator message command, wherein the processing comprises:

determining whether a buffer within the coupling facility has a token matching the operator message token;

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

based on the determining indicating the operator message response is pending, copying the operator message response from the buffer having the token matching the operator message token 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 method of claim 1, further comprising:

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 method 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 whether a buffer within the coupling facility has a token matching the operator message token;

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

based on the determining indicating the operator message response is pending, resetting one or more fields of the selected buffer having the token matching the operator message token 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 method of claim 10, wherein the resetting includes setting the operator message token to zero.

12. The method of claim 1, further comprising:

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.

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

14. The method of claim 1, wherein the selected buffer is located within the coupling facility.

15. The method of claim 1, wherein the setting the state comprises setting within the selected buffer the state.