HP AutoSYNC User’s Guide Abstract HP NonStop™ AutoSYNC™ software is a reliable, fault-tolerant, and automatic subsystem for replicating files through synchronization. This manual describes the uses, installation, and all other operational aspects of AutoSYNC. Product Version AutoSYNC AAU Supported Release Version Updates (RVUs) This manual supports all J-series RVUs, all H-series RVUs, and all G-series RVUs, until otherwise indicated in a replacement publication.
Document History Part Number Product Version Published 522580-015 NonStop AutoSYNC AAQ (Update 14) January 2011 522580-016 NonStop AutoSYNC AAR (Update 15) June 2011 522580-017 NonStop AutoSYNC AAT (Update 16) February 2012 522580-018 NonStop AutoSYNC AAU (Update 17) November 2012
Legal Notices Copyright 2012 Hewlett-Packard Development Company L.P. Legal Notice Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
HP AutoSYNC User’s Guide Index Tables . Legal Notices 1.
Contents 3. One-time Synchronization Authorize AutoSYNC 2-7 Update the System Coldload and Shutdown Procedures 2-8 Install the AutoSYNC EMS templates 2-8 Shutting Down AutoSYNC 2-8 Installing a New Version of AutoSYNC 2-9 Running Different Versions of AutoSYNC 2-9 Special Cases: Privileged Synchronization Processes 2-10 3.
Contents 4.
Contents 5.
Contents 7. Synchronization Over TCP/IP TRIGGERONFILESET 6-3 TRIGGERONFILESET Arguments Trigger Output 6-3 Triggers and TIMEEXACT 6-3 Troubleshooting triggers 6-4 Examples 6-4 TRIGGER examples 6-4 TRIGGERONFILESET Example 6-7 Note on Triggers that invoke SQLCI 6-7 6-3 7.
Contents 8.
Contents 9. Reporting Function PURGEDATA 8-81 RENAME 8-81 RESET 8-82 RESET GLOBAL 8-82 RESET LOCAL 8-83 REPORT 8-84 RUN[D] 8-87 START MONITOR 8-88 STATS 8-89 STATUS AUTOSYNC 8-89 STATUS BATCHID 8-90 STATUS MONITOR 8-91 STATUS SYNC 8-92 STATUS SYNCFILESET 8-93 STOP MONITOR 8-94 ABEND MONITOR 8-95 SUSPEND BATCHID 8-95 SUSPEND SYNCFILESET 8-95 SUSPEND SYNCUSER 8-96 SYNCHRONIZE 8-96 TIME 8-112 UPDATE 8-113 UPGRADE MAPDB 8-116 VOLUME 8-116 9.
Contents B.
Contents C. Examples Scheduled Synchronization Problems B-2 The source synchronization process creation fails with security violation B-2 The destination synchronization process creation fails with a security violation B-2 The destination synchronization process starts but fails to log down to the sync user ID B-2 Errors replacing destination files B-2 Synchronization of OSS files fails with error 4001 or error 4013.
Contents Table 2-1. Table 2-2. Table 8-1. Table 8-2. Table 8-3. Table A-1. Table A-2.
What’s New in This Manual Manual Information HP AutoSYNC User’s Guide Abstract HP NonStop™ AutoSYNC™ software is a reliable, fault-tolerant, and automatic subsystem for replicating files through synchronization. This manual describes the uses, installation, and all other operational aspects of AutoSYNC.
What’s New in This Manual New and Changed Information Added a paragraph discussing TIMEEXACT used with triggers. See Triggers and TIMEEXACT on page 6-3.
About This Manual This manual describes the uses, installation, and all other operational aspects of HP AutoSYNC. AutoSYNC is a reliable, fault-tolerant, and automatic subsystem for replicating files through synchronization. File synchronization is a complementary alternative to data replication for disaster recovery. Data replication is used primarily for database files; it replicates each record update that occurs in a database transaction.
About This Manual General Syntax Notation each side of the list, or horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: FC [ num ] [ -num] [ text] K [ X | D ] address-1 { } Braces. A group of items enclosed in braces is a list from which you are required to choose one item. The items in the list may be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines.
About This Manual Notation for Messages Line Spacing. If the syntax of a command is too long to fit on a single line, each continuation line is indented three spaces and is separated from the preceding line by a blank line. This spacing distinguishes items in a continuation line from items in a vertical list of selections. For example: ALTER [ / OUT file-spec / ] LINE [ , attribute-spec ]... !i and !o.
About This Manual Notation for Messages Nonitalic text. Nonitalic letters, numbers, and punctuation indicate text that is displayed or returned exactly as shown. For example: Backup Up. lowercase italic letters. Lowercase italic letters indicate variable items whose values are displayed or returned. For example: p-register process-name [ ] Brackets. Brackets enclose items that are sometimes, but not always, displayed.
About This Manual Notation for Management Programming Interfaces Notation for Management Programming Interfaces The following list summarizes the notation conventions used in the boxed descriptions of programmatic commands, event messages, and error lists in this manual. UPPERCASE LETTERS. Uppercase letters indicate names from definition files; enter these names exactly as shown. For example: ZCOM-TKN-SUBJ-SERV lowercase letters.
About This Manual Change Bar Notation HP AutoSYNC User’s Guide—522580-018 xviii
1 AutoSYNC Overview Introduction HP NonStop AutoSYNC software (AutoSYNC) provides automatic synchronization for HP NonStop server disk files. File synchronization is a complementary alternative to data replication for disaster recovery. Data replication is used primarily for database files; it replicates each record update that occurs in a database transaction.
Product Overview AutoSYNC Overview Product Overview This section gives a brief overview of AutoSYNC; a more complete description can be found in later sections. File Sets AutoSYNC synchronizes Enscribe files and SQL tables between pairs of source and destination locations. These locations are described by file set patterns, such as $DATA.APP*.*OBJ.
Fault Tolerance and File Recovery AutoSYNC Overview To configure a scheduled synchronization, a user must be added to the AutoSYNC system. An AutoSYNC administrator enables users to schedule synchronizations and can specify a maximum priority and select CPUs that the user should use. The AutoSYNC administrator can also suspend and activate a user without changing the user’s configuration. Fault Tolerance and File Recovery Scheduled synchronizations are managed by a fault-tolerant process pair.
Reporting AutoSYNC Overview Reporting It is often difficult to measure how dynamic your processing environment really is. The reporting function allows you to evaluate the amount of change that occurs on the file sets you wish to synchronize, without performing the actual data movement. Reporting is useful for planning system migrations and for configuring the frequency of scheduled synchronizations, either for disaster recovery or for data distribution purposes.
System and Map Databases AutoSYNC Overview communicate efficiently to compare file information and pass a stream of data containing the files that need to be copied. System and Map Databases Each system that has AutoSYNC installed has a single system database (SysDB) either in the subvolume $SYSTEM.ESCSYSDB or in the ESCSYSDB subvolume on some other disk volume. This database is a central reference point for other AutoSYNC components.
AutoSYNC Overview AutoSYNC in a Network of Systems HP AutoSYNC User’s Guide—522580-018 1-6
2 Installation This section discusses the procedure to follow for the initial installation of AutoSYNC. The topics covered are organized as follows: Prerequisites Installing AutoSYNC Installing a New Version of AutoSYNC Running Different Versions of AutoSYNC Special Cases: Privileged Synchronization Processes Prerequisites The AutoSYNC (SysDB and MapDB) configuration is stored in a set of audited SQL tables. The HP NonStop TMF product must be installed and configured.
Move Files from the Product Media to the Installation Subvolume Installation Privileged Synchronization Processes on page 2-10 for details. The entire process should take only a few minutes. In addition to the installation instructions contained in this manual, you should have your AutoSYNC system licensing instructions available. Move Files from the Product Media to the Installation Subvolume The AutoSYNC product media contains the files listed in Table 2-1.
Start an EMS Distributor Installation Then execute the INSTALL macro as follows:. VOLUME $.ZAUTOSYC RUN INSTALL You may specify a subvolume in which to install the AutoSYNC operational files. In a network of systems, where application software might be copied from one system to another, choose a volume and subvolume that can be specified on all systems. The example below shows the installation to subvolume $ALLOBJ.AUTOSYNC: volume $system.zautosyc $SYSTEM ZAUTOSYC 3> install $allobj.
Create the AutoSYNC System Database Installation Create the AutoSYNC System Database Each system running AutoSYNC maintains system-level parameters stored in a small set of tables to control the overall operation of the product. This set of tables is referred to as the System Database (SysDB). If you have already installed HP NonStop AutoTMF software, the SysDB has already been created and will be used by AutoSYNC.
License AutoSYNC Installation volume as the SysDB tables). You may also specify a particular catalog. See CREATE SYSDB on page 8-65 for details on the command. AutoSYNC 1? create sysdb on $data; --- SQL Catalog $DATA.ESCCATLG is being created. --- SQL Catalog $DATA.ESCCATLG has been created. --- SysDB table $DATA.ESCSYSDB.MAPDBS created. --- SysDB table $DATA.ESCSYSDB.REGISTRY created. * Error * The monitor process $ZASY is not executing. * 652 * To start a monitor, issue the START MONITOR command.
Start the Monitor Process Installation The CREATE MAPDB command creates the SYNCUSER table, to store user information and the REGISTRY table to store global parameters. The scheduled synchronization configuration tables and log files are added later, as sync file sets are configured for each syncuser. See Appendix A, Operations and Management, for details on the additional MapDB tables. AutoSYNC 3? create mapdb; --- MapDB table $DATA.ASYMAPDB.REGISTRY created. --- MapDB table $DATA.ASYMAPDB.
Authorize AutoSYNC Installation For example: 26> autosync HP Nonstop(tm) AutoSYNC(tm) Command Interpreter(T2713H01) - System \BLPROD (C)2010 Hewlett Packard Development Company, L.P. (C)2010 Carr Scott Software Incorporated * Error * The monitor process $ZASY is not executing. * 652 * To start a monitor, issue the START MONITOR command. AutoSYNC 1? start monitor; --- Starting Monitor process $ZASY AutoSYNC Monitor 1.9.
Update the System Coldload and Shutdown Procedures Installation designating a user ID as the Authorizer. Only users that are “under” the Authorizer can schedule synchronizations. See The AutoSYNC Authorizer on page 4-2 for details. By default, the Authorizer is the user ID of the monitor process. To designate the Authorizer explicitly, log on as the desired user ID and use the AUTHORIZE command. The command sets the ownership of the ASYSYNCP process to the Authorizer through the PROGID file attribute.
Installing a New Version of AutoSYNC Installation 1. Use the SUSPEND SYNCUSER command to suspend all AutoSYNC users. 2. Wait for active synchronizations to complete. Use the STATUS SYNC command to display the active synchronizations. 3. Stop the AutoSYNC monitor process with the AUTOSYNC command STOP MONITOR. Note that there are no ill effects resulting from stopping the monitor without first suspending the syncusers.
Installation Special Cases: Privileged Synchronization Processes For details on configuring and using an alternate environment, see Configuring and Using an Alternate AutoSYNC Environment on page A-7.
3 One-time Synchronization This section presents a basic overview of AutoSYNC processing and the various options available for performing a one-time synchronization of Guardian files. AutoSYNC also supports the synchronization of OSS files, as described in Section 5, OSS File Synchronization. Most of the features described in this section also apply to scheduled synchronization, described in Section 4, Scheduled Synchronization.
One-time Synchronization File Sets File Sets The file sets describe the collection of files to be synchronized. A file set is a standard file pattern, such as \MYSYS.$DATA*.OBJ*.SERV*. There are a few restrictions on the source and destination file sets. Source file set Destination file set Source File Set to Destination File Set File Set Comparison Source file set The source file set must describe only local files.
One-time Synchronization File Set Comparison File Set Comparison AutoSYNC creates a list of all file names in the source file set. Some files are not eligible for synchronization; these files include: Files that are opened exclusively. AutoSYNC cannot gain access to such files. Files that are opened for update. Copying files that are being updated often results in corrupt files. You can request such files to be synchronized by using the OPENUPDATE option. Broken or corrupt files.
One-time Synchronization Data Transfer and File Replacement A corrupt or broken destination file is always replaced, even if it is newer than the source file. Files that do not have the same modification times are synchronized if the TIMEEXACT option is specified. Data Transfer and File Replacement Once the list of files to be synchronized is complete, AutoSYNC transfers the files using an efficient data-streaming protocol.
One-time Synchronization Ownership and Security synchronized files on the destination system. Thus, you can change security attributes as follows: Source file security Remote destination file security “A” or “N” “N” “G” or “C” “C” “O” or “U” “U” “-” “-” You may use the SECURE or NO NETWORKSECURE option to override the default security setting. Default PURGE Security To be replaced by AutoSYNC, existing destination files must be secured for purge access.
One-time Synchronization Alternate Key Files does not change the security string of the destination file and it remains the same as the source file. If the user chooses to preserve security attributes on the destination system, subsequent synchronizations could fail. For example a PURGE security of “O” preserved on the destination system will prevent further synchronizations because the file can only be replaced by the local (destination) owner of the file.
One-time Synchronization SQL Tables and Catalogs Example 1 File $DATA.DB.ACCT has one alternate key, $DATA.DB.ACCTAK. The following command synchronizes both the file ACCT and its alternate key ACCTAK to $BACKUP.DBBACK on the destination system: SYNC $DATA.DB.ACCT* to \DEST.$BACKUP.DBBACK.*; Note that no MAPNAMES file is required. Example 2 File $DATA.DB.ACCT has its alternate key ACCTAK on subvolume $KEYS.DBKEYS.
One-time Synchronization SQL Views If the index tables reside in a different subvolume than the base table in the source file set, use the MAPNAMES option to specify the mapping of the source names to the destination names. The destination file set must be defined using a filename that has the wild-card character asterisk (*); otherwise SQL tries to restore indexes and base table to the same filename. SYNC $DATA.SQLTBL.MYTBL TO \DEST.$DATA.SQLTBL.
One-time Synchronization Partitioned Files and Tables PARTONLY synchronization of single partitions is not supported. An error message is generated if a secondary partition is specifically selected to be synchronized. When selecting a partitioned file for synchronization, AutoSYNC retrieves the aggregate modification time to compare source and destination modification times.
One-time Synchronization Partitioned Files and Tables Changing Subvolume and File Name Mapping Non-partitioned file To synchronize the single partition file $DATA01.DB.FILE to subvolume and file BACKDB.BACKFILE, use the following command: SYNC $DATA01.DB.FILE TO $DATA01.BACKDB.BACKFILE,...; Partitioned file To synchronize the partitioned file $DATA*.DB.PARTFILE to different subvolume and file names $DATA*.BACKDB.BACKFILE, the command must specify the primary partition mapping, SYNC $DATA01.DB.
One-time Synchronization Partitioned Files and Tables are equivalent to: \SOURCE.$DATA.*.* TO \DEST.$BACK.*.* \NEWYORK.$DATA*.DB.* TO \DEST.$BACK.BACKUPDB.* \SOURCE.$DATA*.DB.PARTFILE TO \TOKYO.*.*.* By default, name mapping is performed by RESTORE with the assistance of the default MAP NAMES clause provided by AutoSYNC. The default clause is: MAP NAMES ( source-file-set TO dest-file-set, source-system.*.*.
One-time Synchronization Synchronization Options mapping entries follow file mapping entries, and are preceded by the keyword “CATALOGS:”, including the colon (:), as follows: $DATA TO $BACK \NEWYORK.$DATA*.DB TO $BACK.BACKUPDB $DATA*.DB.PARTFILE TO \TOKYO.* CATALOGS: $CATS.BACKCAT FOR $BACK.*.* $CATS.DBCAT FOR $BACK.BACKUPDB.* \TOKYO.$CATS.DBCAT for \TOKYO.*.*.* CATALOGS entries are checked for proper syntax, and passed along to the RESTORE process.
One-time Synchronization Making Exact Copies Making Exact Copies By default, AutoSYNC does not synchronize a file if the destination file was modified more recently than the source file. This behavior allows you to customize the destination file for local use. When AutoSYNC synchronizes a file, the two files are exactly the same, including the modification time stamp.
One-time Synchronization Purging Extra Subvolumes in the Destination File Set Excluded Files and Purge The exclude list specified by the EXCLUDE option applies only to source files. It does not apply to files in the destination that do not exist on the source. Therefore file in the exclude list that do not exist on the source are considered for purging on the destination (they are not excluded from purge).
One-time Synchronization Files Opened for Update A synchronized file, table, index or view does not replace an existing object of a different type. Files Opened for Update By default, AutoSYNC does not synchronize a file from the source file set if the file is opened for update. Synchronizing such files could result in a loss of data integrity.
One-time Synchronization Synchronizing Based on Ownership Note that for OSS files, only SUPER.SUPER can change the ownership of a file on the destination. Moreover, using the OWNER option does not change the group id of the file. To change the group id, the user must also specify the OWNERGROUP option. Synchronizing Based on Ownership By default, source files owned by all user can be candidates for synchronization, provided the security settings allow it.
One-time Synchronization Changing File Security To avoid replacing object files that have not changed, configure AutoSYNC to compare source and destination binder or linker timestamps instead of comparing MODIFICATION timestamps by specifying the USEBINDERTIME option. The destination object file is replaced only if the binder or linker timestamps of the source and destination do not match exactly; the comparison operates as if TIMEEXACT were specified.
One-time Synchronization Process Priority and Throttling The use of compression can be set globally through the global parameter [AUTO]SYNCCOMPRESS or, for a specific synchronization, through the COMPRESS option. Process Priority and Throttling You may specify a process PRIORITY for a synchronization to ensure that synchronization does not impact higher priority work. Specifying the PRIORITY might be especially useful if you have enabled compression.
One-time Synchronization Reporting Outcome of the Synchronization In some operational environments, access to these programs is restricted. To use AutoSYNC, you may need to obtain, license, and secure separate copies of BACKUP and RESTORE. You specify the alternate program names through the BACKUP and RESTORE options. Number of Files per BACKUP Process BACKUP performance degrades significantly when the number of files is large.
One-time Synchronization Keeping NOPURGEUNTIL Attribute the first place. You must be the Super user to preserve the LICENSE attribute; you must be the file owner (or the owner’s manager or the Super user) to preserve the PROGID attribute. If you synchronize such an object file to a remote destination, the file is moved, but those attributes are removed. AutoSYNC issues a warning message for each file that has its attributes removed.
One-time Synchronization Running the Destination Synchronization Process as a Local Process Running the Destination Synchronization Process as a Local Process To enable ASYSYNC or ASYSYNCP to become a local process on a remote system, perform the following operations on the ASYSYNC or ASYSYNCP program on the destination system: 1. In BIND, issue the following commands: ADD * FROM ASYSYNC SET LIKE ASYSYNC ALTER CALLABLE^LOCAL^LOGON, CALLABLE ON SET SAVEABEND ON BUILD ASYSYNC! 2.
One-time Synchronization Running the Destination Synchronization Process as a Local Process HP AutoSYNC User’s Guide—522580-018 3-22
4 Scheduled Synchronization As mentioned previously, most one-time synchronization features described in Section 3, One-time Synchronization also apply to scheduled synchronizations. This section describes features and concepts that are specific to scheduled synchronizations.
The AutoSYNC Authorizer Scheduled Synchronization Scheduled synchronizations, however, are managed by the AutoSYNC monitor process. The AutoSYNC monitor acts as an agent for the AutoSYNC users, but also must ensure that each user has access rights to the files that are to be synchronized. The following pages describe how AutoSYNC is granted sufficient authority to act as an agent for multiple users, but in a way that prevents granting enhanced access rights to those users.
AutoSYNC Users Scheduled Synchronization SUSPEND SYNCUSER ACTIVATE SYNCUSER Caution. The AutoSYNC administrator can manipulate the AutoSYNC configuration to gain access to files that may not be secured for access to the administrator user ID. Thus, the AutoSYNC authorizer must exercise discretion when designating the administrator. AutoSYNC Users To configure file sets to be synchronized, you must be a AutoSYNC user; the administrator makes you a user through the ADD SYNCUSER command.
Data Access Control Scheduled Synchronization Data Access Control Users of AutoSYNC, especially the authorizer, should understand how multiple users are managed by AutoSYNC, a non-privileged subsystem. The monitor process reads the SYNCUSER table to determine which users are configured to use AutoSYNC. The SYNCUSER table should be secured to prevent unauthorized access. For each AutoSYNC user, the monitor accesses the SFggguuu table to fetch the synchronizations configured by the user.
Interval, Start, and Stop Times Scheduled Synchronization Interval, Start, and Stop Times The basic scheduling control is the INTERVAL between synchronizations. The default interval is 5 minutes, but you can specify another interval. In addition, you can specify both START and STOP times. If you specify only START, AutoSYNC performs a daily synchronization at the specified time and the INTERVAL, if specified, is ignored.
ALTER SYNCFILESET (and ALTER BATCHID) Scheduled Synchronization ALTER SYNCFILESET (and ALTER BATCHID) You can change any of the file set options, including the source and destination file sets. See ALTER SYNCFILESET on page 8-35 and ALTER BATCHID on page 8-27. Altering a SYNCFILESET will cause it to be rescheduled and performed at the first opportunity. DELETE SYNCFILESET (and DELETE BATCHID) The synchronization is terminated and deleted from the schedule.
Checking the Outcome of Scheduled Synchronizations Scheduled Synchronization Checking the Outcome of Scheduled Synchronizations As mentioned above in the AutoSYNC Users paragraph, the outcomes of scheduled synchronizations performed on behalf of Syncuser ggg,uuu are logged in file SLggguuu. To display the content of the synchronization log file, use the LOG option of INFO BATCHID or INFO INFO SYNCFILESET. Security and Authorization A scheduled synchronization is managed by the AutoSYNC monitor process.
Scheduled Synchronization Flow Scheduled Synchronization Perform the following operations, on the source system, to make ASYSYNCP a privileged program that can log down. 1. In BIND, issue the following commands: ADD * FROM ASYSYNCP SET LIKE ASYSYNCP ALTER CALLABLE^LOG^DOWN, CALLABLE ON SET SAVEABEND ON BUILD ASYSYNCP! 2. At the TACL prompt, SQL compile ASYSYNCP: SQLCOMP/IN ASYSYNCP/NOREGISTER ON 3. At the TACL prompt, accelerate ASYSYNC AXCEL ASYSYNCP, ASYSYNCP or OCA ASYSYNCP 4. Then, as SUPER.
ASYSYNCP process Scheduled Synchronization For each user ID, uuu,ggg, there should be a file set configuration table named SFggguuu. All file sets in these tables are fetched to the monitor’s memory and sorted. Suspended file sets are discarded. The monitor starts a local ASYSYNCP process for each unique combination of user ID, known destination system, and batch ID.
ASYSYNC process Scheduled Synchronization ASYSYNC process The ASYSYNC process on the destination is started by the ASYSYNCP process on the source and thus automatically has the appropriate process-access ID. The ASYSYNC process receives a single file set description and a list of all files in the source file set. The ASYSYNC process then finds all files in the destination file set. If the PURGE or SUBVOLPURGE option is specified, extra files in the destination file set are purged.
5 OSS File Synchronization This section describes the features and options available for the synchronization of OSS files and directories. These features apply to both one-time synchronization and scheduled synchronization.
OSS File Synchronization Source File Set signify that the pathname was shortened. If the DETAIL or LOG options are specified with these commands, the complete OSS pathname is displayed. Pathnames wrap to the next line if necessary. AutoSYNC synchronizes the following OSS disk files: Directories Regular files Symbolic links Hard links Unlike an empty Guardian file system subvolume, an empty directory is synchronized.
OSS File Synchronization Links Purging Destination Files If a file, a link or a directory exists in the destination file set but does not exist in the source, it can be purged on the destination by specifying the PURGE option. If PURGE is specified, subordinate directories that do not exist in the source are purged. This differs from the purge processing for Guardian subvolumes. Entire Guardian subvolumes are purged only if the SUBVOLPURGE option is specified in addition to the PURGE option.
OSS File Synchronization Links By default, when ALLSYMLINKS is specified, a symbolic link is synchronized also when the symbolic link points outside the synchronization file set. In this case, the symbolic link may point to a file that does not exist. A message is written to the logfile: File not in source file set, synchronizing uncontained symbolic link. When NO ALLSYMLINKS is specified, AutoSYNC does not synchronize a symbolic link that points outside the synchronization file set.
OSS File Synchronization Recovery Another side effect of the source and destination timestamps inherent mismatch is that the TIMEEXACT option is ignored for symbolic links. Recovery The recovery function, controlled by the global parameter SYNCRECOVER, is by default enabled for all synchronizations. Recovery for Guardian file sets is discussed in paragraph Recovery on page 3-18.
OSS File Synchronization Ownership and Security As mentioned above in Modification Timestamp of Symbolic Links, TIMEEXACT is ignored for symbolic links. The RENAMEOPEN option is not supported for OSS files. If a destination file is open at the time of the synchronization, it will not be synchronized but a warning is written to the log file and synchronization continues with the next file or directory.
OSS File Synchronization Ownership of Symbolic Links If the user is not SUPER.SUPER (255,255), WRITE access is granted for the destination file. AutoSYNC applies the equivalent of Guardian purge security rules to OSS WRITE security. If the user is SUPER.SUPER (255,255), WRITE security is not upgraded and remains the same as the source file security setting because the SUPER.SUPER user always has the required WRITE access. You may use the SECURE option to override the default security setting.
OSS File Synchronization Synchronization Options 1. In BIND issue the following commands: ADD * FROM ASYSYNC SET LIKE ASYSYNC ALTER CALLABLE^LOG^DOWN, CALLABLE ON SET SAVEABEND ON BUILD ASYSYNC! 2. At the TACL prompt, SQL compile ASYSYNCP: SQLCOMP/IN ASYSYNCP/NOREGISTER ON 3. At the TACL prompt, accelerate ASYSYNC: AXCEL ASYSYNC, ASYSYNC or OCA ASYSYNC 4. Then, as SUPER.SUPER, issue the following command: FUP LICENSE ASYSYNC If synchronizing over TCP/IP, perform the same steps on ASYSYNCP. Note.
OSS File Synchronization Synchronization Options FROMOWNER HOSTNAME INTERVAL KEEPBACKUPINFILE KEEPSECURITY LISTALL OPENUPDATE OWNER PRI PURGE RATE percentage START hh:mm:ss STOP hh:mm:ss SUSPEND TIMEEX[ACT] TRIGGER TRIGGERONFILESET UNPROTECTED The following are not applicable to OSS files: AUDITED AUTOCREATECATALOG BACKUP CATALOG KEEPNOPURGEUNTIL MAPNAMES MAXBACKUP NETWORKSECURE NOSAFEGUARD RESTORE SQLREDEF HP AutoSYNC User’s Guide—522580-018 5
OSS File Synchronization Synchronization Options SUBVOLPURGE USEBINDERTIME ZZINCLUDE The following options are not supported: COMPRESS RECOVERY RENAMEOPEN HP AutoSYNC User’s Guide—522580-018 5-10
6 Triggers This section gives a basic overview of AutoSYNC triggers. Triggers allow a user to run a TACL or OSS shell command for each synchronized file that was successfully moved to the destination system (TRIGGER) or run a TACL or OSS shell command after a complete file set has been successfully synchronized (TRIGGERONFILESET).
Commands Triggers The feature is invoked by specifying TRIGGER or TRIGGERONFILESET option in the SYNCHRONIZE, ADD SYNCFILESET, or ALTER SYNCFILESET commands: SYNCHRONIZE … TRIGGER “command-text”; or SYNCHRONIZE … TRIGGERONFILESET “command-text”; ADD SYNCFILESET … TRIGGER “command-text”; or ADD SYNCFILESET … TRIGGERONFILESET “command-text”; Commands TRIGGER Specify a complete TACL or OSS command line that includes built-in arguments that are replaced by appropriate file names.
TRIGGERONFILESET Triggers If no archive name is found, AutoSYNC will pass the placeholder question mark (?). For OSS, files the absolute pathname is specified. Recovery files have a name chosen by AutoSYNC. Such files are usually purged by AutoSYNC when the replacement file has been synchronized, but triggers may preserve these files by renaming them #MAPNAMES is replaced by the mapnames-file that is configured for the syncfileset using the MAPNAMES option.
Troubleshooting triggers Triggers source file modification timestamp and specifying TIMEEXACT will cause the files to be synchronized needlessly at every synchronization interval. Troubleshooting triggers For problem resolution and debugging, you can run the trigger command on a terminal at a TACL prompt. If the destination is on a remote system, the user must have security privileges sufficient to run a remote TACL process. Examples TRIGGER examples 1. SQL-compile the synchronized object file myslqprg.
TRIGGER examples Triggers 4. Compare the old destination file with the new destination file: discrepancies will be reported to the log file: SYNC /home/dev/sales/appl TO /E/paris/home/sales/appl/, LISTALL, LOGFILE triglog, CLEAR, TRIGGER "/home/sales/scripts/cpsyrcv #SYNCFILE #RECOVERFILE "; cpsyrcv: cp $1 /home/sales/bckupnew/; cp $2 /home/sales/bckupold/; 5. Conditionally SQL compile objects depending on the file code of the object file. Only objects that can run on the destination are SQLCOMP’ed.
TRIGGER examples Triggers where the TRIGCOND macro is: ======================================================== == Name: TRIGCOND == Purpose: Sample conditional sqlcomp depending on file == code and OS version == Usage: == SYNC $data.test.sqobj TO \paris.$datab.testb.
TRIGGERONFILESET Example Triggers TRIGGERONFILESET Example Change the library pointer in object files GETME and GETMETOO to GETUL after synchronizing the entire object subvolume to a location with a different name:y SYNC $data.objd.* TO \paris.$datab.objp.
Note on Triggers that invoke SQLCI Triggers Instead, the user should use the following command: SYNC $data.test.sqacct TO \paris.$datab.testb.
7 Synchronization Over TCP/IP AutoSYNC supports the use of a direct TCP/IP network connection to communicate between the source and destination AutoSYNC processes. This section describes how to setup synchronizations over TCP/IP and how AutoSYNC establishes and manages the connection. The topics covered are organized as follows: Overview Configuring a TCP/IP connection On both Source and Destination Systems On the Destination System On the Source System .
On both Source and Destination Systems Synchronization Over TCP/IP On both Source and Destination Systems Set the TCP/IP port numbers for AutoSYNC A TCP/IP SERVICES file is used to specify the port number for use by defined services. The name of the service is ASYSYNC-ZASY where ZASY is the name of the AutoSYNC monitor process $ZASY that is used on both systems to coordinate the TCP/IP connections.
On the Destination System Synchronization Over TCP/IP On the source system, the ASYSYNC process for a scheduled synchronization inherits the define from the monitor process. For a one-time synchronization, the ASYSYNC process inherits the define directly from the AUTOSYNC CI process. There is no default port number; if you do not configure a port number, synchronization over TCP/IP is not possible. Consult your local networking specialist to choose an appropriate port number.
On the Source System Synchronization Over TCP/IP Thus, you must specify all TCPIP, TCPSAM or TCP6SAM processes that correspond to those addresses, or the synchronization will fail to make the connection. Consult a networking specialist to determine the names of the TCPIP, TCPSAM, and TCP6SAM processes. Use the following SCF commands to understand your local networking configuration: LISTDEV TCPIP and INFO PROCESS $, DETAIL.
Connection Setup over TCP/IP Synchronization Over TCP/IP to the source and destination file sets. If the destination is on a remote system, the destination file set must include the Expand node name of the remote system. ADD SYNCF[ILESET[ src-fileset TO \systname.dest-fileset, HOST { name | IP address } [, sync-options]; Connection Setup over TCP/IP As in synchronizations over an Expand link, the source ASYSYNCP receives its file sets from the monitor or Autosync CI.
Logging Synchronization Over TCP/IP Syncuser fails with a SQL error -8025 (The SQL region was not SQL compiled), because the SQL Executor cannot access the SQL object in ASYSYNCP. Consequently, ASYSYNCP EXECUTE security must be set to "N" if any non SUPER.SUPER Syncusers are configured to perform synchronizations. Logging When synchronizing over an Expand link, the destination ASYSYNC opens the log file SLggguuu through Expand and writes records directly to the log.
8 Command Interpreter The AUTOSYNC command interpreter is the primary interface for invoking utility functions and for controlling and monitoring the AutoSYNC. This chapter describes the AutoSYNC command interpreter and is organized as follows: Running the Command Interpreter Command Syntax Command Summary Command Descriptions Running the Command Interpreter AUTOSYNC is invoked through the TACL run command or equivalent. The TACL syntax is: [RUN] $SYSTEM.AUTOSYNC.
Command Syntax Command Interpreter Command Syntax AUTOSYNC is a conversational-mode command interpreter. Most commands can be continued over many lines with no need for a continuation character; as a consequence, each command must be terminated with a semi-colon (;). A few commands, such as FC and RUN, are single-line commands and are terminated by the end of line; such commands can be continued by placing an ampersand (&) at the end of the line.
Command Summary Command Interpreter Table 8-1. AutoSYNC Commands (continued) Command Name Description ALTER LOCAL Changes the value of a AutoSYNC local parameter ALTER MAPDB Changes attributes of MapDB and the monitor. ALTER MONITOR Changes attributes of a monitor process. ALTER SYNCFILESET Modifies configuration of scheduled synchronization by file set. ALTER SYNCUSER Modifies configuration of an AutoSYNC user. AUTHORIZE Sets the AutoSYNC authorizing user ID.
Command Summary Command Interpreter Table 8-1. AutoSYNC Commands (continued) Command Name Description STATUS BATCHID Displays status information for a specific batchid. STATUS MONITOR Displays the status of a monitor process. STATUS SYNC Displays status for a synchronization process. STATUS SYNCFILESET Displays status information for a specific syncfileset. STOP MONITOR Stops the monitor process. SUSPEND BATCHID Terminates and suspends scheduled synchronization for specified BATCHID.
Command Descriptions Command Interpreter Table 8-2. General Purpose Commands Command Name Description LOG Outputs a copy of AUTOSYNC command input and output to a file. OBEY Executes a sequence of AUTOSYNC commands from a file. OUT Directs all AUTOSYNC command output to a file. PURGEDATA Clears all data from a file. RENAME Renames an Enscribe file RESET Resets completion code. RUN[D] Executes an external process during an AUTOSYNC session. STATS Examines an Enscribe structured file.
ACTIVATE SYNCFILESET Command Interpreter * | batchid | batchid - batchid a collection of file sets by BATCHID or a range of BATCHIDs. Up to 32 ranges can be entered. A BATCHID is an integer and is of the same format as an alternate key tag, that is, two characters in quotes or a number between 1 to 32767. If batchid-batchid is specified, the second batchid must be greater than the first. * designates all configured batchids for the user.
ADD SYNCFILESET Command Interpreter ADD SYNCFILESET Adds a file set to the scheduled synchronizations. See the Synchronization Options on page 3-12 for an overview of synchronization.
ADD SYNCFILESET Command Interpreter common-options (continued) { TRIGGER { tacl-command | oss-shell-command } } { TRIGGERONFILESET { tacl-command | oss-shell-command } } { UNPRO[TECTED] } guardian-only-options: { AUDITED } { AUTOCREATECAT[ALOG] } { BACKUP backup-program } { CATALOG SQL-catalog } { COMPRESS } { KEEPNOPURGEUNTIL } { MAPNAMES mapnames-file } { MAXBACKUP num-of-files } { NETWORKS[ECURE] | NO NETWORKS[ECURE] } { NOSAFEGUARD | NO NOSAFEGUARD } { RECOVER[Y] | NO RECOVER
ADD SYNCFILESET Command Interpreter OSS-only-options: { ALLHARDLINKS | NO ALLHARDLINKS } { ALLSYMLINKS | NO ALLSYMLINKS } { OWNERG[ROUP] { group-id | group-user } } { SECURE “rwxrwxrwx” } src-file-set a file set on the local system that is the source of the synchronization operation. If a system name is specified, it must be the local Expand node name. dest-file-set the location of the file set that is to be updated.
ADD SYNCFILESET Command Interpreter OSS file set definition The source and destination file sets must be specified with the absolute pathname. Wild-card characters are not supported; specify an absolute directory name or an absolute file name. If the source file set is a single file, the file is moved to the destination specified. If the directory does not exist at the destination location, the directory is created.
ADD SYNCFILESET Command Interpreter EXCLUDE exclude-file instructs AutoSYNC to exclude the files listed in exclude-file from synchronization. exclude-file an edit file that contains names of the files, subvolumes or disk volumes in the syncfileset that are to be excluded from the synchronization. An exclude file can be shared among syncfilesets. When starting a new synchronization ASYSYNC rereads the exclude list if the exclude file has been updated. Each entry must be on a separate line.
ADD SYNCFILESET Command Interpreter EXCLUDEPURGE excludepurge-file instructs AutoSYNC to exclude the files listed in the excludep-file from being purged on the destination, if the files do not exist on the source. EXCLUDEPURGE only applies when PURGE or SUBVOLPUREGE are also specified. Otherwise, EXCLUDEPURGE is ignored. excludep-file an edit file that contains the names of the files, subvolumes or disk volumes in the destination syncfileset that are excluded from being purged.
ADD SYNCFILESET Command Interpreter FROMO[WNER] user-id instructs Autosync to synchronize only the source files owned by the specified user ID. By default the whole source fileset is synchronized, regardless of the ownership of the files, as long as security settings do not prevent it. An OSS directory that is not owned by the specified owner is skipped, along with all its files and subdirectories, even if some of the subordinate files or subdirectories are owned by the specified user ID.
ADD SYNCFILESET Command Interpreter input file is created only when files are synchronized and the MAPNAMES option is specified. For OSS file sets, the BACKUP input files is an entry-sequenced file that contains the names of the files and directories to be synchronized, in addition to internal file information. KEEPS[ECURITY] that the Guardian security settings "rwep" of the source file are retained on the destination file. KEEPSECURITY overrides the SECURE and NETWORKSECURE options.
ADD SYNCFILESET Command Interpreter the owner of the destination file set. If OWNER is omitted, the owner of the source file is retained. Note for OSS file sets. If OWNER is specified and OWNERGROUP is omitted, the OWNERGROUP of the file set is set to the group of the source file, not the group specified by OWNER. PRI[ORITY] priority the process priority at which the ASYSYNC process is to run when processing this syncfileset.
ADD SYNCFILESET Command Interpreter An entry is written into the log file for each file or OSS directory that is purged as a result of the synchronization. PURGE is not supported for SQL tables. RATE percentage the percentage of elapsed time the synchronization process should be active. The default is 100%. START hh:mm:ss the start time of the synchronization window. The time is entered in the format hour:minute:seconds between 00:00:00 and 23:59:59. The maximum window is 24 hours.
ADD SYNCFILESET Command Interpreter By default, a file is synchronized only when the source file has been modified after the destination file was last modified. The comparison of timestamps accounts for differences in system clocks and time zones.. Note on symbolic links. Because source and destination modification timestamps of symbolic links never match, TIMEEXACT is ignored if specified for symbolic links.
ADD SYNCFILESET Command Interpreter The trigger is executed if files have been replaced or purged during the synchronization, or if a file error has occurred that did not cause the synchronization to fail. The trigger is not executed if no files have been replaced or purged during the synchronization, or if an error other than a file error has occurred that caused the synchronization to fail. The command supports a set of built-in arguments.
ADD SYNCFILESET Command Interpreter The catalog is created in the same location as the catalog on the source system. If the source catalog volume does not exist on the destination system, the catalog is placed on the volume of the destination tables. The security of the newly created destination catalog is set to the syncuser's default Guardian security. If the catalog already exists, the option is ignored.
ADD SYNCFILESET Command Interpreter MAPNAMES mapnames-file specifies the mapping of a source fileset to a destination fileset and catalog name mapping. The mapnames-file is an edit or entry-sequenced file located on the destination system. File name mapping: The mapnames-file entries are similar to, but not exactly the same as, the MAP NAMES option of RESTORE. Each line of the MAPNAMES file contains a single mapping of the form.
ADD SYNCFILESET Command Interpreter MAXBACKUP num-of-files the maximum number of files to be processed by one BACKUP process. When processing large file sets, AutoSYNC divides the synchronized files into subsets, each processed by a separate BACKUP process. BACKUP performance decreases significantly with the number of files it processes. To avoid performance degradation, AutoSYNC starts multiple BACKUP processes, in sequence, and assigns to each no more than the configured num-of-files.
ADD SYNCFILESET Command Interpreter specifies that destination unaudited files that are opened for shared READ access or running object files are to be renamed to allow AutoSYNC to replace them. The syncuser must have PURGE privileges to the destination file for the RENAME to succeed. Both the old and new file names are recorded in an AutoSYNC index file called AAINDEX, located in the MapDB subvolume.
ADD SYNCFILESET Command Interpreter By default, AutoSYNC compares only modification timestamps of source and destination SQL tables. Note. A SQL view or index is synchronized automatically with the primary partition of the base table. If the redefinition date of an index or view in the source subvolume is newer than in the destination subvolume but the primary source partition is older than the primary destination partition, the view or index will not be synchronized.
ADD SYNCFILESET Command Interpreter ALLHARDLINKS | NO ALLHARDLINKS synchronizes all files that are hard links in the specified syncfileset, including uncontained heartlands. When synchronizing an uncontained hard link, a new file is created in the destination file set and all contained links to the same inode are linked to this file. A warning is written into the log file when an uncontained hard link has been synchronized. If NO ALLHARDLINKS is specified, uncontained hard links are not synchronized.
ADD SYNCUSER Command Interpreter If this option is omitted, the security of the destination file set is the same as that of the source file set. The exception is write security for the owner: when a file or a directory is synchronized and the write access was denied for the owner in the source file, write access is granted in the destination file to allow subsequent synchronizations. Write access is only upgraded when the syncuser is the owner of the file and not SUPER.SUPER.
ADD SYNCUSER Command Interpreter BACKUP backup-program the object file name of the BACKUP program to use on the source system when a file set is synchronized. If BACKUP is omitted, the default $SYSTEM.SYSnn.BACKUP program is used. EMSFILEEVENTS | NO EMSFILEEVENTS logs any synchronization error related to a specific file (for example, error 48, error 45, and so on) in the EMS log.
ALTER BATCHID Command Interpreter The default is NO EMSSUPPRESS. Usage Note. EMSSUPRESS is also a GLOBAL parameter. You must use the global parameter setting on the source and destination systems, rather than the SYNCUSER option, if you wish to suppress optional messages for synchronizations that are done over TCP/IP. MAXPRIORITY priority the maximum priority at which the ASYSYNC process can run for this user.
ALTER FILE Command Interpreter a collection of file sets by BATCHID or a range of BATCHIDs. Up to 32 ranges can be entered. A batchid is an integer and is of the same format as an alternate key tag, that is, two characters in quotes or a number between 1 to 32767. If batchid-batchid is specified, the second batchid must be greater than the first. * designates all configured batchids for the syncuser. To display the BATCHIDs, use INFO BATCHID.
ALTER FILE Command Interpreter TACL-style file name pattern specifying a collection of files. AUDIT | NO AUDIT controls TMF auditing. Default is AUDIT. AUTOSYNC does not turn on the audit flag for edit files (code 101) or object files (code 100 or 700). To force audit, use “!”. The AUDIT flag is propagated to the alternate key files. AUDITCOMPRESS | NO AUDITCOMPRESS sets the mode of producing audit-checkpoint messages (entire message or compressed) for audited files.
ALTER GLOBAL Command Interpreter SECURE “rwep” Guardian security string. SERIALWRITES | NO SERIALWRITES whether serial writes to the mirrored disk are performed. If NO SERIALWRITES is specified, parallel writes are performed. The default is NO SERIALWRITES. VERIFIEDWRITES | NO VERIFIEDWRITES sets the mode of file writes: verified or not verified. The default is NO VERIFYWRITES. ALTER GLOBAL Sets or changes global AutoSYNC values.
ALTER GLOBAL Command Interpreter [AUTO]SYNCOVERIP { ON | OFF } enables (or disables) AutoSYNC for synchronization over TCP/IP. The default is OFF, indicating that synchronization occurs over an EXPAND link only. [AUTO]SYNCRECOVER { ON | OFF } enables or disables the recovery option. If recovery is enabled, AutoSYNC saves a copy of a destination file to an archive subvolume before it restores a later copy of the file.
ALTER LOCAL Command Interpreter You may specify up to 6 processes, not exceeding 30 characters of names, not including commas and spaces. Use MONITOR STATUS TCP to verify that the TCPIP processes are properly configured. ALTER LOCAL Sets or changes a local parameter value. Local parameters are the same as global parameters and have the same purpose, but they are in effect for the current Monitor (MapDB) only. Local parameter values are stored in the MapDB table REGISTRY.
ALTER MAPDB Command Interpreter monitor process is restarted. These attributes can also be changed using ALTER MONITOR. ALTER MAPDB subvol { , option... } option is: { BACKUP cpu-number } { HOMETERM [ file-name | NONE ] } { MONITOR monitor-name } { PRIMARY cpu-number } { PRIORITY process-priority } subvol the name of the MapDB subvolume. If this command is used to change the name of the monitor, the current monitor process must first be stopped.
ALTER MONITOR Command Interpreter the CPU number (in the range of 0 to 15) of the primary monitor process. PRIORITY process-priority a process priority (in the range of 1 to 199) for the monitor process The PRIMARY, BACKUP, and PRIORITY options specify process creation parameters that are used when starting the monitor process. ALTER MONITOR Modifies attributes of an existing monitor process. The changes take effect when the monitor process is restarted.
ALTER SYNCFILESET Command Interpreter PRIMARY cpu-number the CPU number (in the range of 0 to 15) of the primary monitor process. PRIORITY process-priority a process priority (in the range of 1 to 199) for the monitor process. ALTER SYNCFILESET Modifies the options of the syncfilesets in the specified fset-id range. ALTER SYNCF[ILESET] fset-range [, fset-range ], ... {, options...
ALTER SYNCFILESET Command Interpreter common-options: (continued) { RATE percentage | NO RATE } { START hh:mm:ss | NO START } { STOP hh:mm:ss | NO STOP } { SUSPEND } { TRIGGER { tacl-command | oss-shell-command }| NO TRIGGER } { TRIGGERONFILESET { tacl-command | oss-shell-command } | NO TRIGGERONFILESET } { TIMEEX[ACT] | NO TIMEEX[ACT] } { TO file-set } { UNPRO[TECTED] | NO UNPRO[TECTED] } guardian-only-options: { AUDITED | NO AUDITED } { AUTOCREATECAT[ALOG] } { BACKUP backup-progra
ALTER SYNCFILESET Command Interpreter guardian-only-options: (continued) { RENAMEO[PEN] | NO RENAMEO[PEN] } { RESTORE restore-program | NO RESTORE } { SECURE "rwep" | NO SECURE } { SQLREDEF | NO SQLREDEF } { SUBVOLPURGE | NO SUBVOLPURGE } { USEBINDERTIME | NO USEBINDERTIME } { ZZINC[LUDE] | NO ZZINC[LUDE] } OSS-only-options: { ALLHARDLINKS | NO ALLHARDLINKS } { ALLSYMLINKS | NO ALLSYMLINKS } { OWNERG[ROUP] {{ group-id | group-user } | NO OWNERG[ROUP] } { SECURE “rwxrwxrwx” | NO SECURE }
ALTER SYNCFILESET Command Interpreter BATCHID batchid | NO BATCHID a batch identifier for the file set. The batchid is an unsigned integer and can be specified as a number between 0 and 65535 or as two ASCII characters in quotes. The default batchid is 0. All file sets that have the same batchid for a given user and destination system are synchronized in sequence by a single ASYSYNC process. To have more than one ASYSYNC process for the same destination system, use different BATCHIDs.
ALTER SYNCFILESET Command Interpreter Entries in the exclude-file can specify a pattern but the file and directory names must be fully qualified with absolute pathnames.
ALTER SYNCFILESET Command Interpreter does not exclude directory: /home/group/user/destdir/A/KA/ while exclude-file entry: /home/group/user/destdir/A/KA* or /home/group/user/destdir/A/KA/ excludes directory: /home/group/user/destdir/A/KA/ FROM file-set a file set on the local system that is the source of the synchronization operation. If a system name is specified, it must be the local Expand node name. For file set formats, see Guardian file set definition and OSS file set definition on page 8-10.
ALTER SYNCFILESET Command Interpreter Note that the interval is the time to delay from the completion of one synchronization until the start of the next synchronization. KEEPB[ACKUPINFILE] | NO KEEPB[ACKUPINFILE] instructs AutoSYNC to retain (or stop retaining) BACKUP and RESTORE input files. By default, these files are temporary and they are purged after the synchronization has completed. This option is used for troubleshooting only.
ALTER SYNCFILESET Command Interpreter exclusion mode must be SHARED or PROTECTED. Recovery must be enabled for the file set. If a file is being updated at the time AutoSYNC attempts to synchronize it, it is skipped. To force the synchronization of a file as it is being modified, specify the UNPROTECTED option described below on page 8-45. OPENUPDATE is ignored if: a file is opened for EXCLUSIVE access a file is audited the global SYNCRECOVER parameter is set to OFF.. Note for OSS file sets.
ALTER SYNCFILESET Command Interpreter If PURGE is specified, the subvolume portion of the source and destination file sets must be fully qualified (no wild-card characters or "*"). Purging of files occurs on a subvolume by subvolume basis. A destination file is not purged if it does not exist in a corresponding source subvolume, unless the SUBVOLPURGE option is also specified. Extra SQL objects in the destination like tables, views and indexes are purged.
ALTER SYNCFILESET Command Interpreter If the start time is later than the stop time, then it is assumed the synchronization window crosses into the next day. STOP hh:mm:ss | NO STOP the ending time of the synchronization window. The time is entered in the format hour:minute:seconds between 00:00:00 and 23:59:59. The maximum window is 24 hours. If the stop time is smaller than the start time, then it is assumed the synchronization window crosses into the next day.
ALTER SYNCFILESET Command Interpreter #SOURCEFILE is replaced with the name of the original source file. For OSS files, the absolute pathname is specified. #RECOVERFILE is replaced with the name of the file that was recovered by AutoSYNC. If no archive name is found, AUTOSYNC substitutes the placeholder question mark (?) for the file name. For OSS files, the absolute pathname is specified.
ALTER SYNCFILESET Command Interpreter synchronized (backed up). Note that if a source file was updated during the synchronization, the destination file could be corrupted. UNPROTECTED applies to: OSS files Unstructured Enscribe files that are not edit files (type 101) Enscribe entry-sequenced files guardian-only-options AUDITED | NO AUDITED instructs AutoSYNC to synchronize (or skip) the audited files in the file set. The default is NO AUDITED.
ALTER SYNCFILESET Command Interpreter enables or disables compression of the file set prior to being sent to the destination system. This option overrides the global parameter [AUTO]SYNCCOMPRESS. Note. Compression is CPU-intensive and can reduce total throughput unless the connection between source and destination systems is slow. KEEPNOPURGEUNTIL | NO KEEPNOPURGEUNTIL specifies that the NOPURGEUNTIL attribute of a source SQL table or alternate index is preserved (or not preserved) on the destination.
ALTER SYNCFILESET Command Interpreter The information in MAPNAMES is also used to perform SQL catalog volume mapping. You should include MAPNAME entries if catalogs are located on different volumes or subvolumes on the destination system. The entries follow file mapping entries and are preceded by the keyword "CATALOGS:", including the colon (:), as follows: $DATA TO $BACK \NEWYORK.$DATA*.DB TO $BACK.BACKUPDB $DATA*.DB.PARTFILE TO \TOKYO.* CATALOGS: $CATS.BACKCAT FOR $BACK.*.* $CATS.DBCAT FOR $BACK.
ALTER SYNCFILESET Command Interpreter NOSAFEGUARD | NO NOSAFEGUARD specifies that the Safeguard ACL for a source Enscribe disk file is not propagated to the destination when the file is synchronized. A warning is written to the logfile to notify the user that the Safeguard setting for the source file has been turned off on the destination. The default is NO NOSAFEGUARD and the ACL for a source file is propagated to the synchronized destination file.
ALTER SYNCFILESET Command Interpreter If RESTORE is omitted, $SYSTEM.SYSnn.RESTORE is used. SECURE “rwep” | NO SECURE the security of destination files. If NO SECURE is specified, the security of a destination file is reset to be the same as that of the source file. SQLREDEF | NO SQLREDEF instructs AutoSYNC to synchronize SQL tables based on differences in the redefinition timestamps, in addition to differences in modified timestamps.
ALTER SYNCFILESET Command Interpreter By default, ZZ* files and system swap files are not synchronized. OSS-only-options When describing synchronization options for OSS files below, the phrase "uncontained links" refers to files that are hard links or symbolic links that have references to files that reside outside of the synchronization file set. An uncontained hard link is a link to an inode where another link to the same inode resides outside the synchronization file set.
ALTER SYNCUSER Command Interpreter the security of the destination file set. "rwxrwxrwx" settings are for user, group and others. The accepted values are: "r" grants read access "w" grants write access "x" grants execute access "-" denies access for read, write and execute setting. If this option is omitted, the security of the destination file set is the same as that of the source file set.
ALTER SYNCUSER Command Interpreter user-id | username the Guardian user ID or user name whose synchronization privileges are being altered. BACKUP backup-program | NO BACKUP the object file name of the BACKUP program to use when a file set is synchronized. If BACKUP is omitted or if NO BACKUP is specified, the default $SYSTEM.SYSnn.BACKUP program is used. CPU n | (n1, n2, n3...) designates the CPU(s) where the ASYSYNC processes run.
AUTHORIZE Command Interpreter The option may be disabled to troubleshoot an AutoSYNC problem or to analyze unusual behavior. The default is NO EMSSUPPRESS. Usage Note. EMSSUPRESS is also a GLOBAL parameter. You must use the global parameter setting on the source and destination systems, rather than the SYNCYSER option, if you wish to suppress optional messages for synchronizations that are done over TCP/IP. MAXPRIORITY priority the maximum priority at which the ASYSYNC process can run for this user.
CALC Command Interpreter AUTHORIZE can also designate the AutoSYNC administrator user ID, who can manage sync users without the need to have access to sensitive data controlled by the sync users. AUTHORIZE AUTOSYNC [, ADMINistrator user-id ]; ADMINistrator user-id the user who is the AutoSYNC administrator. The administrator is the user who configures syncusers and controls who is authorized to schedule automatic file-set synchronization.
CLEAR AUTOSYNC Command Interpreter an ordinary decimal constant with or without a decimal point, or a binary, octal, or hexadecimal integer (prefixed by %b, %, or %h, respectively. CLEAR AUTOSYNC Removes the remote destination DISABLE access control from the specified system or all systems, allowing synchronization from these source systems to resume. CLEAR AUTOS[YNC] FROM [ \system-name | * ]; \system-name an Expand system name. * designates all systems that have this system as a destination.
COPY Command Interpreter COPY Copies records or rows from an input file to an output file or displays them to an output device. It is analogous in function to the FUP COPY command. At this time, some of the FUP options pertaining to tape devices are not supported.
COPY Command Interpreter { SKIPMATCH } { TRIM trim-character } { UNLOADIN | NO UNLOADIN } { UNSTRUCTURED } { VARIN } out-options is: { BLOCKOUT <1 to 32767> } { BUFFERED } { EBCDICOUT } { FOLD } { PAD pad-character } { RECOUT <1 to 4096> } { REWINDOUT | NO REWINDOUT } { UNLOADOUT | NO UNLOADOUT } { UNSTROUT } { UPDATE } { VAROUT } display-options is { O[CTAL] } { D[ECIMAL] } { H[EX] } { A[SCII] } { BYTE[S] } { NO HEAD } in-file HP AutoSYNC User’s Guide—522580-0
COPY Command Interpreter the name of the file that is input to the copy command. It can be a process, a tape, terminal, or disk file. Supported disk files include edit files, spooler files, Enscribe structured and unstructured files. out-file the name of the file that is destination of the copy command. It can be a process, a tape, terminal, a printer or disk file. Supported disk files include edit files, spooler files, Enscribe structured and unstructured files.
COPY Command Interpreter key-spec is the alternate key tag (1 or 2 bytes) designating the alternate key to be used for positioning. ALTKEY key-value [, key-value] the alternate key of the starting record or row. The format of key-value is described above. UPSHIFT converts lowercase characters to uppercase. in-options BLOCKIN the number of bytes in an input block that is requested in a single physical read operation. When BLOCKIN is not specified, the RECIN value is used.
COPY Command Interpreter REVERSE the input file is to be READ from the starting record in reverse order. REWINDIN | NO REWINDIN (magnetic tapes only) the tape is rewound (or not rewound) when the EOF is read from the tape. If NO REWINDIN is specified, the tape remains positioned without rewinding.The default is REWINDIN. This option also applies to labeled tapes. SHARE the file is to be opened in shared-exclusion mode. The default is protected.
COPY Command Interpreter EBCDICOUT the output characters are translated from ASCII to their EBCDIC equivalents. FOLD the input records or rows that are longer than the output record length are divided into as many output records as needed to copy the entire input record or row. PAD pad-character the input record containing fewer bytes than the output record length is padded with pad-character. Specify pad-character as a single byte character in quotation marks or as an integer in the range of 0 to 255.
CPUS Command Interpreter display-options AUTOSYNC display options differ from FUP display options. AUTOSYNC applies all output data transformations (RECOUT, BLOCKOUT, PAD, and so on) before converting the data to display format, whereas FUP does it the other way around. As a result, AUTOSYNC only formats the data itself and displays it as it would be written to a disk file. Entry-sequenced record keys are displayed in the 64-bit format. O[CTAL] the output is in octal and ASCII format.
CREATE MAPDB Command Interpreter Since the MapDB is a set of SQL tables, the volume on which it is created must be TMF protected. CREATE MAPDB subvol [ , option... ]; or CREATE MAPDB ON volume [ , option... ]; option is { BACKUP cpu-number } { CATALOG SQL-catalog } { HOMETERM file-name } { MONITOR process-name } { PRIMARY cpu-number } { PRIORITY process-priority } { SECURE “rwep” } subvol the subvolume where the MapDB table is to be created.
CREATE SYSDB Command Interpreter Functionally however, the home terminal for the monitor process is the default EMS collector, as shown by the Autosync STATUS MONITOR command.. Each MapDB is associated with a unique monitor process name. Monitor process names must have exactly 4 characters in addition to the “$”; the default name is $ZASY. If a monitor process name has already been assigned to a MapDB, you must choose another name.
DELAY Command Interpreter the SQL catalog subvolume where the SysDB tables are to be registered. If this parameter is omitted, AUTOSYNC creates a SQL catalog in subvolume ESCCATLG on the volume specified in the command. Following the creation of the system database, you should comply with the AutoSYNC registration instructions. If you create SYSDB on a subvolume other than $SYSTEM.
DELETE SYNCFILESET Command Interpreter DELETE SYNCFILESET Deletes syncfilesets in the specified fset range. DELETE SYNCF[ILESET] fset-range [, fset-id ],...; fset-range is { * | fset-id | fset-id - fset-id } * | fset-id | fset-id - fset-id identifies a synchronization file-set ID or a range of file-set IDs. Up to 32 ranges can be entered. If fset-id - fset-id is specified, the second fset-id must be greater than the first. * designates all configured syncfilesets for the syncuser.
DISABLE AUTOSYNC Command Interpreter The DEQUEUE command terminates if the queue is empty. It times out after two seconds if a read on the queue can't find a record. DEQUEUE in-file, out-file [, dequeue-options ] dequeue-options is: { { { { control-options in-options out-options display-options } } } } in-file an Enscribe queue file. out-file an Enscribe queue file, entry-sequenced file, the terminal or $NULL (or equivalent). dequeue-options See command options for COPY on page 8-57.
ENV Command Interpreter ENV The ENV command displays the current setting of all environmental variables. ENV; EXIT Terminates the AUTOSYNC session. A CTRL–Y has the same effect. The EXIT command does not require a semi-colon and cannot be followed by any text. EXIT FACTOR Accepts any numeric expression and calculates the prime factors of the integer part of the expression.
FILEINFO (FI) Command Interpreter FILEINFO (FI) Displays information about Enscribe files. The information displayed is similar to the TACL FILEINFO display. FI[LEINFO] file-set [, DETAIL ]; or FID file-set; file-set TACL-style file name pattern specifying a collection of files. If no file-set is specified, the current subvolume is assumed. DETAIL displays detailed information. If DETAIL is not specified, AUTOSYNC displays one line of information per file in the file-set.
HELP Command Interpreter HELP Describes the AUTOSYNC commands, monitor process commands and AutoSYNC specific DEFINEs. HELP [ help-option ]; help-option is { ALL } { AUTOSYNC-COMMANDS } { autosync-command [ DETAIL | EXAMPLE ] } { AUTOSYNC-DEFINES } { define [ USAGE ] } { ESCZIP } { MONITOR [ monitor-command ] } ALL displays the list of all commands. AUTOSYNC-COMMANDS requests the display of the list of all AUTOSYNC commands available.
HISTORY Command Interpreter is the name of the DEFINE. HELP displays the syntax and a description of the DEFINEs. USAGE displays information about the usage of the DEFINE, otherwise it displays it as a list of possible subtopics. MONITOR [ monitor-command ] displays the syntax and description of commands that can be sent to the monitor process via AUTOSYNC. If no monitor command is specified, HELP displays a list of the commands as subtopics.
INFO BATCHID Command Interpreter INFO BATCHID plays the synchronization parameters for the syncfilesets in the specified BATCHID ranges. This command is analogous in functionality to INFO SYNCFILESET. INFO BATCH[ID] [ batchid-range [, batchid-range ],...
INFO LOCALS Command Interpreter INFO LOCALS Displays a complete list of global and local values. Global parameter values are the default values in effect for all configured monitors in the system. LOCAL parameter values are the default values in effect for the current monitor. INFO LOCALS [, OBEYFORM ]; OBEYFORM displays a list of the ALTER LOCAL commands that were entered to modify the default global values. See ALTER GLOBAL above for a list of valid AutoSYNC global parameters and values.
INFO SYNCFILESET Command Interpreter * | fset-id | fset-id - fset-id identifies a synchronization file-set ID or a range of file-set IDs. Up to 32 ranges can be entered. If fset-id - fset-id is specified, the second fset-id must be greater than the first. * designates all configured syncfilesets for the syncuser. If fset-range is omitted, all syncfilesets for the current user are displayed. info-option DETAIL displays all parameter values for the file set.
INFO SYNCUSER Command Interpreter If FILESETID is specified, the file set ID is added to the OBEYFORM output. USER [ user-id | user-name ] | ALLUSERS a Guardian user ID or user name. ALLUSERS displays syncfileset information for all configured syncusers. If this option is omitted, the current user ID is assumed. INFO SYNCUSER Displays information pertaining to the synchronization privileges of a specified user.
LISTFILEOPENS (LFO) Command Interpreter ALLI[NDEXES] displays the labels of all indexes of the table. LISTFILEOPENS (LFO) Displays all file opens like the FUP LISTOPENS command, with additional options. The command can be abbreviated to LFO. L[IST]F[ILE]O[PENS] file-set , options options is: { BYF[ILE] } { BYO[PENER] } { OUTP[UT] | WRIT[E] } file-set a TACL-style file name pattern specifying a collection of files.
LIST SYNCPROCESS Command Interpreter This command helps to manage the AutoSYNC environment. LIST SYNCP[ROCESS] [ process-name | * ], info-option info-option is: { DES[TINATION] } { DETAIL } { MONITOR monitor-name } { SOURCE } { USER user-ID } process-name | * the Guardian process name of an ASYSYNC or ASYSYNCP process, or all running ASYSYNC processes. The default is all ASYSYNC and ASYSYNCP running from the current product subvolume for all users.
LOG Command Interpreter SOURCE displays the synchronization processes that are running as source synchronization processes. USER user-ID displays the synchronization processes for the specified syncuser. LOG Displays a history of the AUTOSYNC terminal session on another device, which may be a disk file, a printer, or another terminal. LOG TO starts the logging process, and LOG STOP terminates the logging. LOG { TO filename [CLEAR] | STOP }; TO filename identifies the current log file and starts logging.
MONITOR Command Interpreter displays the mode, number of links, group.owner, size, time of last modification for each file, and pathname. If the file is a special file, the size field instead contains the major and minor device numbers. If the file is a symbolic link, the pathname of the linked-to file is also printed preceded by ->. The attributes of the symbolic link are displayed.
OPEN Command Interpreter OPEN Select a current monitor process and associated MapDB. OPEN process-name; process-name the name of a configured monitor process. It is not necessary for the monitor process to be executing to update or display information for the corresponding MapDB. OUT Directs the output of an AUTOSYNC terminal session to another file. Interactive terminal prompts continues to appear on the original input device.
RESET Command Interpreter the new name for the file. RESET Changes all of the environmental variables to their original settings.It is most often used to change the condition code. RESET; RESET GLOBAL Removes a previously set global value from the configuration and reset the parameter to the default value.
RESET LOCAL Command Interpreter RESET LOCAL Removes a previously set local value from the configuration and resets the parameter to the default value of the corresponding global parameter. RESET LOCAL { parameter | * }; parameter is: { AUTOSYNC } { [AUTO]SYNCCOMPRESS } { [AUTO]SYNCOVERIP } { [AUTO]SYNCRECOVER } { EMSCOLLECTOR } { SYNCTCPPROC[ESSES] } * all global parameters are set to their original default value.
REPORT Command Interpreter REPORT Generates a report that compares source files and destination files. For additional information on the reporting function, consult Section 9, Reporting Function.
REPORT Command Interpreter fset-id identifies a synchronization file-set ID or a range of file-set IDs. Up to 32 ranges can be entered. If fset-id - fset-id is specified, the second fset-id must be greater than the first. * designates all configured syncfilesets for the current syncuser. USER user-ID | ALLU[SERS] [, USER user-ID | ALLU[SERS] USER user-ID a configured syncuser. REPORT creates a report for the syncuser file sets that are in the fset-range specified.
REPORT Command Interpreter displays the file name, file attributes and selection criteria of each selected file. If DETAIL is omitted, the report shows only summary statistics for the file set, but it does not report on specific files. ALL short form to specify all DETAIL options described below. INSYNC displays all files from the source and destination file set that have already been synchronized and are still in sync at the time the report is generated.
RUN[D] Command Interpreter NEWERINDEST displays all files in the destination file set where the destination file is newer than the source file. It overrides the other DETAIL options INSYNC, NOTINSYNC and EXCLUDED. The option is ignored if TIMEEXACT has also been specified. The sync options are applied at the time the files are compared.
START MONITOR Command Interpreter CPU EXTSWAP LIB NOWAIT PRI DEBUG IN MEM OUT SWAP DEFMODE INSPECT NAME PFS TERM command any command line to be passed to the process in the startup message. The RUN[D] command is not a multiline command and is not terminated with a semicolon. Any semicolon is passed to the process as part of the startup command. Refer to Table 8-3 for a list of standard programs, such as EDIT and FUP, that can be executed by simply typing the program name.
STATS Command Interpreter If omitted, the home terminal is set to the default EMS collector. The default EMS collector is $0, or the EMS collector configured by setting the global parameter EMSCOLLECTOR. Note that internally, the default hometerm of the monitor is $ZHOME, as displayed by the TACL command STATUS $, because an EMS collector cannot be specified as the hometerm of a process when the process is launched.
STATUS BATCHID Command Interpreter STATUS BATCHID Obtains and displays status information from the synchronization processes configured in the specified batchid. The command is functionally equivalent to STATUS SYNC with the BATCHID option. STATUS BATCH[ID] [ batchid-range [, batchid-range ],...
STATUS MONITOR Command Interpreter SYSTEM system-name specifies the Expand node name of a system for which the information is displayed. This option is useful for file set that have the destination system specified as a wildcard "*". If omitted, the status for all systems in the fileset that meet the criteria is displayed. USER { user-id | user-name } | ALLUSERS displays status information for any batchid running under the specified Guardian user ID or user name.
STATUS SYNC Command Interpreter STATUS SYNC Obtains and displays status information from the specified ASYSYNC process. It displays information pertaining to the file sets scheduled for synchronization. STATUS [ASY]SYNC [ process-name | * ] [, option... ] option is { ACTIVE} { BATCH[ID] batchid} { BRIEF} { DETAIL} { { [ FSET[ID] | ID ] syncf-id }} { SYSTEM system-name } { USER { user-id | user-name } | ALLUSERS} process-name the Guardian process name of a ASYSYNC process.
STATUS SYNCFILESET Command Interpreter displays status information for the specified synchronization file set. The same information can be displayed using STATUS SYNCFILESET. SYSTEM system-name specifies the Expand node name of a system for which the information is displayed. This option is useful for file sets that have the destination system specified as a wildcard "*". If omitted, the status for all systems in the fileset that meet the criteria is displayed.
STOP MONITOR Command Interpreter If fset-range is omitted, all syncfilesets for the current user are displayed. status-option: ACTIVE displays status information for ASYSYNC processes that are currently in the process of synchronizing file sets. BRIEF displays the synchronization process name, the destination system, the number of active file sets in the batchid and status of the synchronization process. DETAIL displays detailed status information.
SUSPEND BATCHID Command Interpreter ABEND MONITOR A variation on the STOP MONITOR command is the ABEND MONITOR command. ABEND MONITOR [ * | process-name | mapdb ]; ABEND MONITOR causes the monitor process to stop and produce a saveabend file. This command should be used when instructed to do so by HP or to supply information to report a monitor process problem. SUSPEND BATCHID Stops the synchronization for a given file set.
SUSPEND SYNCUSER Command Interpreter * designates all configured syncfilesets for the syncuser. To display the file set ID’s and BATCHIDs, use INFO SYNCFILESET. SUSPEND SYNCUSER Stops synchronization activity for the specified user. Active synchronization is stopped after the current file set is synchronized. SUSPEND SYNCU[SER] { user-id | ALLUSERS }; user-id a Guardian user ID or user name of a configured user. ALLUSERS designates all users. SYNCHRONIZE Executes a one time synchronization.
SYNCHRONIZE Command Interpreter Section 3, One-time Synchronization discusses synchronization options in greater detail.
SYNCHRONIZE Command Interpreter guardian-option: { AUDITED } { AUTOCREATECAT[ALOG] } { BACKUP backup-program } { CATALOG SQL-catalog } { COMPRESS | NO COMPRESS } { EXCLUDE exclude-file } { KEEPNOPURGEUNTIL } { MAPNAMES mapnames-file } { MAXBACKUP num-of-file } { NETWORKS[ECURE] | NO NETWORKS[ECURE] } { NOSAFEGUARD | NO NOSAFEGUARD } { RECOVER[Y] | NO RECOVER[Y] } { RENAMEO[PEN] } { RESTORE restore-program } { SECURE "rwep" } { SQLREDEF } { SUBVOLPURGE } { USEBINDERTIME }
SYNCHRONIZE Command Interpreter oss-option: { ALLHARDLINKS | NO ALLHARDLINKS } { ALLSYMLINKS | NO ALLSYMLINKS } { OWNERG[ROUP] { group-id | group-user } } { SECURE "rwxrwxrwx” } source-file-set a guardian or OSS file set that is to be synchronized. If a system name is specified, it must be the local Expand node name. dest-file-set the location of the file set that is to be updated.
SYNCHRONIZE Command Interpreter If a system is specified, it must be the local system; exclusion pertains only to source files, not destination files. If the PURGE option is specified, to exclude files from being purged on the destination, use the EXCLUDEPURGE option. Without EXCLUDEPURGE: A file on the exclude list is purged on the destination (it is not excluded from purging), if it does not exist on the source.
SYNCHRONIZE Command Interpreter Each entry must be on a separate line. If a line starts either with the word "COMMENT", or the characters "--", the line is treated as a comment and is ignored. Note that exclusion applies only to destination files; it does not apply to files on the source. Consequently, if a system name is specified, it must be the name of the destination system. Guardian file sets: The exclude file supports all legal disk file patterns.
SYNCHRONIZE Command Interpreter KEEPB[ACKUPINFILE] instructs AutoSYNC to retain the BACKUP and RESTORE input files. By default, these files are temporary and they are purged after the synchronization has completed. This option is used for troubleshooting only. The name of the input file is in the format of ZBKnnnnn for BACKUP and ZRSnnnnn for RESTORE, where nnnnn is a serial number. The files are placed in the MapDB subvolume. The exact file name is displayed in the LOGFILE.
SYNCHRONIZE Command Interpreter the interval during which the source file must remain unchanged to be considered for synchronization. The default unit of time is MINUTES. If omitted, the openupdate interval is 5 minutes. The time elapsed is computed from the last time the file was modified. The candidate files can be opened for WRITE or READ-WRITE access. The exclusion mode must be SHARED or PROTECTED. Recovery must be enabled for the file set.
SYNCHRONIZE Command Interpreter Purging of files occurs on a subvolume by subvolume basis. A destination file is not purged if it does not exist in a corresponding source subvolume, unless the SUBVOLPURGE option is also specified. Extra SQL objects in the destination like tables, views and indexes are purged. Catalog files are not supported and they are not synchronized or purged by Autosync.
SYNCHRONIZE Command Interpreter a TACL command or OSS shell command that is executed by AutoSYNC for each file in the synchronized file set after the file has been moved to the destination. The command line contains four built-in arguments. Each argument starts with a pound sign (#) and is terminated by a TACL delimiter character such as a space or a comma, or by a OSS shell delimiter such as a space or a semicolon. Arguments can be specified in either upper or lower case.
SYNCHRONIZE Command Interpreter #SYNCCOUNT is the number of files replaced on the destination. #COUNTNOTBKUP is the number of files not backed up. #COUNTNOTREST is the number of files that were not restored. UNPRO[TECTED] (with OPENUPDATE) used in conjunction with the OPENUPDATE option, instructs AutoSYNC to synchronize a file even if the source file is being updated as it is being synchronized (backed up).
SYNCHRONIZE Command Interpreter enables or disables data compression of the file set prior to being sent to the destination system. This option overrides the global parameter [AUTO]SYNCCOMPRESS. Note. Data compression is CPU-intensive and can reduce total throughput unless the connection between source and destination systems is slow. CATALOG SQL-catalog where to register SQL objects that are synchronized. If you omit the CATALOG option, the source catalog name is used.
SYNCHRONIZE Command Interpreter Are equivalent to: \SOURCE.$DATA.*.* TO \DEST.$BACK.*.* \NEWYORK.$DATA*.DB.* TO \DEST.$BACK.BACKUPDB.* \SOURCE.$DATA*.DB.PARTFILE TO \TOKYO.*.*.* Catalog name mapping: The information in MAPNAMES is also used to perform SQL catalog volume mapping. You should include MAPNAME entries if catalogs are located on different volumes or subvolumes on the destination system.
SYNCHRONIZE Command Interpreter By default NETWORKSECURE is enabled and file security is changed as follows: Source file security Destination file security “A” “N” “G” “C” “O” “U” “-” “-” The default is NETWORKSECURE, but the SECURE option overrides NETWORKSECURE. NOSAFEGUARD | NO NOSAFGUARD specifies that the Safeguard ACL for a source Enscribe disk file is not propagated to the destination when the file is synchronized.
SYNCHRONIZE Command Interpreter MapDB, in the destination file set volume. Renamed partitions, alternate indexes and protection views are named ABnnnnnn, ACnnnnnn, and so on. Note. If the destination file is audited, AutoSYNC displays a warning message and the file is not synchronized. An audited file cannot be renamed and AutoSYNC cannot temporarily unaudit the file to rename it because the file is opened. Note.
SYNCHRONIZE Command Interpreter selects object files (code 100, 700 and 800 files) for synchronization by comparing the binder or linker timestamps of the source and destination. For all other file types in the fileset, the usual modification timestamp is used. The destination object file is replaced if the binder or linker timestamps of the source and destination do not match exactly; the comparison operates as if TIMEEXACT were specified.
TIME Command Interpreter A warning is written into the log file when an uncontained symbolic link has been skipped. The default is ALLSYMLINKS. OWNERG[ROUP] { group-id | group-user } the group ID of the destination file set. If OWNERGROUP is omitted, the group ID is one of: the group ID specified in the OWNER option, if it is entered the group ID of the source file otherwise. SECURE "rwxrwxrwx" the security of the destination file set. "rwxrwxrwx" settings are for user, group and others.
UPDATE Command Interpreter UPDATE Modifies field values in records from an Enscribe file. Most of the parameters are identical to COPY.
UPDATE Command Interpreter file the name of the Enscribe file that is to be modified by the command. selection-options COMParelen <1-to-255 > sets the compare length for generic positioning on the record key (primary or alternate) specified in the FIRST KEY option. The compare length must be less than or equal to the key specified. COUNT num-records is the number of records or rows to be copied. If omitted, all records are copied.
UPDATE Command Interpreter ALTKEY key-value [, key-value ] the alternate key of the starting record or row. The format of key-value is described above. EXACT requests exact positioning on the record key (primary or alternate) specified in the FIRST KEY option. FROMLAST positions on the last record in the key range specified in the FIRST KEY option. REVERSE the input file is to be READ from the starting record in reverse order. SHARE the file is to be opened in shared-exclusion mode.
UPGRADE MAPDB Command Interpreter UPGRADE MAPDB Creates additional tables in a configured MapDB (that is, the MapDB subvolume and monitor process are registered in the SysDB). AUTOSYNC prompts the user to issue the command if and when necessary. UPGRADE MAPDB subvol; subvol the name of a MapDB to upgrade. VOLUME Changes the default volume and/or subvolume for filename expansion. It can be abbreviated to V. Volume [ volume | subvolume | volume.
9 Reporting Function This section describes the AutoSYNC reporting function. The topics covered are organized as follows: Overview REPORT Command Report Output Format Overview The AutoSYNC reporting function compares source and destination file sets and reports on the status of source and destination locations. It can aid in system migration by providing ad-hoc reports on migrated subvolumes, volumes or systems during the migration process.
Reporting Function REPORT Command The report can be written to a disk file. If no report file is specified, the report is displayed at the terminal.
Reporting Function Report Output Format Report Output Format The default REPORT output displays statistics of the files in sync, not in sync and excluded files; the list of potential entries generated are formatted as follows: Autosync Report timestamp Report Summary fileset: Source: source-fset, Destination: destination-fset n Files in source fileset n Subvolumes in source fileset n Volumes excluded n Subvolumes excluded n Files excluded from sync n Audited n Corrupt n Excluded specified n
Reporting Function Report Output Format If DETAIL is specified, the filename, file attributes, status indicator and the selection criteria are displayed for each file; in addition, the summary statistics are displayed at the end of the report. Filenames are grouped by subvolume. The extra files in the destination subvolume (files that are not in the source file set) are displayed first, in alphabetical order; for OSS file sets, extra files are listed last in alphabetical order.
Reporting Function Report Output Format The following example shows a sample report for a Guardian file set, where the EXCLUDE, PURGE and EXCLUDEPURGE options are specified: : AutoSYNC 1? report sync testdata.* to \dest.$data.testdata.*, purge, AutoSYNC 1+ excludep \dest.$data.jojoexcl.excludep, exclude jojoexcl.exclude; Starting SYNCfset $SDATA.testdata.* ($X1KLD) File $SDATA.testdata.RCRDEXIT excluded from synchronization. File $SDATA.testdata.RDEMP excluded from synchronization. File $SDATA.testdata.
Reporting Function Report Output Format The following example shows a sample report for a OSS file set, where the PURGE option is specified: AutoSYNC 5? AutoSYNC 31? report sync /home/cssw/johanne to /E/YOSPRD/home/cssw/johanne,purge; Starting SYNCfset /home/cssw/johanne ($X0YP8) -- Report completed for fileset -- /home/cssw/johanne -- to -- /E/YOSPRD/home/cssw/johanne. --- REPORT completed successfully. Autosync Report 8/24/07 12:37:44.
A Operations and Management This appendix describes the management of AutoSYNC. The topics covered are the following: AutoSYNC Configuration Database The AutoSYNC Monitor Monitor Commands Configuring and Using an Alternate AutoSYNC Environment AutoSYNC Defines Takeover Procedures Migrating the Configuration Database AutoSYNC Configuration Database The configuration information is stored in two subvolumes: 1. SysDB: global parameters and licensing information 2.
MapDB Operations and Management MapDB MapDB stores configuration parameters for scheduled synchronizations. The tables in the MapDB subvolume are: A REGISTRY table to store local parameters. Local parameters are analogous to global parameters stores in the SysDB REGISTRY table, but they apply only to a specific MapDB/monitor pair.
The AutoSYNC Monitor Operations and Management In FUP, rename the current log file and create the new file: RENAME SLggguuu, OLDLOG SET LIKE OLDLOG SET EXT (primary-extent, secondary-extent) MAXEXTENTS maxextents CREATE SLggguuu EXIT In AutoSYNC CI, reactivate the synchronizations for the syncuser: ACTIVATE SYNCUSER userID; The log file is opened once, when the synchronization process starts up. SUSPEND stops the synchronization process and ACTIVATE restarts the synchronization process.
Configuring the Monitor Process Operations and Management Configuring the Monitor Process The monitor is configured and started when the MapDB is created through the CREATE MAPDB command. The monitor has an assigned default process name, $ZASY, reserved for AutoSYNC. The monitor configuration can be changed by using the ALTER MONITOR command. You can configure process priority, process CPUs, and the monitor event-logging device.
Stopping a Monitor Operations and Management Stopping a Monitor The monitor process should be available for scheduled synchronizations to occur. If the monitor is stopped, synchronizations in progress will continue, but none are started. In normal situations, however, the monitor process should be stopped only when the system is being shut down. Use the STOP MONITOR command to stop the monitor. Monitor Commands The monitor accepts interactive command requests from AUTOSYNC.
LOG Operations and Management LOG The LOG command starts (and stops) the logging of monitor activity. LOG { TO file [CLEAR] | STOP } TO file [CLEAR] the name of a log file. CLEAR empties the file before logging commences. If file already exists, information is appended to the end of the file unless CLEAR is specified. If the file name ends with a number (for example, LOG001), additional files will be allocated with incrementing numbers when the first file becomes full. STOP stops logging.
SECURITY Operations and Management LICENSE requests information about the AutoSYNC license for the current system. TCPIP requests information about the configured listener processes. SECURITY The SECURITY command instructs the monitor to accept further commands only from a specific set of process access ids. SECURITY { N | C | U | A | G | O | - } The command option is a single character and is a Guardian security specifier.
Installing an Alternate Version of AutoSYNC Operations and Management AutoSYNC can use the same SysDB concurrently. See Configuring an Alternate SysDB below for details. Installing an Alternate Version of AutoSYNC If you wish to run different versions of AutoSYNC on your system, you first must install the alternate version in its own product subvolume. Run the INSTALL macro from the installation subvolume that contains the desired version, specifying the alternate product subvolume of your choice.
Configuring an Alternate Monitor Process Operations and Management Create an alternate MapDB Create the alternate MapDB using the CREATE MAPDB command, specifying the alternate monitor process name. This command starts the monitor process. In the example below, the user creates a test MapDB in $DATA.ASZMAPDB with monitor $ZASZ, from the same alternate product subvolume $data.asyaakts created as an example above in Installing an Alternate Version of AutoSYNC. 1> $data.asyaakts.
Configuring an Alternate Monitor Process Operations and Management In the example below, the user wishes to disable synchronization over TCP/IP for the new environment, for testing purposes and does so by setting the local SYNCoverip parameter: AutoSYNC 2? info globals; AutoSYNC Global Settings AutoSYNC SYNCcompress SYNCrecover SYNCoverIP SYNCTCPPROCesses EMSCollector ON OFF ON ON $ZTC0,$ZTC1 $0 AutoSYNC 3? alter local syncoverip off; --- AutoSYNC Local AUTOSYNCOVERIP updated.
Configuring an Alternate SysDB Operations and Management Specify the monitor process name on the AUTOSYNC run command: 3> $data.asyaakts.autosync $ZASZ HP Nonstop(tm) AutoSYNC(tm) Command Interpreter(T2713H01) - System \ATOM (C)2006 Hewlett Packard Development Company, L.P. (C)2006 Carr Scott Software Incorporated In AUTOSYNC, use the OPEN monitor-process command. 4> $data.asyaakts.
Configuring an Alternate SysDB Operations and Management Add the SysDB define Use the =_AUTOSYNC_SYSDB class catalog define to specify an alternate SysDB subvolume. Do not use the ESCSYSDB subvolume name. 1> add define =_autosync_sysdb,class catalog,subvol $data1.mysysdb 2> autosync HP Nonstop(tm) AutoSYNC(tm) Command Interpreter(T2713H01) - System \ATOM (C)2006 Hewlett Packard Development Company, L.P. (C)2006 Carr Scott Software Incorporated *Warning* The SysDB cannot be found.
AutoSYNC Defines Operations and Management define is the only way to specify an alternate SysDB. Use the ENV command to verify which SysDB and MapDB you are currently accessing. Autosync 1? env; ---------------------------------------CI Session Environment ---------------------------------------Process: $Z6LD (7,163) (priority 145) Volume $RWC.AUTOSYNC Dictionary None SQL catalog None SysDB $DATA1.MYSYSDB (9607180a) MapDB $DATA.
Takeover Procedures Operations and Management The =_AUTOSYNC_SYSDB DEFINE is class CATALOG and specifies a subvolume for the SysDB tables. If this DEFINE is present when AUTOSYNC is started, it does not look for the normal SysDB, but uses the one specified. Thus, it operates only with MapDBs and monitor processes that are created under the specified SysDB. A typical =_AUTOSYNC_SYSDB DEFINE is added by using the following TACL command: ADD DEFINE =_AUTOSYNC_SYSDB,CLASS CATALOG,SUBVOL $vol.
Unplanned Takeover Operations and Management SUSPEND SYNCUSER ALLUSERS; SUSPEND SYNCFILESET *; / SUSPEND BATCHID *: 3. Re-issue the STATUS SYNC, DETAIL command to confirm that there are no ASYSYNC processes that are still active. Note that SUSPEND will terminate a scheduled synchronization at the end of the current file being synchronized, so there may still be synchronization activity for a short period. 4. Proceed with the usual shutdown procedures, which will stop the AutoSYNC monitor.
Migrating the Configuration Database Operations and Management 3. When primary processing has been switched back to \P and \B becomes the destination system again, re-allow \B to accept synchronizations from \P on \B:. CLEAR AUTOSYNC FROM \P; Migrating the Configuration Database The AutoSYNC configuration files and tables are described above in paragraph AutoSYNC Configuration Database. The information stored in database tables references local file names, system names and system numbers.
Migrating an AutoSYNC Source System Operations and Management 3. If synchronizations are performed over TCP/IP, configure the TCP/IP connection as described in Synchronization Over TCP/IP on page 7-1 and as instructed by the network administrator. 4. At this point, issue the STATUS MONITOR command to verify the new environment is correctly configured. 5. Configure the AutoSYNC GLOBAL and LOCAL parameters, using infog as the command file. 6.
Migration Steps for an AutoSYNC Destination System Operations and Management Migration Steps for an AutoSYNC Destination System On the Existing Source System Moving a destination system requires updates to the syncfileset definitions on the source system. 1. Capture the syncfileset configuration information for each syncuser as described in Steps 4 described in paragraph On the Existing Source System on page A-16 above. 2.
B Problem Resolution This appendix discusses how to diagnose AutoSYNC problems, how to use the tools and how to report problems. The topics covered are: Common Security Problems Troubleshooting Tools Submitting Problems Common Security Problems Security related problems are common when first configuring AutoSYNC and performing synchronizations. Security rules enforced by SafeGuard and Guardian must be taken into consideration when planning and installing AutoSYNC.
Scheduled Synchronization Problems Problem Resolution Scheduled Synchronization Problems The source synchronization process creation fails with security violation Verify that the ASYSYNCP object file in the source product subvolume is PROGID’ed to the Authorizer. Verify that the Authorizer has permission to log down to the sync user ID. If not, make ASYSYNCP callable, to bypass the restriction. See Bypassing Disabled Log Down on page 4-7 for details.
Errors executing triggers Problem Resolution Synchronization of OSS files fails with error 4001 or error 4013. Check the owner of the source file. If the user is not the owner of the source file, only SUPER.SUPER can synchronize the file or directory. Moreover, if the destination is on a remote system, the remote synchronization process must be configured to run as a local process. See Running the Destination Synchronization Process as a Local Process on page 3-21 for configuration instructions.
Troubleshooting Tools Problem Resolution As mentioned in the paragraph above, verify that the MapDB log file SLgggnnn is secured to allow write access from both source and destination synchronization processes. Troubleshooting Tools AUTOSYNC Commands Synchronization Logs Events in the EMS Log AutoSYNC Tracing AUTOSYNC Commands Checking the Environment The overall processing environment can be checked using the CI command ENV.
Synchronization Logs Problem Resolution A character identifying the process that logged the entry: C— AutoSYNC configuration changes s— ASYSYNC-S - source system d— ASYSYNC-D - destination system t— trigger command output b— BACKUP r— RESTORE p— Report output line A text message If the synchronization is over EXPAND, both source and destination synchronization processes open the log file on the source system and write their respective messages into the log file.
Synchronization Logs Problem Resolution Autosync 1? info syncf 2,log last 1; Autosync User: 100,1 (sysman.user1) ID Source fileset Destination fileset Batch Intvl --- ------------------------ --------------------------------- ----- ----2 $DATA.STUFF* \SYSB.$DATA.STUFF.* 0 2 Log Starting Time: 2001-02-09 14:46:53.
Synchronization Logs Problem Resolution One-Time Synchronizations One-time synchronizations are launched using the SYNCHRONIZE command. AUTOSYNC logs the output of a such synchronizations in a temporary log file that is purged after the synchronization has completed. To retain the log file, use the LOGFILE option of the SYNCHRONIZE command. The format and content of the log file are identical to the SLggguuu log for scheduled synchronizations.
Events in the EMS Log Problem Resolution Events in the EMS Log The AutoSYNC monitor and the synchronization processes report informational and critical events to the EMS log on the source system. The Monitor events are sent to the Monitor’s home terminal. To direct all AutoSYNC events (from ASYSYNC processes and the Monitor) to the same collector, configure the Monitor’s home terminal to the local collector.
AutoSYNC Tracing Problem Resolution AutoSYNC Tracing For cases where a problem is not diagnosed by looking at the synchronization log, support personnel may request that the synchronization sessions be traced. Tracing is enabled for all syncfilesets belonging to a syncuser. To start tracing, use the TRACE option of the ALTER SYNCUSER command. The syncuser must be suspended and re-activated to start tracing. Tracing generates a large amount of data.
Submitting Problems Problem Resolution The following example traces a synchronization attempt where no files require synchronization. Autosync 3? info syncf 1,log last 1; Autosync User: 100,1 (SYSMAN.USER1) ID Source fileset Destination fileset Batch Intvl ---- ------------------------- --------------------------------- ----- --1 $DATA2.STUFF.* \SYSB.$DATA2.STUFF.* "JC" 1 Log Starting Time: 2001-02-09 16:39:11.373 s-PROCESS_CREATE_(\SYSB.$DATA2.JCC153.ASYSYNC,\SYSB.$Y2769:24726817) s-FILE_OPEN_(\SYSB.
AutoSYNC Component Failures Problem Resolution AutoSYNC Component Failures When the monitor process, AUTOSYNCCI or a synchronization process abend, they produce a saveabend file. The monitor displays a message on its hometerm or the configured EMS collector process and the command interpreter displays a message on its out file.
Scheduled Synchronization Failures Problem Resolution The log of the synchronization, either by PAKíng the log file (SLnnnggg) or by sending the output of the INFO SYNCF fset-ID, LOG command A VPROC listing of the ASYSYNC(P) process When the log does not yield sufficient diagnostic information, trace the syncfileset and send the trace along with the remaining supporting data.
C Examples These examples are intended to assist you in becoming acquainted with the use of the AutoSYNC product. These examples assume that the product has been successfully installed, licensed and that the monitor process is running. One-Time Synchronization Guardian file set SYNCHRONIZE the source file set $DATA.JOJOX*.* to the destination file set \DEST.$DATA.*.
OSS file set Examples OSS file set To synchronize the local directory tree home/dev/jojo to the destination node NSK2:i AutoSYNC 10? sync /home/dev/jojo to /E/NSK2/home/dev/jojo, timeexact; Starting SYNCfset /home/dev/jojo Source Directory: /home/dev/jojo/ ( .
Scheduled Synchronization Examples Scheduled Synchronization Single-User Environment In the single-user AutoSYNC environment, you install and configure AutoSYNC. The following commands show how to configure a single-user scheduled synchronization: Autosync 1? ADD SYNCUSER 110,125, MAXPRIORITY 130; --------- MapDB table $F08.ASYMAPDB.SF110125 created. MapDB table $F08.ASYMAPDB.SL110125 created. AutoSYNC user 110,125 (OPER.JOE) added. Monitor $ZASY cache refreshed.
Multiple-User Environment Examples Autosync 8? DELETE SYNCFileset 1; --- AutoSYNC fileset ID 1 deleted. --- Monitor $ZASY cache refreshed. Autosync 9? INFO SYNCFileset; AutoSYNC User: 110,125 (OPER.JOE) ID Source fileset Destination fileset Batch Intvl ---- ------------------------- --------------------------------- ----- ----0 $DATA.GROUP0.* \PROD.$DATA.GROUP0.* 0 5 Autosync 10? STATUS SYNC; SYNCuser: 110,255 (OPER.
Multiple-User Environment Examples configure a multiple-user environment where SUPER.SUPER is the AUTHORIZER. After logging on as SUPER.SUPER: Autosync 1? AUTHORIZE AUTOSYNC, ADMINistrator 110,255; User 110,255 (OPER.MGR) has been authorized as AutoSYNC administrator. The AutoSYNC monitor process must be started by user 255,255 (SUPER.SUPER). --- Monitor $ZASY cache refreshed. Log on as OPER.MGR: Autosync 2? ADD SYNCUSER OPER.JOE, PRIORITY 140; --------- MapDB table $F08.ASYMAPDB.SF110125 created.
Multiple-User Environment Examples Autosync 7? INFO SYNCFileset 0, DETAIL; AutoSYNC User: 110,125 (OPER.JOE) SyncID: 0 Source fileset: $DATA.GROUP1.* Destination fileset: \PROD.$DATA.GROUP1.
D Error Messages This appendix describes the EMS messages generated by AutoSYNC.
Informational messages Error Messages Effect. The monitor stops. Recovery. Restart the monitor. 103 Monitor takeover Cause. The monitor primary process or its CPU has failed. Effect. The monitor backup process has taken over. The monitor is ready to service requests. Recovery. Informational message. No action is required. 104 Monitor backup created Cause. The monitor primary process has created a backup process. Effect. The monitor process is fault tolerant. Recovery. Informational message.
Informational messages Error Messages 107 Monitor status info Cause. The monitor process has displayed status information. Effect. Status information is placed in the EMS log. Recovery. Informational message only; no corrective action is needed. 108 Monitor started ASYSYNC process Cause. The monitor process has started an ASYSYNC process to perform AutoSYNC synchronization. The message contains the user id that configured the synchronization, the destination node, and the process name. Effect.
Informational messages Error Messages 111 ASYSYNC process lost Cause. An ASYSYNC process has stopped or abended, but no process-stop message was received. This may be caused by a CPU failure. Effect. Informational message only; no corrective action is needed. Recovery. No action is required. The ASYSYNC process is restarted automatically. 112 Monitor cache refreshed Cause. Cached configuration information has been refreshed from the MapDB tables. Effect.
Informational messages Error Messages 115 ASYSYNC process failed Cause. The monitor process has attempted to start an ASYSYNC process to perform AutoSYNC synchronization, but the operation failed. The message contains PROCESS_CREATE_ error and error detail code. Effect. AutoSYNC processing for the specified user id is not active. Recovery. Correct the cause of the failure and the process will be restarted automatically. 120 ASYSYNC process started via TCP/IP Cause.
Informational messages Error Messages 123 Trigger TACL or OSS shell process abended Cause. An ASYSYNC process performed the TRIGGER option; it started a TACL process or an OSS shell passing the trigger command. TACL or the OSS shell abended. The message contains the user ID, destination node name, BATCHID, the file-set ID, or a -1 if not available and an the error text or the error and error detail code. Effect. Effect.
Informational messages Error Messages 142 MAPDB access error Cause. Configuration could not be accessed from the MapDB tables. Effect. Configuration information is not available to the monitor; requested services will not be performed. Recovery. Correct the table access problem and issue the MONITOR REFRESH NOW command. 143 MAPDB inconsistent Cause. Configuration information in the MapDB tables is inconsistent. Effect. The configuration information is not available on request to the monitor. Recovery.
Critical event messages Error Messages Effect. The ASYSYNC process performs an updated set of synchronizations. Recovery. Informational message only; no corrective action is needed. Critical event messages 402 Monitor intentionally abended Cause. The monitor process has been intentionally abended to produce a saveabend file for problem diagnosis. Effect. The primary monitor process abends. The backup process takes over and continues processing. Recovery. Send the saveabend file to product support.
Critical event messages Error Messages 413 Memory pool allocation error Cause. An attempt to allocate memory in the extended segment failed. Effect. The process abends. Recovery. Since the product usually resizes the segment to satisfy memory requests, this error should not occur. Report this error to product support. 414 Allocate segment error Cause. Allocation of the extended segment failed. Effect. The process abends. Recovery. The error number is provided in the message.
Critical event messages Error Messages 432 ASYSYNC version mismatch Cause. A source or destination ASYSYNC process detected a version mismatch. The process that failed and the starting process, either the AutoSYNC monitor or the source ASYSYNC process if the destination ASYSYNC process failed, have different versions. Effect. The ASYSYNC process that detected the version mismatch abends. Recovery. Install the same AutoSYNC version on the source and destination systems.
Index A Administrator 4-2 Alternate key files 3-6 ASYSYNC or ASYSYNCP privileged processes 2-10 ASYSYNCP process authorizing 2-7 Authorizer 4-2 AUTOSYNC command interpreter 8-1 AutoSYNC license 2-5, 3-1 B C Coldload procedures Updating 2-8 Completion Code in AUTOSYNC command interpreter 8-1 D Defines use in AUTOSYNC command interpreter 8-2 Destination file set 3-2 node name 4-4 Disabled log down Bypassing 4-7 EMS messages EMSFILEEVENTS B-8 EMSSUPPRESS B-8 ESCSYSDB see SysDB F Files Opened for Update 3-1
Index O O Partitioned files and tables 3-8 Purging Destination Subvolumes SUBVOLPURGE 3-14 Purging Files in Destination 3-13 Purging Subvolumes in Destination 3-14 over TCP/IP 4-10 Security Remote passwords 4-7 SFggguuu MapDB table A-2 Shutdown procedures Updating 2-8 SLggguuu MapDB file A-2 Resizing the file A-2 Source file set 3-2 SQL index tables 3-7 SQL tables 3-7 SQL views 3-8 SQL/MX tables 3-3 Symbolic Link Modification Timestamp 5-4 Synchronization Criteria 5-4 TIMEEXACT 5-5 SYNCUSER MapDB table
Index Z Users 4-3 Z ZASYTMPL EMS templates 2-8 ZYQ*.
Index Special Characters HP AutoSYNC User’s Guide—522580-018 Index-4