Retrieve Registered Filters (QNMRRGF) API
Required Parameter Group:
| 1 | Receiver variable | Output | Char(*) |
| 2 | Length of receiver variable | Input | Binary(4) |
| 3 | Filter type | Input | Char(10) |
| 4 | Format | Input | Char(8) |
| 5 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Retrieve Registered Filters (QNMRRGF) API returns all filters registered for a filter type. If not enough space exists to return all the registered filters, then as many registered filters as fit in the provided space are returned. A count of the total number of registered filters for the specific filter type is also returned.
Authorities and Locks
None.
Required Parameter Group
- Receiver variable
- OUTPUT; CHAR(*)
The variable in which the registered filters are returned. If the variable is not large enough to contain all the registered filters, then only as many registered filters will be returned as will fit in the receiver variable.
- Length of receiver variable
- INPUT; BINARY(4)
The length of the receiver variable parameter. If not enough space is given, then only the number of filters that fit will be returned. In this case the number of bytes available will be greater than the number of bytes returned.
- Filter type
- INPUT; CHAR(10)
The type of filter to be retrieved.
Special values supported are:
*ALR Alert filter *PRB Problem log filter
- Format
- INPUT; CHAR(8)
The format of the receiver variable. The valid value is format RGFN0100. See RGFN0100 Format for the format of the receiver variable.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
RGFN0100 Format
See Field Descriptions for a description of the fields in this format.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Bytes returned |
| 4 | 4 | BINARY(4) | Bytes available |
| 8 | 8 | BINARY(4) | Returned registered filters |
| 12 | C | BINARY(4) | Total registered filters |
| 16 | 10 | BINARY(4) | Element length |
| 20 | 14 | CHAR(*) | Array of registered filters |
| Note: This is an array with the following element structure: | |||
| 0 | 0 | CHAR(10) | Filter name |
| 10 | A | CHAR(10) | Filter library name |
| 20 | 14 | CHAR(10) | Library type |
Field Descriptions
Array of registered filters. A 10-character filter name followed by a 10-character library name followed by a 10-character filter type.
Bytes available. The number of bytes of data that is available. If this number is greater than the bytes returned, the receiver variable was not large enough to contain all the registered filters.
Bytes returned. The number of bytes of data returned in the receiver variable.
Element length. The length of a single array element. For format RGFN0100 the length is 30 bytes.
Filter library name. The name of the library containing the registered filter.
Filter name. The name of the filter object that was registered.
Filter type. The type of the filter as defined by the FTRTYPE parameter on the Create Filter (CRTFTR) command.
Returned registered filters. The number of registered filters that is returned in the array.
Total registered filters. The total number of filters registered for the specified filter type.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C24 E | Length of the receiver variable is not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF8100 E | All CPF81xx messages could be returned. xx is from 01 to FF. |
| CPF91D6 E | Filter type &1 not valid. |
| CPF9800 E | All CPF98xx messages could be signaled. xx is from 01 to FF. |
API introduced: V2R3
[ Back to top | Network Management APIs | APIs by category ]