gtps1m4wSystem Macros

SETTC-Set C Function Trace Information for an ECB

Use this system macro to change C function trace information for the specified entry control block (ECB). By using this macro you can:

After a C function trace table has been allocated for an ECB, this macro has no effect, except that an error indication code is returned in register 15 (R15).

Format




label
A symbolic name assigned to the macro statement.

ECB=Rx
Changes the C function trace settings for the ECB with its system virtual address (SVA) specified in a register in the range R0 - R6.

SIZE
Specifies the size of the C function trace table to allocate for the specified ECB. The size is saved and used later when the C function trace table is created.

If a C function trace table already exists for the specified ECB, the value specified by the SIZE parameter is not saved and an error indication code is returned in register R15.

Ry
A register in the range R0 - R6 containing the number of 4096-byte (4 KB) blocks of heap storage to allocate for the C function trace table. This number is from 1 to a maximum of 256 (X'100').

If the value in the register does not fall within the 1 - 256 range, the value is not saved and an error indication code is returned in register R15.

SYSTEM
The TPF system value for the trace table size is one 4 KB block (4096 bytes).

SAME
Do not change the size of the C function trace table. If the size has not been specified by a previous SETTC macro, a value of one 4 KB block (4096 bytes) is used when the C function trace table is created.

USERSIZE
Specifies the size of the C function trace user area to allocate when tracing starts for the specified ECB.

If a C function trace user area already exists for the specified ECB, the value specified by the USERSIZE parameter is not saved and an error indication code is returned in register R15.

Rz
A register in the range R0 - R6 containing the number of 4096-byte blocks of heap storage to allocate for the C function trace user area. This number is in the 1 to 256 (X'100') range.

If the value in the register does not fall in the 1 to 256 range, the value is not saved and an error indication code is returned in register R15.

NONE
Do not allocate a C function trace user trace table.

SAME
Do not change the existing size of the C function trace user area. If the size has not been specified by a previous SETTC macro, a C function trace user area will not be created.

STACK
Changes tracing of C stack data for the specified ECB.

ON
Specifies that 68 bytes of the stack user information are placed into the trace table entry.

OFF
Specifies that the address of the stack area is placed into the trace entry and no C stack information is placed in the trace table.

SAME
Do not change the current setting of C function trace stack data. If the setting of STACK has not been specified by a previous SETTC macro, the current system STACK value is used.

STATIC
Changes tracing of C static data for the specified ECB.

ON
Specifies that 68 bytes of the C static information are placed into the trace table.

OFF
Specifies that the address of the static area is placed into the trace entry, but no C static data is placed in the trace table.

SAME
Do not change the current setting of C function trace of static data. If the setting of STATIC has not been specified by a previous SETTC macro, the current system STATIC value is used.

Entry Requirements

Return Conditions

Programming Considerations

Examples