Test Performance Data Collection (TESTPDC)

Instruction Syntax

Bound Program Access

Bound Program Access
`Built-in number for TESTPDC is 576. TESTPDC ( ) : signed binary(4) /* return_code /` The return code will be set as follows: Return code* Meaning 0 The thread is not in an active Performance Data Collector (PDC) trace collection. 1 The thread is in an active Performance Data Collector (PDC) trace collection. This built-in function is used to provide support for the branch and indicator forms of the TESTPDC instruction. The user must specify code to test the return code and perform the desired branching or indicator setting.

Built-in number for TESTPDC is 576.
TESTPDC (
) :   signed binary(4) /* return_code */

The return code will be set as follows:

Return code: Meaning
0: The thread is not in an active Performance Data Collector (PDC) trace collection.
1: The thread is in an active Performance Data Collector (PDC) trace collection.

This built-in function is used to provide support for the branch and indicator forms of the TESTPDC instruction. The user must specify code to test the return code and perform the desired branching or indicator setting.

Description:

A test is performed to determine whether or not the thread is in an active Performance Data Collector (PDC) trace collection.

One of the following occurs:

Branch form indicated
- Conditional transfer of control to the instruction indicated by the appropriate branch target operand.
Indicator form specified
- The leftmost byte of each of the indicator operands is assigned the following values:
  Hex F1–
  
  If the result of the test matches the corresponding indicator option
  
  Hex F0–
  
  If the result of the test does not match the corresponding indicator option

If no branch options are specified, instruction execution proceeds to the next instruction.

Resultant Conditions

True - The thread is in an active Performance Data Collector (PDC) trace collection.
False - The thread is not in an active Performance Data Collector (PDC) trace collection.

Authorization Required

None

Lock Enforcement

None

Exceptions

06 Addressing
- 0601 Space Addressing Violation
08 Argument/Parameter
- 0801 Parameter Reference Violation
1C Machine-Dependent
- 1C03 Machine Storage Limit Exceeded
20 Machine Support
- 2002 Machine Check
- 2003 Function Check
22 Object Access
- 2202 Object Destroyed
- 220B Object Not Available
24 Pointer Specification
- 2401 Pointer Does Not Exist
2C Program Execution
- 2C04 Branch Target Invalid
36 Space Management
- 3601 Space Extension/Truncation
44 Protection Violation
- 4401 Object Domain or Hardware Storage Protection Violation