Usina BRAdvPL Guide
Sign in
← All topics
INCLUDEUnder review

TopConn.ch

#Include "TopConn.ch"

Declares the TCQUERY command used to open SQL results through the TOPCONN RDD.

IncludesSQL and DBAccessHistorical referenceCompilation
01 · OVERVIEW

Overview

Declares the TCQUERY command used to open SQL results through the TOPCONN RDD. Symbols highlighted by the historical file include: TCQUERY. Confirm names, availability and behavior against the official include package for the target environment.

02 · SYNTAX

Syntax

#Include "TopConn.ch"

Parameters

TopConn.ch
.ch fileOptional

Compile-time include; whether it is required depends on the symbols used by the source.

Return value

An include has no runtime return value. Its directives are processed during compilation.

03 · PRACTICAL EXAMPLE

Minimal include for study

#Include "TopConn.ch"

User Function ExTopconn()
    // Use only symbols documented for the target release.
Return
Expected result

The preprocessor makes definitions from the configured include path available.

BEST PRACTICES
  • Include it only when the source depends on one of its symbols.
  • Use includes matching the environment and LIB version.
  • Search the current package before treating a historical symbol as valid.
  • Prefer current official documentation for supported APIs.
  • Google-generated teaching material from Aug. 8, 2026 was used as an editorial lead, but claims were checked and corrected where they conflated the editor, preprocessor, conventional functions, MVC persistence or TLPP keywords.
COMMON PITFALLS
  • The analyzed file is historical.
  • Copying an old include can create LIB or RPO incompatibilities.
  • A declared directive does not prove that its related API is still supported.
  • AI-generated content is an auxiliary source; examples and internal equivalences require technical verification.

Related content

REFERENCES
  1. MICROSIGA SOFTWARE S.A. include_001.zip. Historical package supplied to the project on Aug. 8, 2026.
  2. GOOGLE. Dictionary of Commands, Common Constants and Tested Practical Examples. Generated Aug. 8, 2026; reviewed and adapted by the AdvPL Guide.
Status
Under review
Page created on
Last reviewed on
Original language
Portuguese
Reviewed by
Usina.BR