Derivation: RePorT ST or aGe

RPTSTG generates, after an application has run, a report of the storage the application used. Language Environment writes storage reports only in mixed-case US English.

Use the storage report information to help you set the ANYHEAP, BELOWHEAP, HEAP, HEAP64, HEAPPOOLS, HEAPPOOLS64, IOHEAP64, LIBHEAP64, LIBSTACK, STACK, STACK64, THREADHEAP, THREADSTACK, and THREADSTACK64 run-time options for the best storage tuning.

For an example and complete description of the storage report, see z/OS Language Environment Debugging Guide.

Non-CICS default

RPTSTG=((OFF),OVR)

CICS® default

RPTSTG=((OFF),OVR)

AMODE 64 default

RPTSTG=((OFF),OVR)

Syntax

                    .-OFF-.        .-OVR----.      
>>-RPTSTG--=--(--(--+-ON--+--)--,--+-NONOVR-+--)---------------><

OFF

Does not generate a report of the storage used while the application was running.

ON

Generates a report of the storage used while the application was running.

OVR

Specifies that the option can be overridden.

NONOVR

Specifies that the option cannot be overridden.

CICS considerations

The phrases "Number of segments allocated" and "Number of segments freed" represent, on CICS, the number of EXEC CICS GETMAIN and EXEC CICS FREEMAIN requests, respectively.

Usage notes

• For AMODE 64 applications, Language Environment writes the storage report to stderr.
• RPTSTG may not generate the storage report if your application ends abnormally.
• When a vendor heap manager (VHM) is active, the Language Environment storage report includes a text line indicating that the user heap for the C/C++ part of the enclave is managed separately. The VHM is expected to write its own storage report to the stderr stream.
• RPTSTG includes PL/I task-level information about stack and heap usage.
• The phrases "Number of segments allocated" and "Number of segments freed" represent the number of system requests to allocate and deallocate storage requests, respectively.
• If you specify the RPTSTG runtime option while using HEAPPOOLS, extra storage is obtained from the ANYHEAP and is used to complete the storage report on heappools. This extra storage is only allocated when both HEAPPOOLS and RPTSTG are used.
• If you specify the RPTSTG runtime option while using HEAPPOOLS64, extra storage is obtained from the LIBHEAP64 and is used to complete the storage report on heappools. This extra storage is only allocated when both HEAPPOOLS64 and RPTSTG are used.

Performance considerations

This option increases the time it takes for an application to run. Therefore, use it only as an aid to application development.

The storage report generated by RPTSTG(ON) shows the number of system-level calls to obtain storage that were required while the application was running. To improve performance, use the storage report numbers generated by the RPTSTG option as an aid in setting the initial and increment size for stack and heap. This reduces the number of times that the Language Environment storage manager makes requests to acquire storage. For example, you can use the storage report numbers to set appropriate values in the HEAP init_size and incr_size fields for allocating storage.

For more information

• For more information about tuning your application with storage numbers, see z/OS Language Environment Programming Guide or z/OS Language Environment Programming Guide for 64-bit Virtual Addressing Mode.
• For more information about the MSGFILE run-time option, see MSGFILE.
• For an example and complete description of the storage report, see z/OS Language Environment Debugging Guide.