Big-Data-HPC-Platform/docs/ECLStandardLibraryReference/SLR-Mods/Replicate.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<sect1 id="Replicate">
  <title>Replicate</title>

  <para><emphasis role="bold">STD.File.Replicate <indexterm>
      <primary>STD.File.Replicate</primary>
    </indexterm> <indexterm>
      <primary>File.Replicate</primary>
    </indexterm> <indexterm>
      <primary>Replicate</primary>
    </indexterm> (</emphasis> <emphasis> filename </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis>, timeout </emphasis> <emphasis
  role="bold">] [</emphasis> <emphasis>, espserverIPport</emphasis> <emphasis
  role="bold">])</emphasis> <emphasis></emphasis></para>

  <para><emphasis>dfuwuid </emphasis> <emphasis role="bold">:=
  STD.File.fReplicate(</emphasis> <emphasis> filename </emphasis> <emphasis
  role="bold">[</emphasis> <emphasis>, timeout </emphasis> <emphasis
  role="bold">] [</emphasis> <emphasis>, espserverIPport</emphasis> <emphasis
  role="bold">]);</emphasis></para>

  <informaltable colsep="0" frame="none" rowsep="0">
    <tgroup cols="2">
      <colspec colwidth="80.50pt" />

      <colspec />

      <tbody>
        <row>
          <entry><emphasis>filename</emphasis></entry>

          <entry>A null-terminated string containing the logical name of the
          file.</entry>
        </row>

        <row>
          <entry><emphasis>timeout</emphasis></entry>

          <entry>Optional. An integer value indicating the timeout setting. If
          omitted, the default is -1. If set to zero (0), execution control
          returns immediately to the ECL workunit without waiting for the DFU
          workunit to complete.</entry>
        </row>

        <row>
          <entry><emphasis>espserverIPport</emphasis></entry>

          <entry>Optional. A null-terminated string containing the protocol,
          IP, port, and directory, or the DNS equivalent, of the ESP server
          program. This is usually the same IP and port as ECL Watch, with
          “/FileSpray” appended. If omitted, the default is the value
          contained in the lib_system.ws_fs_server attribute.</entry>
        </row>

        <row>
          <entry><emphasis>dfuwuid</emphasis></entry>

          <entry>The attribute name to receive the null-terminated string
          containing the DFU workunit ID (DFUWUID) generated for the
          job.</entry>
        </row>
      </tbody>
    </tgroup>
  </informaltable>

  <para>The <emphasis role="bold">Replicate </emphasis>function copies the
  individual parts of the <emphasis>filename</emphasis> to the mirror disks
  for the cluster. Typically, this means that the file part on one node's C
  drive is copied to its neighbors D drive.</para>

  <para>Example:</para>

  <programlisting format="linespecific">A := STD.File.Replicate('Fred');</programlisting>
</sect1>