EM: File System > Online Copy Jobs

Description

Online Copy Jobs allows administrators to copy BBj/BBx data files (e.g., Mkeyed, Xkeyed, Vkeyed) from a source directory to a target location, even while the files are in active use by applications or third-party tools. Online Copy Jobs keep the destination synchronized with the source during the process, ensuring changes made mid-transfer are captured.

Administrators can configure each job by specifying a name, source and destination folders, optional transfer delay, and advanced options such as bandwidth limits and key definition changes. Jobs are created and managed visually from the Online Copy Jobs panel.

Online copy jobs provide two primary features for administrators:

Creating backups of live data files without interrupting user access.
Copying files into new formats or folder structures with optional conversion settings.

Location

EM Navigator → File System → Online Copy Jobs

Toolbar

Button	Function
	Stops the selected online copy job and halts its current progress immediately.
	Start/Resume a job.
	Opens the Online Copy Job editor to define a new job configuration.
	Opens a file selection dialog to choose an existing job configuration file.
	Refreshes the displayed online copy jobs list to show current job status information.
	Deletes/Remove the selected directory after confirming in the Confirm Delete Folder dialog.
	Opens folder browser to select directory, and allows creating new folders.
	Opens the file selection dialog to choose a file for the job.
	Enables to choose a folder/file from your local system.

Finish: Stops synchronization for the selected online copy job, leaving destination files available.

Online Copy Jobs

The Online Copy Jobs pane provides a centralized view for creating, managing, and monitoring file copy jobs. The main table displays each job under the Copy Job Name / File column, and the Progress column shows the percentage of completion for each associated file or overall job. Below the table, the Selected Item Status panel shows real-time status messages or updates for the currently selected file or job.

Online Copy Jobs Settings

Settings	Description
Copy Job Name / File	Lists all configured jobs as expandable folders, with each file inside representing part of the job.
Progress	Displays the synchronization progress for each file or job.
Selected Item Status	Shows real-time status messages for the job or file currently selected in the panel.

Creating an Online Copy Job

From the Online Copy Jobs pane, click the icon in the top-right toolbar. This opens the job creation panel, where you can begin configuring a new Online Copy Job.

Creating an Online Copy Job Settings

Settings	Description
Job Name	Sets a custom name to identify the online copy job.
Host Name	Indicates the server that will run the job.
User Name	Displays the user account performing the job.
Use SSL	When unchecked, disables SSL encryption, allowing unencrypted communication without secure data protection. When checked, enables secure communication via SSL.
Keystore	Specifies the path to the SSL keystore file, if SSL is used.
Maximum Bandwidth(kbps)	Limits the bandwidth used by the job to reduce resource load.
Port	Specifies the port number used to connect to the server (default is 2000).
Password	Used to authenticate the user for the job operation.
Advisory Locking	When unchecked, disables advisory file locking, allowing unrestricted file access during copying. When checked, enables advisory file locking during backup operations to avoid access conflicts.
Keystore Password	Password for accessing the keystore file.
Delay Between Record Copies(ms)	Sets a delay between copying each record to manage system impact.
Description	Optional field to add notes or job details for future reference.
File Name	Displays each data file name included in the job.
Type	Shows the file’s format.

Browse for Folder Dialog

After completing the required fields in the Online Copy Jobs pane clicking the icon opens the Browse For Folder dialog to navigate and select a directory. Inside this dialog, clicking the icon again enable user to Create New Folder before selection. The folder path then appears in the Directory Name field, and clicking OK adds it to the copy job. The icon removes a selected directory from the list, and the refresh button icon updates the folder view to display any recent additions or changes.

Select Files for Copy Job

Clicking the icon opens the File Browser, where the user selects a file from local system or clicking the icon to Create New Folder for selection. After selecting a file, a Destination Information dialog prompts for the Destination Directory and an optional File Extension. Clicking OK confirms the selection, and the file then appears in the Online Copy Jobspane in the File Name column.

File Properties Configuration

Clicking the icon opens the File Information pane to configure source and target file settings. The Column Mapping tab defines column relationships, and the Keys/Indexes tab sets key structures, completing advanced file properties for the online copy job.

File Properties Configuration: File Information

This panel provides configuration for source and target file paths, templates, record sizes, and file types. Users can define detailed file properties to ensure accurate structure and compatibility when processing files in the online copy job.

File Information Settings List

Settings

Functions

Source File

The file to be copied in the job. Clicking

icon opens the file browser where you can navigate local directories and select a file to display its full path. Additionally, clicking

opens the Create New Folder dialog if a new directory is needed before selection. Once a file is highlighted, clicking Open confirms the selection and adds it to the File Name list in the Online Copy Jobs pane for processing.

Source Template

The layout or structure of the source file’s records, which helps in interpreting its contents correctly.

Source Record Size

The record length of the source file; accepts numeric values or -1 when the record size is undefined or variable.

Source File Type

The source file’s BBj type when known, used for correct processing and compatibility during the online copy operation.

Target File

The destination file path for copied output. Clicking the

icon opens file browsing; selecting and confirming a file automatically inserts its full path into this field.

Target Template

The template applied to the target file. The copy icon automatically duplicates the content from the Source Template field into this Target Template field when clicked.

Automatically Calculate Target Record Size

When unchecked, enables manual entry of the target record size, allowing users to define their preferred recording value.
When checked, automatically calculate the target record size and disables editing.

Target Record Size

Allows manual entry of the desired target record size when automatic calculation box is uncheked.

Target File Type Same As Source

Allows selecting the desired target file type format for the copied file’s structure and behavior.

Target File Type

The required file type for the target file format used in the online copy job.

Value	Description
MKeyed	Defines a multi-keyed BBj data file supporting multiple primary and alternate keys.
MKeyed:Recoverable	Multi-keyed BBj data file with recoverable transaction logging to protect data integrity.
Mkeyed:64bit	Multi-keyed BBj data file using 64-bit addressing for very large dataset.
MKeyed:64bit:Recoverable	64-bit multi-keyed data file with recoverable transaction logging for safer operations.
XKeyed	A single-keyed BBj data file using extended indexing capabilities.
XKeyed:Recoverable	Single-keyed data file to support recoverable file operations.
VKeyed	Variable-length keyed file supporting flexible record structures stored with indexing.
Indexed	File format with an index structure enabling fast key-based record access operations.
Serial	Sequential record file storing data in strict serial order without indexing capabilities.
Direct/Sort	Direct access file supporting sorted record management optimized for quick retrieval.

File Properties Configuration: Column Mapping

The Column Mapping tab allows users to define how each source column corresponds to a target column, ensuring correct field alignment during copying. It supports accurate data structure translation and prevents mismatches between source and destination file layouts.

Column Mapping Settings

Column	Description
Source Column	Identifies the selected field in the source file that will be mapped to its corresponding destination field during the copy process.
Target Column	The destination field in the target file to receive mapped data during the online copy job transformation process.

File Properties Configuration: Keys/Indexes

The panel defines the target file’s key structure, enabling selection of single-key or multi-key formats, key numbering, uniqueness, and segment details. It ensures target indexing aligns with BBj file requirements for correct record retrieval and optimized data access performance.

Keys/Indexes Settings

Settings	Description
Target Is Single Keyed File	When unchecked: Enables multiple keys support, allowing configuration of additional key definitions and complex indexing for improved retrieval flexibility. When checked: Defines the target file as single-keyed, enabling configuration of one primary key for record access efficiency.
Source Key Size	The byte length of the source file’s primary key, automatically derived based on selected source file structure.
Target Key Size	The byte length used for the target file’s primary key, determined by selected target file structure.
Target Supports Multiple Keys	When unchecked, target file limited to a single primary key configuration, disabling the multi-key definition options within this panel. When checked, Target file allowed multiple defined keys, enabling configuration of additional key numbers and corresponding segment structures.
Unique	Marks the selected key as enforcing uniqueness, ensuring stored records cannot contain duplicate key values.
Key Number/Name	Identifies each key’s assigned index number and descriptive label used for defining lookup and access behavior.
Segments	Defines specific field ranges comprising each key, controlling how records are indexed and retrieved efficiently.