| 1 | Request handle | Input | Char(4) |
| 2 | Number of keys | Input | Binary(4) |
| 3 | Key field information | Input | Array(*) of Char(12) |
| 4 | Key field values | Input | Array(*) of Char(30) |
| 5 | Entry number | Output | Binary(4) |
| 6 | Key found | Output | Char(1) |
| 7 | Message type information | Input | Char(10) |
| 8 | Error code | I/O | Char(*) |
The Find Entry Number in Message List (QGYFNDME) API returns the number of the entry in a list of messages for a given key value. This API may be used on a list generated by the following APIs:
None.
The handle of the list, generated by one of the list messages APIs.
The number of elements, within the key field information array, to search.
The offset and length of information to search.
| Key field offset | BINARY(4) The offset within the list entry to search. |
| Key field length | BINARY(4) The length of the field within the list entry to search. |
| Reserved | CHAR(4) An ignored field. This field must be set to hexadecimal zeros. |
The value of the fields indicated in the key field information parameter to search for.
The number of the first entry in the list in which the key is found. If the key is not found in a sorted list, the number of the entry previous to where the requested entry would have been is returned (a 1 is returned if the entry not found is the first entry in the list). If the key is not found in an unsorted list, a 1 is returned. If the list is empty, a 0 is returned.
Whether the entry returned is for the key requested or the key was not found. The possible values are:
| 0 | The key was not found. The entry number returned is not associated with the key given. |
| 1 | The key was found. The entry number returned is associated with the key given. |
The type of message to search for. A valid value must be specified if the messages have been grouped. The possible values are:
| *MNR | The group of messages that need a reply are searched. |
| *MNNR | The group of messages that do not need a reply are searched. |
| *SCNR | The group of sender's copy messages that need a reply are searched. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
| GUI0001 E | Invalid handle specified. |
| GUI0067 E | &1 is not valid for message type. |
| GUI0102 E | Offset of field, &1, is not valid. |