trcon Subroutine

Purpose

Starts the collection of trace data.

Library

Runtime Services Library (librts.a)

Syntax

int trcon( Channel)
int Channel;

Description

The trcon subroutine starts trace data collection for a trace channel. The trace session must have already been started using the trace command or the trcstart (trcstart Subroutine) subroutine.

Parameters

Item Description
Channel Specifies one of eight trace channels. Channel number 0 always refers to the Event/Performance trace. Channel numbers 1 through 7 specify generic trace channels.

Return Values

If the trcon subroutine was successful, zero is returned and trace data collection starts. If unsuccessful, a negative one is returned.