| dadlllink_file |  |
| DLL Usage description This library contains functions for copying ASCII files from the source site to the target site and for compressing and decompressing ASCII files. Note on the function specifications: "iff" means "if and only if". DLL PROTOTYPES
    function extern long lfile.compress.or.uncompress.files(
                    long no.files,
                    const domain daxch.path file.name() fixed,
                    const long active.batl(),
                    long do.compress )

    pre   : The number of elements of the arrays(file.name, active.batl)
            Filenames in file.name array contain the full path name
    post  : If return then for all 1 <= n <= no.files where active.batl(n):
            the local file file.name(n) has been replaced by:
                    if do.compress = true: its compressed version
                    if do.compress = false: its uncompressed version
            For all 1 <= n <= no.files where not active.batl(n):
            no (un)compress action has been done
    return: False if at least one file to be (un)compressed could not be
            (un)compressed;
                    true if all files to be (un)compressed have been
                    (un)compressed successfully.
    desc  : This funcion is used to compress or uncompress the files.
            No file has to be (un)compressed have been (un)compressed
            sucessfully.

    function extern long lfile.retrieve.files(
                    domain daxch.link link,
                    long no.files,
                    const domain daxch.path source.file.name() fixed,
                    const domain daxch.path target.file.name() fixed,
                    const long active.batl(),
                    domain daxch.comp startup.company )

    pre   : The number of elements of the arrays (source.file.name,
            target.file.name, active.batl) >= no.files
            Filenames in source.file.name and target.file.name include
            the full path name.
    |N/a            For all 1 <= n <= no.files the directory of the
    |N/a            target.file.name(n) exists
    post  : If return then for all 1 <= n <= no.files where not
            isspace(source.file.name(n)) and active.batl(n):
            the file source.file.name(n) from the source system of
            the exchange link ha sbeen copied to a local file
            target.file.name(n).
    For all 1 <= n <= no.files where isspace(source.file.name(n))
            or not active.batl(n): no file has been copied
    return: False if the exchange link does not exist or at least one file
                    to be copied could not be copied;
                    True if all fiels to be copied have been copied
                    successfully

    desc  : This function is used to copy the files for a batch to import
            from the source system to the target system.
            No file has been copied if:
            - there is no corresponding export batch line at the source
              site (this is the case if the source.file.name is empty), or
            - the import batch line is inactive.
Related topics Libraries |