GETMSG Parameters
The GETMSG parameters are described in Table 1. The parameters must be specified in the order shown in the figure; however, they do not have to be contiguous in storage.
| Parameter | Description |
|---|---|
| Flags | See Table 2 for a description of the flags. This is a 4-byte field. |
| CNMCB Address | Specifies a field to contain the address of the control block containing the message and associated information (CNMCB) returned to the user. This is a 4-byte field. See Table 1 for details. |
| CART | Specifies a search argument that is compared with the CARTs propagated with the messages routed to the user's console. If this value is not specified (CART flag is off), the oldest message is returned. This is an 8-byte field. |
| Mask | Specifies a mask that will be ANDed with the CART specified in the CART parameter and the CART propagated with the messages routed to the user's console. The two ANDed values are then compared, and if a match occurs, the message is returned. If this value is not specified (mask flag is off), the oldest solicited message with a matching CART is returned. This is an 8-byte field. |
| Time | Specifies a time (in seconds) that the service waits for the message if it has not been routed to the user's console. This is a 4-byte field. |
The flags that are passed as input to GETMSG are described in Table 2.
| Flag | Meaning |
|---|---|
| X'80000000' | A solicited message that has been routed to the user's console is requested. If this bit is on, the CART and mask flags may be used to request specific messages. |
| X'40000000' | The oldest unsolicited message routed to the user's console is requested. |
| X'20000000' | A solicited or unsolicited message is requested. The oldest message routed to the user's console is returned. |
| X'10000000' | Indicates that a CART is specified in the parameter at offset X'08'. |
| X'08000000' | Indicates that a mask is specified in the parameter at offset X'10'. |
| X'04000000' | Indicates that a time value is specified in the parameter at offset X'18'. |
| X'03FFFFFF' | Reserved. |