Transferring Objects

To transfer Entire Output Management objects from one environment to another (for example, from a mainframe to a UNIX system), you can export them from the originating environment to an XML file, and then import this XML file into the target environment.

Or you can transfer objects directly within you network environment from one Entire Output Management system file to another.

This section covers the following topics:

Exporting Objects
Importing Objects
Transferring Objects Directly

Note:
Active data (active reports, active bundles, printout-queue elements, default definitions) cannot be transferred.

Exporting Objects

To export objects, you define an export task in the originating environment. This task creates an XML file and writes the data to be exported to this file. In the export task, you specify which objects are to be written to which export file and when.

From an export file, the data can then be loaded into the target environment, as described below under Importing Objects.

This section covers the following topics:

Creating an Export Task
Modifying an Export Task
Deleting an Export Task
Browsing an Export File

Creating an Export Task

To create a new export task:

Select the System Administration > Export Task node in the object workspace.
Invoke the context menu and choose Maintain.

A list of all export tasks which have been created but have not yet been executed is displayed.
Invoke the context menu and choose New.

A window is displayed in which you can specify the task details. The fields are described below.

Field	Explanation
Object type	Select the type of object to be exported: bundles, calendars, distribution lists, physical printers, logical printers, reports, user profiles, UNIX nodes.
Object prefix	Specify a character string, optionally with the wildcards "*" (for any number of characters) and "?" (for a single character), to export all objects of the specified type whose names contain this character string.
Export node	Specify the destination of the export file. For a mainframe node, enter a node number; for a UNIX node (as defined in the UNIX defaults) enter a node name.
Export file	Specify a name for the file.
Execution time	Specify a date and time for the export to be performed by the monitor. The monitor will then end its cycle and start the export function as soon as all monitor tasks are idle.
Write detailed log	Select this field if you wish the execution of each object to be logged in the monitor log.

Alternatively, you can create an export task in batch mode in the Entire Output Management server environment.

To export objects in batch mode:

Execute a batch job which invokes the program REXPORT with the following parameters (using the current input delimiter):

object-type,prefix,log-Y/N,schedule-date (YYYY-MM-DD),schedule-time (HH:MM),export-node,export-file

Enter a line for each object type, and after that a line with a period (.).

Example for z/OS:
```
//CMSYNIN  DD  *
SYSNOM;user-ID;password
REXPORT
PR,PRINTER*,N,2014-12-12,11:28,npr_unix,$SAG/exppr.xml
US,USER*,N,2014-12-12,11:30,npr_unix;$SAG/expus.xml
CA,*,N,2014-12-12,11:30,148,ESM.NOM.EXPORT.CALENDAR
.
FIN
/*
```

Modifying an Export Task

To modify an export task:

Select the System Administration > Export Task node in the object workspace.
Invoke the context menu and choose Maintain.

A list of all export tasks which have been created but have not yet been executed is displayed.
Select the desired export task, invoke the context menu and choose Open.

A window is displayed in which you can change the task specifications. The fields are described under Creating an Export Task above.

Deleting an Export Task

To delete an export task:

Select the System Administration > Export Task node in the object workspace.
Invoke the context menu and choose Maintain.

A list of all export tasks which have been created but have not yet been executed is displayed.
Select the desired export task, invoke the context menu and choose Delete.

The task will be deleted.

Browsing an Export File

This function is used to see which data are contained in an export file.

To browse an export file:

Select the System Administration > Export Task node in the object workspace.
Invoke the context menu and choose Browse export file.
A window is displayed, in which you enter the name and path of the desired file.

The contents of the file will be displayed.

Importing Objects

The importing has to be done in the Entire Output Management server environment.

To import objects:

In the target environment, execute a batch job which invokes the program RMIMPORT in the library SYSNOM.

On UNIX systems, you can use the script nomimport.bsh as a template for invoking RMIMPORT.

RMIMPORT must be invoked with the parameters described below, and the export file must be assigned to Work File 1.

RMIMPORT reads all object data from Work File 1 and imports them into the target environment.

RMIMPORT Parameters

Parameter	Possible Values	Function
1st parameter: Overwrite objects	`Y` or `N`	Determines whether or not existing objects in the target environment are to be overwritten by objects of the same names loaded from the export file.
2nd parameter: Trace	`Y` or `N`	Determines whether a trace is to be written or not.
3rd parameter: Container file database ID	`dbid` or `0`	Specify the database ID of the container file to be used. Specify `0` if the database ID is to be the same as the one from which the objects were exported.
4th parameter: Container file number	`fnr` or `0`	Specify the file number of the container file to be used. Specify `0` if the file number is to be the same as the one from which the objects were exported.
5th parameter: Node number	`node-number` or `0`	Specify the node number to be used. Specify `0` if the node number is to be the same as the one from which the objects were exported.