chepoch

Changes epoch number estimates

Applicability

Product Command type
MultiSite multiutil subcommand
Platform
Windows™

Synopsis

chepoch


[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser user-name [ –p/assword ] password { [ –f/orce ]
replica [ replica=value ... ] }

Description

This command changes a replica's epoch number estimates for other replicas. You cannot change a replica's own epoch numbers because they record the actual state of the replica.

Restrictions

You must have Super User privileges.

Options and arguments

Specifying the clan, site, and family

Default
Clan: First clan replicated at this site. If there is more than one dbset connection registered on this host, –clan is required.

Site: Current site. If there is more than one site on this host, –site is required.

Family: No default; you must specify a family.

–cl/an clan-name
Name of the replica’s clan.
–site site-name
Name of the replica’s site.
–fam/ily family-name
User database family: Database name given to the user database when it was created.

Schema repository family: The family name is MASTR.

Specifying a user name and password

Default
You must specify a user name and password.
–u/ser user
Name of a user with Super User privileges.
–p/assword password
Password associated with the specified user.

Suppressing interactive prompts

Default
You must confirm each change.
–f/orce
Suppresses confirmation steps.

Specifying the changes

Default
You must specify the replica whose estimated epoch numbers are to be changed. chepoch reads a set of replica=value pairs, one per line, from standard input. You can copy and paste lsepoch output, or type the data in the format described below. Extra white space is allowed. To terminate input, type a period character ( . ) and a carriage return (<CR>) at the beginning of a line.
replica
Site name of the replica whose estimated epoch numbers are to be changed; that is, it changes the current replica's estimate of the state of replica.
replica=value
One or more arguments, where:
replica
Column of the epoch number matrix. This argument, along with the preceding replica argument, specifies a particular location in the matrix.
value
New epoch number to be entered at the specified matrix location.

Examples

In these examples, the lines are broken for readability. You must enter each command on a single physical line.

  • Change two columns of epoch estimates in the boston_hub replica's row for the sanfran_hub replica.



    multiutil chepoch -clan telecomm -site boston_hub -family SAMPL -user
    susan -p passwd sanfran_hub sanfran_hub=100 boston_hub=350


    Multiutil: Change the estimate for the epochs of site `sanfran_hub'
    replayed at site `sanfran_hub' to 100 [yes|NO|quit]     yes


    Multiutil: Change the estimate for the epochs of site `boston_hub'
    replayed at site `sanfran_hub' to 350 [yes|NO|quit]     yes


    Multiutil: 2 epoch estimate(s) for site `sanfran_hub' successfully
    changed; 0 failures.
    Multiutil: Estimates of the epochs from each site replayed at site
    `sanfran_hub' (@goldengate):
    BOSTON_HUB: 350
    SANFRAN_HUB: 100

  • Similar to preceding example, but use –force to suppress confirmation steps.



    multiutil chepoch -clan telecomm -site boston_hub -family SAMPL -user
    susan -p passwd sanfran_hub sanfran_hub=100 boston_hub=350 -force


    Multiutil: Estimates of the epochs from each site replayed at site
    `sanfran_hub' (@goldengate):
    BOSTON_HUB: 350
    SANFRAN_HUB: 100