SET TEMPSTORAGE

Description

The SET TEMPSTORAGE command changes the limit for the amount of storage that is available for main temporary storage queues to use.

When you change this limit, check your current setting for the z/OS® parameter MEMLIMIT. MEMLIMIT limits the amount of 64-bit storage that the CICS address space can use. Your setting for TSMAINLIMIT must not be greater than 25% of the MEMLIMIT value. Use the CICS SPI command INQUIRE SYSTEM MEMLIMIT to find the MEMLIMIT value that currently applies to the CICS system.

Options

TSMAINLIMIT(data-value)

Specifies a doubleword binary value for the maximum amount of storage that CICS makes available for main temporary storage queues to use. The minimum value is 1048576 bytes (1 MB), and the maximum value is 34359738368 bytes (32,768 MB or 32 GB).

A value entered in bytes is rounded down to the nearest megabyte.

If you increase the TSMAINLIMIT setting, the value is set as follows:

• If the new value is not greater than 25% of the value of the z/OS parameter MEMLIMIT, the value that you choose is set.
• If the new value is greater than 25% of the MEMLIMIT value, TSMAINLIMIT remains unchanged.

If you decrease the TSMAINLIMIT setting, CICS attempts to maintain at least 25% free space in allowed storage above current utilization, so that temporary storage write requests do not reach TSMAINLIMIT too rapidly. The value is set as follows:

• If there is currently less than 25% free space, TSMAINLIMIT remains unchanged.
• If at least 25% of the new limit will be free space, the setting is decreased to the value that you choose.
• If less than 25% of the new limit would be free space, the setting is decreased to the current utilization plus 33% of that utilization.

Conditions

INVREQ

RESP2 value:

1

An attempt was made to set an invalid value.

2

TSMAINLIMIT must not be greater than 25% of MEMLIMIT.

NOTAUTH

RESP2 value:

100

The user associated with the issuing task is not authorized to use this command.