In Stat, migrating file objects entails moving them to designated source file directories or developers’ working directories. For data objects, this means migrating them from one environment to another.
System administrators can set up Stat to support auto-migrating archive sets to multiple environments distributed over a network. This is done by designating particular environments within a migration path as distribution environments and then associating them with lists of interrelated environments. This way, when you migrate an archive set to a distribution environment, Stat automatically migrates the archive set to all the associated environments as well. This spares you the time-consuming task of migrating an archive set to each environment separately and is especially helpful when a migration path calls for more environments than the limit of nine that can be represented graphically.
When you migrate an archive set that contains both data objects and file objects, with the proper security rights you can choose to migrate just the data objects in the archive set, just the file objects, or both. System administrators can enforce that certain users only migrate file objects while others only migrate data objects.
It is good practice to synchronize your development workspace with your base archive set. This ensures that you are making changes to the correct version of the objects. This is true of all your environments. As you make changes, you should create interim archive sets that document those changes and then migrate them to the appropriate environments. The migration process is virtually the same, regardless of the type of archive set.
The development workspace is where you make the changes. For data objects, this is the Development environment. For file objects, it can be either the Development environment’s source file locations or the assigned developers’ working directories. It is recommended that each developer make changes to file objects in their own working directories so that the changes can be documented and controlled. System administrators can enforce that developers modify objects only in either their working directories or in the source file locations.
When an archive set contains file objects, the file archives are stored in the Stat Repository. When you migrate the archive set to a generic application environment, Stat copies the file archives from the Stat Repository to the source file locations defined for the target environment. If the file objects already reside in any of these source file locations, Stat replaces each existing instance with the archive copy. If the files exist in none of the source file locations, Stat either copies the files to all the source locations defined for the target environment or copies the files to the designated default location. These options are set up by system administrators when configuring the target environment.
To migrate file objects in an archive set to the developers’ working directories, you migrate the archive set to the Development environment. Stat gives you the option of migrating the file objects to the Development environment’s source file locations, the developers’ working directories, or to both. To migrate an archive set taken from the Development environment to the developer’s working directories, or vice versa, the migration must be initiated from the Object Management tab, not the Migration Path tab.
If two or more environments on a migration path share the same source file locations for a particular file type, whenever you migrate an archive set that contains file objects of that type to one of the environments, by default the file objects are also migrated to any other environment that shares the same source file locations. For example, if the Development environment and Quality Assurance environment share the same source file locations for COBOL file objects, and you migrate an archive set containing a COBOL file object to Development, Stat documents that the same file object was also migrated to Quality Assurance. This eliminates the time consuming process of having to perform multiple migrations in order to document the migration of the same file objects to each environment on the migration path.
NOTE: Unix and Windows-based file servers have different formats for ASCII type file objects. Accordingly, when you migrate an ASCII type file object via SFTP, the Stat Central Agent checks its destination file server. If the server is Unix, the agent converts the file to the Unix ASCII format, which means singly occurring carriage returns followed by linefeed characters are converted to linefeed characters. If the destination server is Windows, the agent converts the file to the Windows ASCII format, which means singly occurring linefeed characters are converted to carriage returns followed by linefeed characters. In either case, the size of the migrated file may be smaller or larger than it was before it was migrated.
As with file objects, data object definitions are archived in the Stat Repository. When you migrate an archive set that contains data objects, Stat copies the data object definitions from the Stat Repository to the target environment. If the data object already exists in the target environment, Stat replaces that object definition with the archived copy using the delete and insert method.