Set User Policy (QPDETPOL) APISet User Policy (QPDETPOL) API| 1 | Policy data | Input | Char(*) |
| 2 | Length of policy data | Input | Binary(4) |
| 3 | Format of policy data | Input | Char(8) |
| 4 | Error Code | I/O | Char(*) |
The Set User Policy (QPDETPOL) API allows the changing of user policies related to service. This includes:
Information to use when setting the policy.
How long the policy data is.
Which policy to set. Only the following values are accepted.
| POLS0100 | Set service cleanup interval policy. |
| POLS0200 | Set problem documentation level. |
| POLS0300 | Set maximum PTF order size. |
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
The following information needs to be supplied in the policy data parameter (parameter 1) for the POLS0100 format.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Number of days |
The following information needs to be supplied in the policy data parameter (parameter 1) for the POLS0200 format.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | Problem documentation level |
The following information needs to be supplied in the policy data parameter (parameter 1) for the POLS0300 format.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Maximum PTF order size over LAN |
| 4 | 4 | BINARY(4) | Maximum PTF order size over a modem |
Maximum PTF order size over a modem. The maximum size in megabytes for a PTF order to be delivered electronically over a modem. This policy is shipped with a default value of 100 MB (MB equals approximately 1 000 000 bytes). If -1 is specified, PTF orders of any size are delivered over a modem. This policy cannot be set to a value less than 100 MB.
Maximum PTF order size over LAN. The maximum size in megabytes for a PTF order to be delivered electronically over the local area network (LAN). If -1 is specified, PTF orders of any size are delivered over the LAN. This policy is shipped with a default value of -1. This policy cannot be set to a value less than 100 MB (MB equals approximately 1 000 000 bytes).
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 accepted:
| *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 |
|---|---|
| CPFE080 | Maximum PTF order size not valid. |
| CPF0CC1 | Error initializing the XML parser. |
| CPF24B4 | Severe error while addressing parameter list. |
| CPF3CF1 | Error code parameter not valid. |
| CPF3CF2 | Error(s) occurred during running of &1 API. |
| CPF3C1E | Required parameter &1 omitted. |
| CPF3C21 | Format name &1 is not valid. |
| CPF3C3A | Value for parameter &2 for API &1 not valid. |
| CPF9872 | Program or service program &1 in library &2 ended. Reason code &3. |
| Top | Problem Management APIs | APIs by category |