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.
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
[, <a id="d21317e76"></a>PARAMS param_file_name]
[, <a id="d21317e85"></a>REPORT report_file]
[, <a id="d21317e95"></a>PROGRAM program_name]
[, <a id="d21317e104"></a>PROCESS process_name]
[, <a id="d21317e113"></a>CPU primary_cpu]
[, <a id="d21317e123"></a>BACKUPCPU cpu]
[, <a id="d21317e132"></a>PRI priority]
[, <a id="d21317e141"></a>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.
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.
DELETE SYNCFILE
Use DELETE SYNCFILE to delete a Syncfile group.
Syntax
DELETE SYNCFILE group_namegroup_name
A Syncfile group. You can use a wildcard in the name.
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.
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_namegroup_name
A Syncfile group. You can use a wildcard in the name.
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_namegroup_name
A Syncfile group. You can use a wildcard in the name.
STATUS SYNCFILE
Use STATUS SYNCFILE to display the status of the Syncfile group.
Syntax
STATUS SYNCFILE group_namegroup_name
A Syncfile group. You can use a wildcard in the name.
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_namegroup_name
A Syncfile group. You can use a wildcard in the name.