1.16 Syncfile commands

Syncfile commands let you manage the Syncfile utility, which duplicates entire files on a scheduled basis.

Use the VIEW REPORT command to view the output of Syncfile.

1.16.1 ADD SYNCFILE

Use ADD SYNCFILE to define a Syncfile group before starting Syncfile.

Using ADD SYNCFILE options you can:

Specify alternative names for the parameter file, the report file, or the Syncfile process
Specify a primary and backup CPU and associated NonStop priority

Syntax

ADD SYNCFILE group_name 
[, PARAMS param_file_name]
[, REPORT report_file] 
[, PROGRAM program_name]
[, PROCESS process_name]
[, CPU primary_cpu] 
[, BACKUPCPU cpu] 
[, PRI priority]
[, DESC "text"]

group_name: A Syncfile group. You can use wildcards to specify a set of group names, such as * or *FIN*.
PARAMS param_file_name: The Syncfile parameter file name.
REPORT report_file: The name of the report file to which Syncfile writes messages.
PROCESS process_name: The process name. See "Specifying an Alternative Process".
PROGRAM program_name: The name of the object to be run. See "Executing user exits".
CPU primary_cpu: The primary CPU name.
BACKUPCPU cpu: The CPU to use in the event the primary CPU is not available when starting or restarting Syncfile.
PRIORITY priority: The NonStop operating system priority.
DESC "text": A description of the Syncfile process.

1.16.2 ALTER SYNCFILE

Use ALTER SYNCFILE to change an existing Syncfile group. Generally, you will use ALTER SYNCFILE to change CPU, BACKUPCPU or PRIORITY options.

Syntax

ALTER SYNCFILE group_name [, option]

group_name: A Syncfile group. You can use wildcards to specify a set of group names, such as * or *FIN*.
option: ALTER SYNCFILE uses the same options as ADD SYNCFILE.

1.16.3 DELETE SYNCFILE

Use DELETE SYNCFILE to delete a Syncfile group.

Syntax

DELETE SYNCFILE group_name

group_name: A Syncfile group. You can use a wildcard in the name.

1.16.4 INFO SYNCFILE

Use INFO SYNCFILE to display information about one or more Syncfile processes, including whether the process is running, and the date of the last time started.

Syntax

INFO SYNCFILE group_name [, DETAIL]

group_name: A Syncfile group. You can use a wildcard in the name.
DETAIL: Provides information regarding parameter, report files, process names and other information.

1.16.5 KILL SYNCFILE

Use KILL SYNCFILE to force a Syncfile process to stop immediately. Try STOP SYNCFILE first because it also performs cleanup work. KILL SYNCFILE is preferable to stopping Syncfile from TACL, which can result in Manager automatically restarting the process.

Syntax

KILL SYNCFILE group_name

group_name: A Syncfile group. You can use a wildcard in the name.

1.16.6 START SYNCFILE

Use START SYNCFILE to start one or more Syncfile processes. Manager receives the START request and starts and monitors the Syncfile process.

Syntax

START SYNCFILE group_name

group_name: A Syncfile group. You can use a wildcard in the name.

1.16.7 STATUS SYNCFILE

Use STATUS SYNCFILE to display the status of the Syncfile group.

Syntax

STATUS SYNCFILE group_name

group_name: A Syncfile group. You can use a wildcard in the name.

1.16.8 STOP SYNCFILE

Use STOP SYNCFILE to stop one or more Syncfile processes gracefully. Using this command lets you make configuration changes without affecting the operation of future Syncfile runs, and ensures that Manager will not restart the process.

Syntax

STOP SYNCFILE group_name

group_name: A Syncfile group. You can use a wildcard in the name.