(B)0[mD[4mEFINE[m [4mSCHEDULE[m qq> FOR qq> transfer-name qqqk
lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj
mqqqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqk
mqq> [4mSTART[m qq> start-date-time qqqj x
lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj
mqqqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqk
mqq> [4mEVERY[m qqwq> every-delta-time qqqqqwqqj x
mq> every-absolute-time qqj x
lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj
mqwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwqk
mq> [4mRETRY[m q> count q> [4mTIMES[m qwqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqwj x
mq> [4mRETRY[m [4mEVERY[m qq> delta-time qj x
lqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj
mqq> [4mEND[m qwqqqqqqqqqqqqqqqqqqqwqwqqqqqqqqqqqqqwqqq> .
mqq> transfer-name qj mq> SCHEDULE qj
1 – transfer-name
The transfer for which this schedule is being defined. The
transfer must already exist when you create a schedule definition
for it. The transfer-name parameter is required.
2 – start-date-time
The time to execute the initial transfer. You can specify an
absolute or delta time. If you supply an absolute time, the
initial transfer will be executed at the time specified. If you
use a delta time, Replication Option uses the current time and
the delta-time value to calculate the actual transfer time. The
START clause is optional. If you do not include a START clause,
the start time is set to the current time so that the transfer
will execute as soon as the transfer schedule definition is
processed.
The start-date-time parameter uses the following absolute and
delta-time formats. You can omit any of the trailing fields in
the date or time. You can omit any of the fields in the middle
of the format as long as you include the punctuation marks. For
more information on date and time formats, see the entry on the
$BINTIM OpenVMS system service in the OpenVMS documentation set.
Absolute-time
dd-mmm-yyyy hh:mm:ss.cc
Delta time
dddd:hh:mm:ss.cc
In the absolute and delta time designations, the abbreviations
have the following meanings:
dddd Number of days
dd Day of the month
mmm Month
yyyy Year
hh Hours
mm Minutes
ss Seconds
cc Hundredths of a second
3 – every-delta-time
Used to calculate the time to execute the next transfer. The
EVERY clause is optional. If you specify the EVERY clause, you
must specify either every-delta-time or every-absolute-time. If
you omit the EVERY clause, the transfer occurs only once.
The valid specification for every-delta-time is the delta format
used by the $BINTIM OpenVMS system service. The delta time you
specify is the time from the completion of the last transfer
sequence until the start of the next one. A transfer sequence
is the set of transfers from the first attempt until one of the
following conditions is met: the execution is successful, the
maximum number of retries specified in the RETRY clause has been
reached, or a fatal error has occurred (one for which retries are
not attempted).
4 – every-absolute-time
(B)0[mevery-absolute-time =
qqqqqwqqqqqq> [4mDAY[m qqqqqqwqqwqqqqqqqqqqq>qqqqqqqqqwqwqqq>
tqqqqqq> [4mWEEK[m qqqqqu mqq> [4mAT[m qq> at-time qqj x
tqqqqqq> [4mMONTH[m qqqqj x
mqqwqqq> weekday qqqwqqqqqqqqqq>qqqqqqqqwqqwqqj
x mq> [4mAT[m qq>at-time qqj x
mqqqqqqqqqqqqqqqq , <qqqqqqqqqqqqqqqqqqqj
Used to calculate the time to execute the next transfer. The
EVERY clause is optional. If you specify the EVERY clause, you
must specify either every-absolute-time or every-delta-time. If
you omit the EVERY clause, the transfer occurs only once.
4.1 – DAY
The transfer executes on a daily basis.
4.2 – WEEK
The transfer occurs every week on the same day of the week as the
initial transfer.
4.3 – MONTH
The transfer occurs on a monthly cycle on the same day of the
month as the initial transfer.
Note that if the initial transfer starts on the 31st of the
month and the transfer schedule specifies EVERY MONTH, the
next execution of the transfer will be on the last day of the
following month, whether the last day is the 28th, 29th, 30th, or
31st.
4.4 – weekday
The transfer executes on the weekdays that you list. If you
list more than one weekday, separate the days with commas. Valid
weekday specifications are:
SUNDAY
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
4.5 – at-time
Qualifies every-absolute-time by specifying the time of day at
which the transfer should occur. This parameter is optional.
If you specify DAY, WEEK, or MONTH, but do not specify an at-
time, Replication Option uses the time of day of the initial
transfer. In the case of a list of weekdays, the at-time for
each day can be specified. If the at-time for any weekday is not
specified, the default is the time used for the previous entry in
the list. For the first entry in the list, the time of day of the
initial transfer is used, if none is specified.
5 – count
The maximum number of times to retry a transfer if a transfer
execution fails. If you do not include a retry count or if the
count value is set to zero, Replication Option does not attempt
to retry the transfer until the next scheduled transfer time as
indicated by the EVERY clause.
Replication Option does not retry a transfer if the transfer
failed as a result of a fatal error. You can recover from a fatal
error only by manual intervention.
6 – delta-time
The length of time Replication Option waits between the time of
the last failed attempt and the time of the next retry attempt.
The RETRY EVERY delta-time clause is optional and can only be
specified if the RETRY count TIMES clause is included.
If you specify RETRY count TIMES in the schedule definition,
but do not specify RETRY EVERY delta-time, Replication Option
attempts the retry immediately. See the description of the start-
date-time parameter earlier in this section for valid delta-time
values.