Control Temporary Storage (QWCCTLTS) API
Required Parameters:
| 1 | Control function | Input | Char(10) |
| 2 | Control category | Input | Char(10) |
Optional Parameter Group 1:
| 3 | Limit | Input | Packed decimal(15 5) |
Optional Parameter Group 2:
| 4 | Error code | I/O | Char(*) |
Default Public Authority: *EXCLUDE
Threadsafe: No
The Control Temporary Storage (QWCCTLTS) API sets a limit on the amount of temporary storage used before a notification is sent.
The limit for the temporary storage in the system is set as a percentage of the total storage capacity of the system ASP. Message CPF090A is sent to QSYSOPR when the limit for the system is reached.
The limit for the temporary storage in a single category is set as an amount in megabytes or gigabytes. Message CPI11AB is sent to QSYSOPR when the limit for a category is reached.
The information set up by this API remains in effect after an initial program load (IPL).
This API should be used only when recommended by your IBM® service representative.
Authorities and Locks
To use this API, you must have service (*SERVICE) special authority.
Required Parameters
- Control function
- INPUT; CHAR(10)
The control function to be performed. The valid values are:
*SETLMTPCT Set the limit percentage for the system or a category. *SETLMT Set the limit (in megabytes) for a category. *SETLMTG Set the limit (in gigabytes) for a category. *DSPLMT Display the limit and current usage.
- Control category
- INPUT; CHAR(10)
The temporary storage category for the limit. The valid values are:
*ALL All temporary storage for the system. *OS Operating system category. *CMD Command category. *ACTJOB Temporary job structure category. *POSIX POSIX category. *TMPUDFS Temporary user-defined file systems category. *WM Work management category. *SR Save/restore category.
Optional Parameter Group 1
- Limit
- INPUT; PACKED DECIMAL(15 5)
The limit to for the temporary storage category. The value is a percent for *SETLMTPCT control function. The value is megabytes for *SETLMT control function. The value is gigabytes for *SETLMTG control function. To set the limit back to the default value (no limit) use a value of 0.
Optional Parameter Group 2
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.
Usage Notes
The QWTCTLTS API can be called from the Command Entry prompt.
To set the warning limit for all temporary storage on the system to 40 percent of the system ASP you can use this command:
CALL QWCCTLTS PARM(*SETLMTPCT *ALL 40)
To set the warning limit for temporary job structures to 25 megabytes use this command:
CALL QWCCTLTS PARM(*SETLMT *ACTJOB 25)
To remove a warning limit for all temporary storage on the system (and set it back to the default of no warning limit) you can use this command:
CALL QWCCTLTS PARM(*SETLMTPCT *ALL 0)
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF222E E | &1 special authority is required. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid.. |
| CPF3C3B E | Value for parameter &2 for API &1 not valid. |
| CPF3C3C E | Value for parameter &1 not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF980A E | &1 routine in &2 module detected an exception. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V7R2