The Transfer Object facility enables the system administrator to copy objects to a target environment on another database, for example, to transfer objects from a test environment to a production environment.
This section covers the following topics:
To invoke this facility:
Enter 10 in the command line of the
System Administration Menu.
The Transfer Object Menu is displayed.
13:07:40 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15
User ID XYZ - Transfer Object -
Transfer
1 Bundle Definitions
2 Calendar Definitions
3 Distribution List Definitions
4 Logical Printer Definitions
5 Physical Printer Definitions
6 Report Definitions
7 User Definitions
Please select option.
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip Menu
|
Objects not yet existing in the target environment will be copied.
Dependent (related) objects have to be copied first. To ascertain which the
related objects are, you use the line command
XR.
The following fields are common to all screens of the Transfer Object facility:
| Field | Explanation |
|---|---|
| Source NOM-DB/FILE | Source database ID and file number from which the object is being copied. |
| Target NOM-DB/FILE | Target database ID and file number to which the object is being copied. |
| exist | Indicates whether the object exists in the target environment (yes/no). |
| Msg |
Possible values:
|
On the object-specific screens of the Transfer Object facility, you can mark the individual objects with the following line commands:
| Command | Function |
|---|---|
| CO | Copy - The object definition is copied to the to target environment. |
| XR | Cross-reference - Objects related to the object are displayed. This line command is only available for object types where related objects are relevant. |
To list existing bundles:
Enter 1 in the command line of the
Transfer Object Menu.
The "Copy Bundle to Target Environment" screen is displayed.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All bundles existing in the source environment will be listed:
18:36:00 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15
User ID XYZ - Copy Bundle to a Target Environment -
Source NOM-DB/FILE ... 88 (DB) 51 (FILE)
Target NOM-DB/FILE ... __88 _14_________________ Authorisation N (Y/N)
Cmd Bundle Description NumRep exist Msg
___ _________________________ ______________________________ ______ _____ _______
__ GHH-DEMO no
__ GHH-TEST no
__ DEP-ADMA Created by PWR-EMPL-STD1-S 6 no
__ DEP-COMP Created by PWR-EMPL-STD1-S 23 no
__ DEP-DEPT Created by DB-POWER-BIG1-S 21 no
__ DEP-FINA Created by PWR-EMPL-STD1-S 11 no
__ DEP-HUGO Created by PWR-EMPL-STD1-S yes
__ DEP-MARK Created by PWR-EMPL-STD1-S 11 no
__ DEP-MASK Created by PWR-EMPL-STD1-S 5 no
__ DEP-MGMT Created by PWR-EMPL-STD1-S 26 no
__ DEP-PROD Created by PWR-EMPL-STD1-S 10 no
All
Command => ___________________________________________________________________
CO copy XR xref
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Ext Menu
|
With PF9 (Ext) you can switch to short names display.
For every bundle, its name, a short description and the number of reports contained in the bundle are displayed.
By using asterisk notation in the input field above the names, you can restrict the list to contain only certain bundles.
To copy a bundle to a target environment:
On the "Copy Bundle to Target Environment" screen, enter the line
command CO next to the bundle to be copied.
The bundle will be copied to the specified target file.
To display related objects and related reports for a bundle:
On the Copy Bundle screen, enter the line command
XR next to the bundle for which to display
information.
Two windows with the following information are displayed:
| Fields | Explanation |
|---|---|
| Coordinator | Name of the bundle coordinator. |
| Trigger Reports | Reports specified to trigger automatic bundle printing. |
| Printer | Printer(s) specified for automatic printing. |
| Field | Explanation |
|---|---|
| Seq | Sequence in which the report is printed within the specified group or bundle. |
| Report | Report name. |
To list existing calendars:
Enter 2 in the command line of the
Transfer Object Menu.
The Copy Calendar to a Target Environment screen is displayed.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All calendars existing in the source environment will be listed:
13:19:14 **** ENTIRE OUTPUT MANAGEMENT ***** 2008-11-15
User ID XYZ - Copy Calendar to a Target Environment -
Source NOM-DB/FILE ... 88 (DB) 51 (File)
Target NOM-DB/FILE ... _88 _14
Cmd Calendar Year exist Msg
___ ________ ____ _____ _______
__ GHH 2005 yes
__ DEMO-CAL 2007 yes
__ LAMPE 2008 no
__
__
__
__
__
__
__
__
__
All
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Menu
|
For every calendar, its name and year are displayed.
By using asterisk notation in the input field above the names, you can restrict the list to contain only certain calendars.
To copy a calendar to the target environment:
On the "Copy Calendar to a Target Environment" screen, enter the
line command CO next to the calendar to be
copied.
The calendar will be copied to the specified target file.
To list existing distribution lists:
Enter 3 in the command line of the
Transfer Object Menu.
The "Copy Distribution List to Target Environment" screen is displayed.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All distribution lists existing in the source environment will be listed:
13:20:52 **** ENTIRE OUTPUT MANAGEMENT ***** 2008-11-15
User ID XYZ - Copy Distribution List to a Target Environment -
Source NOM-DB/FILE ... 88 (DB) 51 (File)
Target NOM-DB/FILE ... _88 _14
Cmd List Description Member Part of exist Msg
___ ________ ____________________________________ ______ _______ _____ _______
__ BERTA 4 no
__ DC-GROUP Mitglieder der DC Gruppe 4 no
__ HUGO no
__
__
__
__
__
__
__
__
__
All
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Menu
|
For every distribution list, the following is displayed: its name, a short description, the number of its members. An asterisk (*) in the field "Part of" indicates that the distribution list is part of another distribution list.
By using asterisk notation in the input field above the names, you can restrict the list to contain only certain distribution lists.
To copy a distribution list to the target environment:
On the Copy Distribution List screen, enter the line command
CO next to the distribution list to be copied.
The distribution list will be copied to the specified target file specified.
To display related objects for a distribution list:
On the Copy Distribution List screen, enter the line command
XR next to the distribution list for which to
display information.
A list of all users and distribution lists that are members of the selected distribution list is displayed.
To list existing logical printers:
Enter 4 on the command line of the
Transfer Object Menu.
The "Copy Printer to a Target Environment" screen is displayed.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All logical printers existing in the source environment will be listed:
13:22:57 **** ENTIRE OUTPUT MANAGEMENT ***** 2008-11-15
User ID XYZ - Copy Printer to a target Environment -
Source NOM-DB/FILE ... 88 (DB) 51 (File)
Target NOM-DB/FILE ... _88 _14
Cmd Printer Description Location exist Msg
___ ________ ____________________ ______________________________ _____ _______
__ ABC Print to Connect CON no
__ ABCDE VTAM Printer DAEPRT14 no
__ A234 no
__ DAEPRT12 no
__ DAEPRT14 DC Group Printer VTAM Printer DAEPRT14 no
__ GWPWR no
__ MRSCNT0 Print to Connect CON no
__ MRSCNT1 Print to Connect CON no
__ MRSCNT11 Connect Printer no
__ MRSCNT21 Connect Printer no
__ MRSCNT31 Connect Printer no
__ MRSPWR Print to POWER Print to Power no
Top Of Data
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Menu
|
For every logical printer, its ID, a short description, and the location of the associated physical printer (as taken from the definition of the physical printer) are displayed.
By using asterisk notation in the input field above the printer IDs, you can restrict the list to contain only certain printers.
To copy a logical printer to the target environment:
On the Copy Logical Printer screen, enter the line command
CO next to the logical printer to be copied.
The printer will be copied to the specified target file.
To display related objects for a logical printer:
On the Copy Logical Printer screen, enter the line command
XR next to the logical printer for which to display
information.
The name of the physical printer associated with the logical printer is displayed.
To list existing physical printers:
Enter 5 in the command line of the
Transfer Object Menu.
The "Copy Physical Printer to a Target Environment" screen is displayed.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All physical printers existing in the source environment will be listed:
13:26:58 **** ENTIRE OUTPUT MANAGEMENT ***** 2008-11-15
User ID XYZ - Copy Physical-Printer to a target Environment -
Source NOM-DB/FILE ... 88 (DB) 51 (File)
Target NOM-DB/FILE ... _88 _14
Cmd Vtam ID Location exist Msg
___ ________ __________________________________________________ _____ _______
__ CON-NECT yes
__ CONNECT1 no
__ CONNECT2 no
__ CONNECT3 no
__ DAEPRT12 no
__ DAEPRT14 VTAM Printer DAEPRT14 no
__ HPSPOOL no
__ MRSPRPWR Print to Power no
__ SYSPRJES yes
__ SYSPRPWR yes
__ TAPEVSE yes
__
All
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Menu
|
For every physical printer, its VTAM ID (or SYSPRINT for system printers, or DISK for printing to disk) and its location are displayed.
By using asterisk notation in the input field above the VTAM IDs, you can restrict the list to contain only certain printers.
To copy a physical printer to the target environment:
On the Copy Physical Printer screen, enter the line command
CO next to the printer to be copied.
The printer will be copied to the specified target file.
To list existing reports:
Enter 6 on the command line of the
Transfer Object Menu.
The "Copy Report to a Target Environment" screen is displayed.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All reports existing in the source environment will be listed:
18:56:20 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15
User ID XYZ - Copy Report to a Target Environment -
Source NOM-DB/FILE ... 9 (DB) 242 (FILE)
Target NOM-DB/FILE ... ____9 __243
Cmd Report Description exist Msg
___ _________________________ __________________________________ _____ _______
__ STD22-VENT94 ( STD2 ) Standard Exit 2 example yes
__ STD22-VENT96 ( STD2 ) Standard Exit 2 example yes
__ UEX-ADDFP-OPEN Exit ADDFP/OPEN separate sysout in yes
__ UEX-CARS-STD1 Standard Exit 1 example yes
__ UEX-CREATE Exit CREATE report yes
__ UEX-DEFAULT Report definition for undefined SY yes
__ UEX-EMPL-STD1-ASA Standard Exit 1 Example yes
__ UEX-EMPL-STD1-MCC Standard Exit 1 Example yes
__ UEX-EMPL-STD2-ASA Standard Exit 2 example yes
__ UEX-EMPL-STD2-MCC Standard Exit 2 example yes
__ UEX-EMPL-STD31ASA Standard Exit 3 example yes
More ...
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Ext Menu
|
With PF9 (Ext), you can toggle to short names display.
For every report, its name and a short description are displayed.
By using asterisk notation in the input field above the report names, you can restrict the list to contain only certain reports.
To copy a report to the target environment:
On the Copy Report screen, enter the line command
CO next to the report to be copied.
The report will be copied to the specified target file.
To display related objects for a report:
On the Copy Report screen, enter the line command
XR next to the report for which to display
information.
The Display Related Objects window is displayed. It contains the following fields:
| Field | Explanation |
|---|---|
| User/List | User or distribution list in the Distribute to ... field of the report definition. |
| Printer | Logical printer defined for automatic printing of the report. |
To list existing users:
Enter 7 on the command line of the
Transfer Object Menu.
The "Copy User to a Target Environment" screen appears.
Enter the ID of the target database in the Target ... (DB) field and the number of the target file in the Target ... (File) field.
All users existing in the source environment will be listed:
13:31:30 **** ENTIRE OUTPUT MANAGEMENT ***** 2008-10-31
User ID XYZ - Copy User to a Target Environment -
Source NOM-DB/FILE ... 88 (DB) 51 (File)
Target NOM-DB/FILE ... _88 _14
Cmd User ID Name exist Msg
___ ________ __________________________________________________ _____ _______
__ BROW Brown, Hollis yes
__ DUPR Dupree, Mitzi no
__ ECCL Eccles, Jennifer no
__ GOOD Goode, Johnny B. no
__ LAYN Layne, Arnold no
__ LONG Long, Mary no
__ MCGE McGee, Bobby no
__ RACC Raccoon, Rocky no
__ RATL Ratlos, Rudi no
__ RIGB Rigby, Eleanor no
__ STAR Stardust, Ziggy yes
__ WILD Wilde, Irene no
Top Of Data
Command => ___________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Flip - + Menu
|
For every user, the user ID and name are displayed.
By using asterisk notation in the input field above the user IDs, you can restrict the list to contain only certain users.
To copy a user to the target environment:
On the Copy User screen, enter the line command
CO next to the user to be copied.
The user will be copied to the specified target file.
