Xchcond

1 Maintain Conditions (tuxch0111m000)
Helptekst : SExch0111m000
SESSION AIM [LBtutugen.ses.aim]
To maintain conditions under which data can be imported or
exported.
HOW TO USE THE SESSION [LBtutugen.ses.use]

Use the option [H] to activate the text editor to maintain a
script. After the script is maintained, it can be compiled
using
choice option <Ctrl> [G]. Alternatively, all the condition
scripts can be collectively compiled using the session "Check
Syntax of Conditions (tuxch0206m000) [SEtuxch0206m000]",
activated by pressing <Ctrl>[Z] on the choice field. After the
script is successfully compiled the flag "Compiled
[TFtuxch011.cmpl]" will automatically become "Yes
[ENtuxch.yesno.yes]".
Helptekst : FCxch011.cmpl
This session allows the user to compile various condition
scripts collectively.

After the fields have been filled on the screen, Press [Y]
to
start processing. Only the condition codes within the range
for which the text is present and which contains the
condition
script, is compiled. The objects and errors produced by the
compilation will be stored in the path as present in the
table
fields "Path for Objects [TFtuxch001.opth]" and "Path for
Errors [TFtuxch001.epth]" of the session Maintain Exchange
Schemes (tuxch0101m000) [SEtuxch0101m000]. The directories
must have proper permissions. Also the errors are displayed
on
the screen.
The object file name will have first character as "o" and
the
error file name will have first character as "e". The file
name contains the condition code.
Example:
If in the exchange scheme details field "Path for Objects
[TFtuxch001.opth]" is /users/home/exchange,
Exchange scheme: TRITON [LBtutugen.p.aa]
Company number : 505
ASCII file code: itmdata
Condition code : ITEMCOND
The object that will be created after compilation will be

stored as:
/users/home/exchange/triton505/itemdata/oITEMCOND
If errors occur then , if "Path for Errors

[TFtuxch001.epth]" is /users/home/exchange, the name of
error file will be :
/users/home/exchange/triton505/itemdata/eITEMCOND
Helptekst : FCxch011.cmpl
This is a flag indicating whether successful compilation is
done for the condition script.
Options: COPY & GLOBAL COPY

When a condition is copied the condition script is also copied.
However, the script text is actually copied with different text
number. Hence this script can be changed without effecting
change
in the script of original condition. After copying always the
compilation flag will become "No [ENtuxch.yesno.no]" and
compilation should be done separately.
FOR FURTHER INFORMATION, SEE KEYWORD(S): [LBtutugen.help.inf]

- Conditions [TBtuxch011]
- Display Predefined Functions/Variables (tuxch0510m000)
[SEtuxch0510m000]
DEFINITIE [LBtctcgen.htb.defin]
Conditions are used to determine field values, to check the
updation of records in TRITON [LBtutugen.p.aa] tables and
for
the stop mechanism. The condition codes are maintained in
this
session and these condition codes then can be linked to
table
relation or field relation.
To display details about Functions/Variables.
For detail information about functions/variables use the
hypertext feature. Select the function/variable of which
help
you want to see and details for that function/variable will
be
shown.
Functions [LBtutuxchs0510.01]
READ.TABLE [LHtutuxchs0510.03]
READ.TABLE.ONCE [LHtutuxchs0510.04]
READ.TABLE.COMPANY [LHtutuxchs0510.05]
UPDATE.FIELD.STR [LHtutuxchs0510.06]
UPDATE.FIELD.NUM [LHtutuxchs0510.07]
RETURN.TF.VAL [LHtutuxchs0510.08]
UPDATE.FIELD.INT [LHtutuxchs0510.18]
Variables [LBtutuxchs0510.02]
ascii.file.rec [LHtutuxchs0510.09]
no.rec.read [LHtutuxchs0510.10]
no.rec.write [LHtutuxchs0510.11]
no.err.rejects [LHtutuxchs0510.12]
no.cond.rejects [LHtutuxchs0510.13]
triton.field [LHtutuxchs0510.14]
element.no [LHtutuxchs0510.15]
ascii.file.name [LHtutuxchs0510.16]
import.company [LHtutuxchs0510.17]
tuxch0111m000 zoom multi/view (3) Form 1-1
∨⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗↵
≥ Maintain Conditions Company:
000 ≥
≥⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗≥
≥
≥
≥ Exchange Scheme : 1....... 2_____________________________
≥
≥ Ascii File : 3....... 4_____________________________
≥
≥
≥
≥ Condition Description Type Script Compiled
≥
≥
≥
≥
≥
≥ 5....... 6............................. 7......... 8____ 9____
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥
≥ Uw keuze: ..
≥
ℵ⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗⊗∧
Veldnaam : tuxch011.cxch
Helptekst : FCxch001.cxch
1. Exchange Scheme The exchange code is a unique identity for each exchange
scheme.
All other attributes in the exchange scheme are defined with
reference to the exchange code.
De invoergegevens moeten worden gedefiniëerd in de sessie
[LBtctcgen.help.input] "Maintain Exchange Schemes
(tuxch0101m000)
[SEtuxch0101m000]".
To maintain the Exchange Scheme data. The exchange of data
has
been done for a specific exchange (conversion) scheme.
FOR FURTHER INFORMATION, SEE KEYWORD(S):

[LBtutugen.help.inf]
- Exchange Schemes [TBtuxch001]
Veldnaam : tuxch001.dsca
Helptekst : FCxch001.dsca
2. Description The description of the Exchange Scheme.
Veldnaam : tuxch011.casf
Helptekst : FCxch002.casf
3. Ascii File Each ASCII file to be linked to a TRITON [LBtutugen.p.aa] table
is given a unique code, the ASCII code. After that, the format
can be defined for the ASCII file.
If you want to load automatically the format of the TRITON

table,
e.g. if you do not have a data definition file of the ASCII
file,
the ASCII file code entered here must be the same as the TRITON
table name. The formats of the ASCII file are defined in the
session Maintain Ascii File Format (tuxch0103m000)
[SEtuxch0103m000].
To maintain the ASCII file format (definition) for each
ASCII
file entered in the Exchange Scheme. You can specify the
characteristics of the fields in the ASCII file, such as
field
name, type, length, floating decimal, etc.

If the ASCII file has a data definition file generated
during
the export of data, the data definition can be loaded by
<Ctrl>[G]. If the ASCII file has no data definition file the
definitions of the TRITON table on the system can be loaded
or
the definitions can be entered manually.
[LBtctcgen.help.input] "Maintain Ascii File Codes
(tuxch0102m000)
[SEtuxch0102m000]".
To maintain ASCII file codes. These codes are maintained per
Exchange Scheme. For each ASCII file code the actual ASCII
file can be linked later. Within an Exchange Scheme this
code
is unique for each ASCII file definition.
- Ascii file master table [TBtuxch002]
4. Description The description of the ASCII file.
Veldnaam : tuxch011.ccon
Helptekst : FCxch011.ccon
5. Condition The data exchange processing can be manipulated by using
various
conditions at different places. The conditions can be defined
at
record level with the session "Maintain Table Relations
(Import)
(tuxch0121m000) [SEtuxch0121m000]" or at field level with the
session "Maintain Field Relations (Import) (tuxch0122m000)
[SEtuxch0122m000]"/"Maintain Field Relations (Export)
(tuxch0132m000) [SEtuxch0132m000]".
To maintain the table level relations. These relations are
maintained per batch in an exchange scheme.

Each batch line will have a TRITON [LBtutugen.p.aa] table
and
a ASCII file associated with it. One ASCII file may relate
to
more than one TRITON [LBtutugen.p.aa] table and also one
TRITON [LBtutugen.p.aa] table may relate to more than one
ASCII file.

- Table Relations for Import [TBtuxch021]
To maintain the field level relations. These relations are
maintained per batch and per batch line in an exchange
scheme.
All TRITON [LBtutugen.p.aa] fields which must be filled from
ASCII file fields must be specified as individual relations.
Fields which are not defined will remain empty in case of
the
new record needs to be added and old values will be retained
if the record already exists. At least all the fields of the
primary index of the TRITON [LBtutugen.p.aa] table must be
defined.
For loading the field relations automaticaly option <Ctrl>

[G]
can be used. This choice will create the relations for all
the
fields in the TRITON [LBtutugen.p.aa] table. The TRITON
field
will be filled with the ASCII field if the ASCII file
contains
fields of the same name as the TRITON [LBtutugen.p.aa]
field,
otherwise it will be left blank when default relations are
loaded.
This program allows the user to define the relations at
field
level. These relations are maintained per batch and per
batch
line in an exchange scheme. All ASCII fields which should be
filled from TRITON [LBtutugen.p.aa] tables specified in the
batch line should be entered. Fields of the ASCII file which
are not defined in field relations will be left empty.
Enter the Exchange Scheme, Batch, Batch line and Serial
Number.
- Enter the name of the ASCII field into which contents of
the corresponding TRITON [LBtutugen.p.aa] field should be
put into.
- The data type of the TRITON [LBtutugen.p.aa] field and the
corresponding ASCII field should match. If the ASCII field
is "numeric" the TRITON [LBtutugen.p.aa] field should be
of
type "numeric" only. If the ASCII field is of type
"multiline text" the TRITON [LBtutugen.p.aa] field
corresponding to it can be of type "text" only.
- If the TRITON [LBtutugen.p.aa] field is of type "array"
only
then can this field be entered. If the array element
entered
is greater than the depth of array an error message is
displayed.
- The constant field can only be maintained if the TRITON
[LBtutugen.p.aa] field is left blank. Constant value
entered
must be consistent with the type of ASCII field.
If you use the option <Ctrl>[G] to create the field

relations,
the fields specified for the ASCII file in the session
Maintain Ascii File Format (tuxch0103m000) [SEtuxch0103m000]
are filled in the field "Field Name". If the field name
matches the field name in the TRITON table, the field
"TRITON
field" will also be filled automatically. Otherwise, the
field
"TRITON Field" will be empty.
Depending upon the values returned by the condition, the

records
will be updated. The conditions have different types which can
be
specified on the field "Type of condition [TFtuxch011.tcon]".
Helptekst : FCxch011.tcon
The type of the condition is based on the kind of value that
is returned by the condition. The types of condition are:
Value [ENtuxch.tcon.value]
The conditions of this type return some value. The value may
be numeric or alphanumeric. For returning a value depending
upon the type of field being returned any of the two (or
both)
of the following functions may be used:
UPDATE.FIELD.STR(string.field)
or
UPDATE.FIELD.NUM(numeric.field)
While maintaining the field relations these type of

conditions
should be used.
True/False [ENtuxch.tcon.t.or.f]
The conditions of this type must return true or false value.
While maintaining table relations these type of conditions
should be used. For returning true/false value the
predefined
function RETURN.TF.VAL(true/false) should be used.
Both [ENtuxch.tcon.both]
These type of conditions return both the above type of
values,
ie. the actual values (string and/or numeric) and true or
false.
The condition can be used only if the condition script is

maintained. The condition script can be maintained in the text
editor. This script should have the syntax of TRITON 4GL. Also
predefined functions can be used. You can call the predefined
functions/variables running the session "Display Predefined
Functions/Variables (tuxch0510m000) [SEtuxch0510m000]".
A condition can be used for import or export of data (or for

both).
IMPORT DATA:
When a condition is being used for import of data, all the
ASCII
fields are readily available for use in the script. These
fields
need not be declared. The fields will contain the values from
the
current ASCII record.
EXPORT DATA:
When a condition is being used for export of data, all the
fields
from the TRITON [LBtutugen.p.aa] table from which export is
being
done become available. The fields will contain the values from
the current record from the TRITON [LBtutugen.p.aa] table.
However, it is mandatory to declare the TRITON [LBtutugen.p.aa]
table from which export is being done in condition script.
After the script is entered it must be compiled using option

<Ctrl>[G] or through session "Check Syntax of Conditions
(tuxch0206m000) [SEtuxch0206m000]".
6. Description The description of the condition.
Veldnaam : tuxch011.tcon
Veldnaam : txta.yn
Veldnaam : tuxch011.cmpl
2 Referentiehandleiding trefwoorden
DEFINITIE (tctcgen.htb.defin)

(tctcgen.help.input)
FOR FURTHER INFORMATION, SEE KEYWORD(S): (tutugen.help.inf)
Functions (tutuxchs0510.01)
HOW TO USE THE SESSION (tutugen.ses.use)
READ.TABLE (tutuxchs0510.03)
Helptekst : LBtuxchs0510.03
FUNCTION NAME
READ.TABLE - Function for reading TRITON table
SYNOPSYS
long READ.TABLE(ref string tablename(), long index.no,
key.field1
[, key.field2, key.field3, ...])
DESCRIPTION
This function is used to read a record from a TRITON
table. The argument tablename is a TRITON table name -
package, module and number together. Table name should
NOT
preceded by the character "t". If the table name is not
used as a variable it must be enclosed in double quotes.
Argument index.no is the index number on which the table
is to be read. Remaining arguments are values of the key
fields in respective order. Hence at least three
arguments
are necessary to read the table. The function reads the
TRITON table specified in the argument 'tabelname' for
import or export company (for import or export data
respectively). In this function a table is read with key
values as defined in the arguments. This reading will be
done for every record in the ascii file if the condition
is used at field relations level.
EXAMPLE:
read.ret = READ.TABLE("tiitm001", 1, item)
Where 'read.ret' is defined as long and 'item' is field
name from ascii file.
The return values for the function are:

0 : OK - read successful
1 : Error - read unsuccessful
READ.TABLE.COMPANY (tutuxchs0510.05)
FUNCTION NAME
READ.TABLE.COMPANY - Function for reading TRITON table
for
a specific company.
SYNOPSIS
long READ.TABLE.COMPANY(string tablename(), long
company.no, long index.no, key.field1 [, key.field2,
key.field3, ...])
DESCRIPTION
With this function it is possible to read record from
TRITON table of a specified company. The argument
tablename is a TRITON table name - package, module and
number together. Table name should NOT be preceded by
"t".
If table name is not used as a variable then it must be
enclosed in double quotes. The argument company.no is
acompany table of which is required to be read. Argument
index.no is the index number on which table is to be
read.
Remaining arguments are values of the key fields in
respective order. If argument company.no contains
current
company number then this function is same as READ.TABLE
function. Hence atleat four arguments are necessry to
read
the table.
EXAMPLE:
read.ret = READ.TABLE.COMPANY("tccom000", 000, 1, comp)
Where 'read.ret' is defined as long and 'comp' is a
field
name from ascii file.

READ.TABLE.ONCE (tutuxchs0510.04)
FUNCTION NAME
READ.TABLE.ONCE - Function for reading TRITON table only
once during the processing of a batch line.
SYNOPSIS
long READ.TABLE.ONCE(string tablename(), long index.no,
key.field1 [, key.field2,
key.field3,
...])
DESCRIPTION
With this function it is possible to read record from
TRITON table. This will increase the processing speed as
the table will NOT be read for every record from ascii
file (like in case of READ.TABLE function). The table
will
be read only once per batch line. This can be used for
parameter tables. The argument tablename is a TRITON
table
name - package, module and number together. Table should
NOT be preceded by "t". If table name is not used as a
variable then it must be eclosed in double quotes.
Argument index.no is the index number on which table is
to
be read. Remaining arguments are values of the key
fields
in respective order. Hence atleat three arguments are
necessry to read the table. The data will be read for
company for import or export is being done.
EXAMPLE:
read.ret = READ.TABLE.ONCE("tcmcs095", 1, "PUR", 5, 0,
"hisp") or
read.ret = READ.TABLE.ONCE("tiitm001", 1, item)
Where 'read.ret' is defined as long and
'item'
is a field name from ascii file.

RETURN.TF.VAL (tutuxchs0510.08)
FUNCTION NAME
RETURN.TF.VAL - Return true/false value.
SYNOPSIS
RETURN.TF.VAL(long tf.value)
DESCRIPTION
With this function it is possible to return true or
false
value depending upon different cases. This value will be
passed on to the import data program and actions will be
table based on this - like addition of new record,
delete
record, etc.
SESSION AIM (tutugen.ses.aim)
TRITON (tutugen.p.aa)
UPDATE.FIELD.INT (tutuxchs0510.18)
FUNCTION NAME
UPDATE.FIELD.INT - Update numeric field with contents of
type whole numbers.
SYNOPSIS
void UPDATE.FIELD.INT(long numeric.value)
DESCRIPTION
With this function it is possible to pass the contents
of
a numeric field to a TRITON field. Argument
numeric.value
can be any numeric field of type whole number like -
byte,
integer, long, date, enum value, etc. or a constant).
UPDATE.FIELD.NUM (tutuxchs0510.07)
FUNCTION NAME
UPDATE.FIELD.NUM - Update field with contents which are
fractions.
SYNOPSIS
void UPDATE.FIELD.NUM(double numeric.value)
DESCRIPTION
of
a numeric field to a TRITON field. Argument
numeric.value
can be any numeric field which is fraction like - float,
double or a constant.
UPDATE.FIELD.STR (tutuxchs0510.06)
FUNCTION NAME
UPDATE.FIELD.STR - Update field with contents in a
string.
SYNOPSIS
void UPDATE.FIELD.STR(string string.value(500))
DESCRIPTION
of
a string field to a TRITON field. Argument string .value
can be any string field (or a string constant). Maximum
length of such a string can be 500.
Variables (tutuxchs0510.02)
ascii.file.name (tutuxchs0510.16)
VARIABLE NAME
ascii.file.name - ASCII file name
TYPE
string of maximum length 100
DESCRIPTION
This field contains the name of the ASCII file used for
a
batch line. This name will be the actual file name being
read (ie. it will have extensions of '.e' or'.c' if
reprocessing is done during import of data).
ascii.file.rec (tutuxchs0510.09)
VARIABLE NAME
ascii.file.rec - ASCII file record
TYPE
string of maximum length 1024
DESCRIPTION
This field contains the record read from ASCII file.
element.no (tutuxchs0510.15)
VARIABLE NAME
element.no - Element number of array
TYPE
numeric
DESCRIPTION
This is element number of array, if the TRITON field
accessed by variable 'TRITON.field' is of type array.
This
variable along with TRITON.field specify the field to be
updated using the condition. This field is valid only if
condition is used at field relations level.
import.company (tutuxchs0510.17)
VARIABLE NAME
import.company - Company number for import
TYPE
long
DESCRIPTION
This is a numeric field of type 'long'. It contains the
company number for which import is being done. This
company number will be as specified on screen during
'Import Data' program or if not entered there then it
will
be as specified for a batch.
no.cond.rejects (tutuxchs0510.13)
VARIABLE NAME
no.cond.rejects - Number of records rejected due to
conditions
TYPE
Numeric(long)
DESCRIPTION
This variable contains the number of records rejected
because of conditions like - add condition, overwrite,
delete conditions, etc. while processing record from
ascii
file for the batch line. This variable can be useful for
conditions to be used for 'stop mechanism'.
no.err.rejects (tutuxchs0510.12)
VARIABLE NAME
no.err.rejects - Number of records rejected due to
errors
TYPE
Numeric(long)
DESCRIPTION
This variable contains the number of records rejected
because of errors like reference does not exist or
domain
range is invalid, etc. while processing record from
ascii
file for the batch line. This variable can be useful for
conditions to be used for 'stop mechanism'.
no.rec.read (tutuxchs0510.10)
VARIABLE NAME
no.rec.read - Number of records read
TYPE
Numeric(long)
DESCRIPTION
This variable contains the number of records read for a
batch line from the ascii file specified for the batch
line. This variable can be useful for conditions to be
used for 'stop mechanism'.
no.rec.write (tutuxchs0510.11)
VARIABLE NAME
no.rec.write - Number of records written
TYPE
Numeric(long)
DESCRIPTION
This variable contains the number of written records
(inserted or updated) for a batch line from the ascii
file
specified for the batch line. This variable can be
useful
for conditions to be used for 'stop mechanism'.
triton.field (tutuxchs0510.14)
VARIABLE NAME
triton.field - TRITON field name
TYPE
string of length 18
DESCRIPTION
This variable contains the name of triton field to which
the condition may be corrospponding. The field name will
contain 8 characters of the table name also eg.
tiitm001.item. This is valid only if the condition is
used
at field relations level.

Xchcond

Încărcat de

Informații document

Descriere originală:

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Xchcond

Încărcat de

Drepturi de autor:

Formate disponibile

1 Maintain Conditions (tuxch0111m000)

HOW TO USE THE SESSION [LBtutugen.ses.use]

HOW TO USE THE SESSION [LBtutugen.ses.use]

The object that will be created after compilation will be

If errors occur then , if "Path for Errors

Options: COPY & GLOBAL COPY

FOR FURTHER INFORMATION, SEE KEYWORD(S): [LBtutugen.help.inf]

FOR FURTHER INFORMATION, SEE KEYWORD(S):

If you want to load automatically the format of the TRITON

HOW TO USE THE SESSION [LBtutugen.ses.use]

HOW TO USE THE SESSION [LBtutugen.ses.use]

FOR FURTHER INFORMATION, SEE KEYWORD(S):

For loading the field relations automaticaly option <Ctrl>

If you use the option <Ctrl>[G] to create the field

Depending upon the values returned by the condition, the

While maintaining the field relations these type of

The condition can be used only if the condition script is

A condition can be used for import or export of data (or for

After the script is entered it must be compiled using option

De invoergegevens moeten worden gedefiniëerd in de sessie

FOR FURTHER INFORMATION, SEE KEYWORD(S): (tutugen.help.inf)

HOW TO USE THE SESSION (tutugen.ses.use)

The return values for the function are:

The return values for the function are:

The return values for the function are:

SESSION AIM (tutugen.ses.aim)

S-ar putea să vă placă și