Retrieve Policy Data (QPDETRTV) APIRetrieve Policy Data (QPDETRTV) API| 1 | Receiver variable | Output | Char(*) |
| 2 | Length of receiver variable | Input | Binary(4) |
| 3 | Format name | Input | Char(8) |
| 4 | Error Code | I/O | Char(*) |
The Retrieve Policy Data (QPDETRTV) API retrieves policy data.
None.
The variable that will receive the policy information being retrieved. For the format, see Format of data returned.
The length of the receiver variable described in Format of data returned. If the length is larger than the size of the receiver variable, the results may not be predictable. The minimum length is 8 bytes.
The format of the information to be returned. You must use one of the following format names:
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | Binary(4) | Bytes returned |
| 4 | 4 | Binary(4) | Bytes available |
| 8 | 8 | Binary(4) | Number of days |
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | Binary(4) | Bytes returned |
| 4 | 4 | Binary(4) | Bytes available |
| 8 | 8 | Binary(4) | Problem documentation level |
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | Binary(4) | Bytes returned |
| 4 | 4 | Binary(4) | Bytes available |
| 8 | 8 | Binary(4) | Maximum PTF order size over LAN |
| 12 | C | Binary(4) | Maximum PTF order size over a modem |
Bytes available. The number of bytes of data available to be returned. All available data is returned if enough space is provided.
Bytes returned. The number of bytes of data returned.
Maximum PTF order size over a modem. The maximum size in megabytes for a PTF order to be delivered over a modem. A value of -1 indicates PTF orders of any size are delivered over a modem. A value of 100 MB (MB equals approximately 1 000 000 bytes) is used if a lower value is retrieved.
Maximum PTF order size over LAN. The maximum size in megabytes for a PTF order to be delivered over the local area network (LAN). A value of -1 indicates PTF orders of any size are delivered over the LAN. A value of -1 is used if a value lower than 100 MB (MB equals approximately 1 000 000 bytes) is retrieved.
Number of days. The number of days an object covered by this policy is allowed to exist before being deleted by the Service Monitor. Objects covered by this policy are: Service Monitor logs and Integrated File System files created by the FFDC process.
Problem documentation level. Indicates how much problem documentation should be included when problems are automatically reported to the service provider Only the following values are returned:
| *BASE | Minimal documentation is sent in the service request record. No additional data will be uploaded. |
| *DEFAULT | Minimal documentation will be sent in the service request record. If no fix for the problem is found, additional documentation will be automatically uploaded. Additional documentation may include information such as joblogs and service dumps. |
The following messages may be sent from this function:
| Message ID | Error Message Text |
|---|---|
| CPF3CF1 | Error code parameter not valid. |
| CPF3CF2 | Error(s) occurred during running of * API. |
| CPF3C1D | Input variable length in parameter * not valid. |
| CPF3C1E | Required parameter * omitted. |
| CPF3C17 | Error occurred with input data parameter. |
| CPF3C21 | Format name * is not valid. |
| CPF3C4A | Value not valid for field *. |
| CPF3C4B | Value not valid for field *. |
| CPF3C4C | Value not valid for field *. |
| CPF9872 | Program or service program * in library * ended. Reason code *. |
| Top | Problem Management APIs | APIs by category |