Function

msgrcv receives messages from message queues.

Parameters

qid

The queue ID.

msgvar

The name of a variable that contains the received message.

length

The maximum length of the message to be received. This parameter is flagged as an error if storage cannot be obtained for a buffer of this size.

nowait

Specifies whether the caller is to wait for a message of the required type.

0

Waits for a message of the requested type. This is the default.

1

An error is immediately returned if a message of the requested type is not on the queue.

typevar

The name of a variable that contains the type of message to be received. On output, the variable contains the type for the message received. The type is a 4-byte binary value with a default of '00000000'x, which means that any message type is received.

noerr

The action to be taken if the message is longer than the receive length.

0

An error is returned. This is the default.

1

The message is truncated.

stem

The name of a stem variable that is used to return information on the message. Upon return, stem.0 contains the number of variables returned. To access the variables, use a numeric value (see REXX predefined variables) or any of the predefined variables: MSGBUF, MTIME, MSGBUF_UID, MSGBUF_GID, or MSGBUF_PID.