'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH "SLONIK DEFINE" 7 "24 July 2014" "" "Slony-I 2.2.3 Documentation"
.SH NAME
DEFINE \- Defining a named symbol 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBdefine \fR\kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fI name \fR] [\fI value \fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
This defines a named symbol. Symbol names must follow the
slonik rules for constructing identifiers, by starting with a
letter, followed by letters, numbers, and underscores.
.PP
Symbol values may contain spaces and may recursively contain
symbol references.
.PP
Symbols are referenced by using a \(oq@\(cq followed by
the symbol name. Note that symbol referencing is suppressed
inside string literals.
.SH EXAMPLE
.nf
\*(T<define    cluster movies;
define    sakai   1;
define    chen    2;
define    fqn     fully qualified name;

cluster name = @cluster;
node @sakai admin conninfo = 'service=sakai\-replication';
node @chen  admin conninfo = 'service=chen\-replication';
define setMovies    id = 1;
define sakaiMovies  @setMovies, origin = @sakai;

create set ( @sakaiMovies, comment = 'movies' );

set add table( set @sakaiMovies, id = 1, @fqn = 'public.customers', 
               comment = 'sakai customers' );
set add table( set @sakaiMovies, id = 2, @fqn = 'public.tapes',     
               comment = 'sakai tapes' );
echo 'But @sakaiMovies will display as a string, and is not expanded';
    \*(T>
.fi
.SH "VERSION INFORMATION "
This command was introduced in Slony-I 1.1