Sizing temporary storage

Temporary Storage Queue (TSQ) is used to back up IBM® Transformation Extender for Application Programming work spaces required to run a map.

Work space refers to a physical store that is used to shadow input and output data. Shadow data is usually created when the map uses an adapter or Transient Data Queues, or the map is expecting the data to contain record separators. Work spaces are also used by the core transformation services to store information about the data that is being mapped.

Because you can develop a map with no inputs and outputs, work spaces might not be used in some situations.

The minimum number of possible work spaces for a map execution is 1. The maximum possible number is 1 + (2 * number of inputs) + (2 * number of outputs).

TSQ will not be used by a map if the map's source and targets are passed as memory buffers and the workspace in memory option (-WM) is used.

Each work space is keyed by a unique TSQ qname. The format of the qname is TXnnnnnNddddddd, where nnnnn is the CICS task id and ddddddd is a sequence number.

In theory, the maximum size of a single work space is 1,073,545,221 bytes.

To calculate the TSQ space requirements for a particular map, you need to determine the maximum data size of each input and each output.

The formula for a specific input is:
TSQ size = (max data size * 5) 

The criteria for the multiplier of 5 is 1 for the shadow file and 4 for the work space used by the core transformation service. The amount of space required by the core transformation service might actually be less. It depends on a number of factors such as the number of objects being validated. Four (4) is typical for a complex type tree with lots of types defined.