CATALOGUnder review

Historical Protheus includes catalog

#Include "<arquivo>.ch"

Review the observed purpose of 50 historical .ch files and identify which ones require current-release validation.

IncludesHistoryCompilationInventoryHistorical reference

01 · OVERVIEW

Overview

The include_001.zip package contains 50 includes and one version-control file. Most files are dated Feb. 28, 2007 and carry Microsiga 1997–2003 copyright headers; CTBR040.ch and CTBR150.ch are from 2005. The collection records how commands, translations and constants were organized at the time. It supports research and legacy maintenance, but never replaces the official include package for the current release.

02 · SYNTAX

Syntax

#Include "<arquivo>.ch"

Parameters

Protheus.ch

General definitions and commandsOptional

Collects Protheus function translations, general commands and several specialized includes. Observed symbols: Functions U_, P_, T_, W_ e H_; STACKVAR; Dialog.ch; Font.ch; PTMenu.ch; Print.ch; Colors.ch.

TopConn.ch

SQL and DBAccessOptional

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

TBIconn.ch

Environment and RPCOptional

Groups historical environment setup, RPC connection, remote transaction and remote table commands. Observed symbols: PREPARE ENVIRONMENT; RESET ENVIRONMENT; CREATE/CLOSE RPCCONN; CALLPROC.

StdWin.ch

Syntax and legacy UIOptional

Contains a large set of xBase translations, flow-control commands and historical visual constructs. Observed symbols: DO WHILE; ENDIF; ENDCASE; NEXT; DO; CALL; STORE.

SigaWin.ch

Legacy Protheus UIOptional

Extends visual, printing and function-convention commands from the historical Protheus interface. Observed symbols: Debug; BTNAUTFMT; PSAY; USER FUNCTION; PROW(); PCOL().

RWMake.ch

Legacy compatibilityOptional

Collects old UI and printing commands and includes StdWin.ch. Study it for maintenance; do not adopt it automatically in new sources. Observed symbols: DIALOG; ACTIVATE DIALOG; BITMAP; PSAY; USER FUNCTION.

FileIO.ch

FilesOptional

Defines opening, sharing and seeking modes used by low-level file functions. Observed symbols: F_ERROR; FS_SET; FS_RELATIVE; FS_END; FO_READ; FO_WRITE; FO_READWRITE.

Error.ch

Error handlingOptional

Defines severity and numeric categories used by error objects and routines. Observed symbols: ES_WARNING; ES_ERROR; ES_CATASTROPHIC; EG_ARG; EG_BOUND; EG_ZERODIV; EG_SYNTAX.

DBInfo.ch

RDD and databaseOptional

Provides identifiers for record information, RDD capabilities, locks and table characteristics. Observed symbols: DBRI_DELETED; DBRI_LOCKED; DBRI_RECNO; DBI_ISDBF; DBI_GETRECSIZE; DBI_GETLOCKARRAY.

VKey.ch

KeyboardOptional

Defines historical virtual-key codes used by keyboard and UI events. Observed symbols: VK_RETURN; VK_TAB; VK_SHIFT; VK_CONTROL; VK_ESCAPE e outras VK_*.

Colors.ch

ColorsOptional

Defines color constants and the RGB() translation used by visual components. Observed symbols: RGB(); CLR_BLACK; CLR_BLUE; CLR_RED; CLR_HGRAY e outras CLR_*.

WinAPI.ch

Legacy WindowsOptional

Collects Windows API constants for windows, messages, buttons and styles. It is platform-dependent and requires caution. Observed symbols: IDOK; IDCANCEL; BN_CLICKED; CS_*; WS_*.

Return value

Editorial inventory: 50 .ch files, one .scc file and 12 prioritized include pages.

03 · PRACTICAL EXAMPLE

Investigating a dependency

// 1. Locate the command or constant.
// 2. Search the target release include package.
// 3. Confirm current documentation.
// 4. Include only the required file.

Expected result

The dependency remains explicit and tied to the correct release.

BEST PRACTICES

Use the catalog to locate likely symbol origins in legacy code.
Confirm symbols in the official package for the target release.
Keep TOTVS.ch as the general reference when current official guidance requires it.
Individual pages remain under review until current documentation confirms support.
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

ZIP timestamps may not be original creation dates.
CTBR040.ch and CTBR150.ch contain routine-specific strings.
vssver.scc is version-control metadata, not an AdvPL include.
The package does not contain TOTVS.ch and must not replace the current environment files.
AI-generated content is an auxiliary source; examples and internal equivalences require technical verification.