Skip to content

FA$

Purpose
Contains the attributes of the format in use by the caller. This array enables the called method to derive the current data context and allows the context to be restored when control returns to the calling object.

The called method must ensure that this array is not modified before it is returned to the caller, or unpredictable behavior may result.

Used By
CONNECT METHOD

The calling class creates FA$[ALL]. The method receives string array MSG3$[ALL]

Contents

FA$[0] Format name.
FA$[1] Format header.
FA$[2] (1,1) Format attribute table entry length (ASC 1 byte).
(2,1) Number of entries in format table.
(3,1) Data name table entry length (ASC 1 byte).
(4,2) Format data record length (Binary 2 bytes).
FA$[3] Format attribute table.
FA$[4] Audit string.
FA$[5] Pre-processing procedure string.
FA$[6] Special prompt string.
FA$[7] Preset value string.
FA$[8] Valid value string.
FA$[9] Delete value string.
FA$[10] Security value string.
FA$[11] Post process procedure string.
FA$[12] IOLIST
FA$[13] Field separator elimination table.
Note: The field separator elimination table can be used in combination with the RTD function (see the Thoroughbred Basic Reference Manual). This will remove field separators and pad variable length fields. If the format definition does not match the data record, the RTD function will generate ERR=1.
FA$[14] Data name table
(1,1) Length of a data name entry.
(2,1) Number of data names.
(3,n) List of data names.
FA$[15] Local counters for OO70.
FA$[16] File channel numbers.
(1,2) Data file channel number.
(3,2) Sort file channel number.
FA$[17] Data name description table in the current language.
Note: When no data name description tables are defined, the data name table will be returned in place of the data name description table, FA$[14]. If the data name description table does not exist in the current language, starting with ENglish, the system will search for and return the first data name description table found.
(1,1) Length of a data name description entry.
(2,1) Number of data name descriptions.
(3,n) List of data name descriptions.

From the OPENworkshop Reference, version 8.9.1. Open this page in the PDF