Rcextract Ref Db2 Enu

Unicenter RC/Extract for DB2 UDB for z/OS
Reference Guide
r11.5
This documentation (the Documentation) and related computer software program (the Software) (hereinafter collectively referred to as the Product) is for the end users informational purposes only and is subject to change or withdrawal by CA at any time. This Product may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Product is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the Documentation for their own internal use, and may make one copy of the Software as reasonably required for back-up and disaster recovery purposes, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license for the Software are permitted to have access to such copies. The right to print copies of the Documentation and to make a copy of the Software is limited to the period during which the license for the Product remains in full force and effect. Should the license terminate for any reason, it shall be the users responsibility to certify in writing to CA that all copies and partial copies of the Product have been returned to CA or destroyed. EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS PRODUCT AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS PRODUCT, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE. The use of this Product and any product referenced in the Documentation is governed by the end users applicable license agreement. The manufacturer of this Product is CA. This Product is provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7013(c)(1)(ii), as applicable, or their successors. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Copyright
2006 CA. All rights reserved.
Contents
Chapter 1: Profile
Profile Screen ................................................................................ 11
Chapter 2: Extract Functions

Define Extract ................................................................................ 22 Source Definition Selection Screen ......................................................... 22 Start Object Selection Screen .............................................................. 24 Source Definition Screen .................................................................. 26 Select Related Tables Screen ............................................................ 212 Insert Object Selection Screen ........................................................... 214 Data Query Edit Screen ................................................................. 215 Perform Extract ............................................................................ 219 Process Source Definition Screen ........................................................ 219 SQL Extract Options Screen ............................................................. 222 PFU Extract Options Screen .............................................................. 223 Extract Options Screen .................................................................. 227
Chapter 3: Load Functions

Define Targets ............................................................................... 32 Target Definition Selection Screen ......................................................... 32 Target Mapping Screen .................................................................... 34 Perform Load ................................................................................. 39 Process Target Definition Screen ........................................................... 39 SQL Load Options Screen ................................................................ 311 IBM Load Options Screen ................................................................ 312 Fast Load Options Screen ............................................................... 314 Allocation Options Screen ............................................................... 316 Split Allocations Screen ................................................................. 317
Chapter 4: Command Center

Header Fields ................................................................................ 41 List Fields .................................................................................... 42 Command Center Object Command List ........................................................ 44
Contents
iii
MATCHCASE Primary Command ........................................................... 44 Source Definition Object Type ............................................................. 45 Extract Object Type ...................................................................... 45 Target Definition Object Type ............................................................. 46 Extract Object Search Facility ................................................................. 46 Post Encryption Facility Services .............................................................. 48 Encryption Routines ..................................................................... 410 Specifying a Routine ..................................................................... 411 Restart Incomplete Extract Screen ........................................................... 413
Index
iv
Uncenter RC/Extract Reference Guide
Chapter 1: Profile
This chapter discusses the defaults you can define for Unicenter RC/Extract for DB2 UDB for z/OS (Unicenter RC/Extract). For global profile information, see the General Facilities Reference Guide.
Profile Screen
Select P or enter the PROFILE primary command on the Main Menu to access the RC/Extract Profile screen, shown following:
COMMAND ===> -------------- RC/Extract Profile --------------
RC/Extract Parameters: Display Hint Wizard Optimize Extract Uppercase Output Select Entire R/I Set Load Utility Display Batch Progress Report Progress Report Increment Matchcase
===> N ( Y - Yes, N - No ) ===> Y ( Y - Yes, N - No ) ===> N ( Y - Yes, N - No ) ===> N ( Y - Yes, N - No ) ===> IBM ( IBM or PFL ) ===> N ( Y - Yes, N - No ) ===> 1000 ( 1000 - 99999 ) ===> CAPS ( ON, OFF, CAPS ) ON, - Enables matchcase OFF, - Disables matchcase (SQL intensive) CAPS - Force object names to upper case. PF3 - End
ENTER - Process Information
On this screen, you can specify the following parameters: Display Hint Wizard Specify whether you want the Hint Wizard screens to display. The Hint Wizard is an automated tutorial-type tool that automatically appears for each new panel and provides helpful usage hints. YDisplay the Hint Wizard. This is the default. NDo not display the Hint Wizard. Optimize Extract Specify whether extractions are to be optimized for speed of execution. In almost all cases, extractions should be optimized. Valid values are: YOptimize extraction. This is the default. NDo not optimize extraction.
Chapter 1: Profile
11
Profile Screen
Uppercase output Specify whether you want the output displayed in uppercase only. YDisplay uppercase only. NDisplay uppercase and lowercase output. This is the default. Select Entire R/I Set Specify whether you want to select the entire referential integrity (R/I) set for execution. In most cases, you will want all of the objects in an R/I set to be selected automatically for extraction. Setting this value to N (No) lets you manually include only those objects you want in the R/I set. YSelect the entire referential integrity set. This is the default. NDo not select the entire referential integrity set. Load Utility Specify which load utility to use to load objects to your target objects. Valid values are: IBMUse the IBM Load Utility when a load utility is necessary. This is the default. PFLUse Unicenter Fast Load for DB2 UDB for z/OS and OS/390 (Unicenter Fast Load) when a load utility is necessary. Valid product licenses are required. Display Batch Progress Report Specify whether to generate a progress report of extract processing when a batch job is submitted. This progress report is included in the audit report. Progress Report Increment Specify a number (n) to indicate how often the progress report is updated during an extract. The progress report is updated for every n number of rows extracted. A small number can lead to an excessively large audit report. Matchcase Specify how you want Unicenter RC/Extract to handle the object names you enter. You have the following options: CAPSThe case of the object names you enter are automatically converted to all capital letters. ON(Default) The case of the object names you enter are used exactly as you enter them (fully case-sensitive) OFFThe case of the object names you enter are ignored (fully case-insensitive). Note: This function does not extend to characters DB2 typically uses as wildcards, such as % (percent) and _ (underscore). For information about the MATCHCASE primary command, see the section of the same name later in this guide.
12
Unicenter RC/Extract Reference Guide

This chapter describes the screens used in Extract Functions. You access the Extract/Load Services menu by selecting option 1 from the Main Menu.
RXM --------------- RC/EXTRACT Extract/Load Services -------------------------OPTION ===> ---------------------------------------------------------------------- USER002 REGISTRY SSID ===> D81A VERSION ===> VxRxMx Extract Functions 1 - Define Extract (Create/Update a Source Definition)
2 - Perform Extract (Create an Extract Object from a Source Definition) Load Functions 3 - Define Targets 4 - Perform Load (Create/Update a Target Definition) (Load from Extract Object Using Target Definition)
21
Define Extract
Define Extract
This section describes the screens used to define the extract.
Source Definition Selection Screen

When you select option 1, Define Extract, from the Extract/Load Services menu, the Source Definition Selection screen appears.
RXEXT --------- RC/EXTRACT Source Definition Selection ----------------------COMMAND ===> SCROLL ===> PAGE Source Definition: Creator ===> * (Blank or pattern for list) Name ===> * (Blank or pattern for list) Registry SSID: D81A ---------------------------------------------- USER002 S _ _ _ _ _ _ _ _ _ _ _ NAME AAAAAAAA AASRCD01 AASRCD01 ACMEXTRA AMSI99 AMSI99B AMSI99C AMSJOE1 AMSJOE1 AMSP99EA AMSP99FL DESCRIPTION STD EXT TEST TITLE CHANGE CHANGEURCE DEFINITION NEW SOURCE DEFINITION NEW SOURCE DEFINITION NEW SOURCE DEFINITION NEW SOURCE DEFINITION TEST OF P99F SJK MCLEODUSA NEW SOURCE DEFINITION NEW SOURCE DEFINITION CREATOR USER003 USER003 USER003 USER003 USER002 USER002 USER002 USER002 USER001 USER002 USER002 S O U U U U N N N U U N N SSID D61A D61A D61A D61A D61A D61A D61A D61A D61A D61A D61A *---- LAST UPDATE -----* USER DATE TIME USER003 2004/12/08 11:37 USER002 2004/11/16 17:32 USER003 2004/08/03 11:15 USER003 2005/05/14 13:56 USER002 2005/06/04 15:51 USER002 2005/06/04 17:31 USER002 2005/06/04 17:50 USER002 2005/06/05 14:26 USER001 2005/07/30 15:28 USER002 2005/06/04 17:52 USER002 2005/06/05 14:42 PF3/15: End
PF7/8: Scroll Up/Down
The following fields are on the Source Definition Selection screen: Creator Enter the creator ID of the existing source definition you would like to edit or the source definition you are creating. To browse a list of existing source definitions, enter an asterisk (*) or leave this field blank and press Enter. Note: The last source definition you worked with is remembered and displayed automatically in the Creator field. Name Specify one of the following: To create a new source definition, enter a unique name. To edit an existing source definition, enter an existing name. To browse a list of existing source definitions for that creator, enter an asterisk (*) or leave this field blank and press Enter. Note: The last source definition you worked with is remembered and displayed automatically in the Name field.
22
Define Extract
S Enter an S next to the name of the existing source definition you would like to edit. Name Displays the name of the existing source definitions for the specified creator and name. Description Displays the description of the existing source definitions for the specified creator and name. Creator Displays the creator ID of the listed source definitions. SO Displays the share option that was specified for the listed source definitions. Valid values are: NIndicates that the object will be visible only to the creator of the object. YIndicates that the object will be visible to all users; however, only the creator can update the object. UIndicates that the object will be visible to all users and anyone can update the object. SSID Displays the subsystem ID of the listed source definitions. User Displays the user ID of the last person who updated the source definition. Date Displays the date the source definition was last updated. Time Displays the time the source definition was last updated.
23
Define Extract
Start Object Selection Screen

The Start Object Selection screen is invoked when creating a new source definition. You must specify the start object. This defines the starting point for the extraction.
RXEXT --------- RC/EXTRACT Source Definition Selection ----------------------COMMAND ===> SCROLL ===> PAGE _____ RC/Extract Start Object Selection ____ Source Definition: | | Creator ===> USER002 | COMMAND ===> SCROLL ===> PAGE | Name ===> NEWSOURC | | Registry SSID: D81A ---------- | SSID ===> D81A | | LOCATION ===> LOCAL | | OBJECT CREATOR ===> DSN% | | OBJECT NAME ===> * | | OBJECT TYPE ===> T MATCHCASE ON | | WHERE ===> N | | REGISTRY SSID: D61A -------------- USER002 | | S OBJECT NAME CREATOR TYPE | | _ ACT DSN8QA0 T | | S ACT DSN8610 T | | _ DEPT DSN8QA0 T | | _ DEPT DSN8610 T | | _ DEPT2 DSN8610 T | | _ DEPT3 DSN8610 T | | _ DEPT4 DSN8610 T | | _ DSN_REGISTER_APPL DSNRGCOL T | | _ DSN_REGISTER_OBJT DSNRGCOL T | PF7/8: Scroll Up/Down | _ EACT DSN8610 T | |____________________________________________|
Enter values into the following fields on the Start Object Selection screen to select your start object: SSID Enter the DB2 subsystem identifier where the start object resides. A question mark (?) can be entered in this field to bring up a list of identifiers. This field must contain a value. Location Identify the location of the subsystem. This can be used with SSID to specify that the start object be on a remote DB2 subsystem. LOCAL should be specified if it is not. A question mark (?) can be entered in this field to bring up a list of locations. This field must contain a value. Object Creator Identify the creator of the object you want to use. Placing an asterisk (*) or blanking this field brings up a list of all the creators that have views or tables on this subsystem. The wildcard percent sign (%) is also supported. This field allows lower case values and embedded blanks.
24
Define Extract
Object Name Enter the object name you want to use as your start object. Placing an asterisk (*) or blanking this field brings up a list of all the views or tables on this subsystem. The wild card percent sign (%) is also supported. This field allows lower case values and embedded blanks.
Tip: Depending on the size of your subsystem, it is usually best not to blank both the Object Creator and Object Name fields together. The ensuing list could be too long and unwieldy to be of much practical use. Object Type Enter the object type you want to use as your start object. Enter one of the following: TTables. This is the default. VViews *Both tables and views For information about the MATCHCASE setting, see the Profile section in this guide. WHERE Toggle the SQL WHERE clause on (Y) or off (N). Default is N. You can also enter S to choose from a query list.
25
Define Extract
Source Definition Screen

The Source Definition screen is where you define the related objects to be included in the extraction and the rules for how to extract the data.
RXEDT ---------- RC/EXTRACT Source Definition ---------COMMAND ===> SCROLL ===> PAGE Source Definition: USER002.NEWSOURC Source SSID: D81A Description ===> NEW SOURCE DEFINITION Share Option ==> N Start Object Parameters: -----------------------------------------------------Sampling Ratio ==> ____ of ____ Initial # Rows ==> _______ WHERE Clause ==> N ________ Key File Input ==> N ______________________________________________________ Registry SSID: D81A ----- Display Mode: Object ---------------- USER002 TOTAL CHILD CMD STATUS OBJECT CREATOR TYPE LIMIT WHERE CLAUSE ___ START ACT DSN8610 T _______ N ________ ___ SELECT DEPT DSN8610 T _______ N ________ ___ SELECT DEPT2 DSN8610 T _______ N ________ ___ SELECT DEPT3 DSN8610 T _______ N ________ ___ SELECT DEPT4 DSN8610 T _______ N ________ ___ SELECT EMP DSN8610 T _______ N ________ ___ SELECT EMPPROJACT DSN8610 T _______ N ________ ******************************** BOTTOM OF DATA ******************************* PF7/8: Scroll Up/Down PF10/11: Select/Exclude All Commands - INSERT, PLAN PF6: Relationship Display Mode PF3/15: End PF5: Show Excluded Objects Line Commands - S, X, V, B, R, C, P, A
Use the following fields to define extraction parameters on the Source Definition screen: Source Definition Displays creator and name of the source definition that is currently being edited. The format of the display is:
uuuuuuuu.ssssssss
where:
uuuuuuu is the creator ID of the source definition. sssssss is the name of the source definition.
Description Enter a description of the source definition. This description can be up 25 characters long. If a description was entered on the creation line on the Command Center screen, it will be carried over here.
26
Define Extract
Share Option Change the share option by entering a new share option here. Valid values are: NOther users cannot reference or copy your source definition. This is the default. YOthers can use, but not update, your source definition. UOthers can use and update your source definition. Note: This field is not to be used as a security mechanism. If a user has access to an extract object created by a different user and that user creates a target definition under this extract object, the source definition will become visible to the user even if the creator specified a Share Option of N. Source SSID Displays the DB2 subsystem identifier for the source definition. Sampling Ratio Specify the frequency of selection for extracting rows from the start object. The first number is the sample count. The second number is the sample size. For example, to specify every third row, enter 1 of 3. WHERE Clause Specify whether to use the Extended Query Facility (EQF) to define the data to be extracted from the start object. If a query is specified, it must be satisfied for the row to be extracted. Valid values are: NDo not use an extended query. This is the default. YEdit an extended query definition. Specify the name of the query you want to use on the Data Query Edit screen. SSpecify the extended query name you want to use. If no query name is specified, then select an extended query from the selection list that is presented. See the General Facilities Reference Guide for more information about using EQF.
27
Define Extract
Key File Input Specify whether to use an external key file for the initial key values to be extracted from the start object. The result will be the same as if you had specified a where-clause on the key columns of the start object as described above for the WHERE Clause. Valid values are: NDo not use an external key file. If you specify a data set name, it will be replaced with spaces. This is the default. YCreate/update and external key file. Specify a valid data set name. See External Key Files in the Unicenter RC/Extract User Guide for more information. SSpecify an existing external key file. Use a valid data set name. Note: A license for Unicenter RC/Update for DB2 UDB for z/OS and OS/390 (Unicenter RC/Update) is required. Initial # Rows Specify the initial number of rows to extract from the start object. This number is a maximum value. If the start object has fewer rows than the number you specify here, then extracts are only made from the existing rows. If the start object has more than the specified number of rows, then extracts are only made from the number of rows you specified in this field. Other rules you may have applied to this start object can override the value placed in the Initial # Rows field. Display Mode is Displays what the current display mode is. The display modes are: ObjectDisplays a list of related objects, whether the object has been selected to be extracted, and the extraction rules that apply at the object level. RelationshipDisplays a list of relationships between the objects selected for extraction, whether the relationship has been selected, and the extraction rules that apply at the relationship level. Note: The PF6 key toggles the display mode.
Object Mode
The following fields are available when the display mode is Object. CMD Enter a line command to specify the selection status of the table or view additional information on the object. Valid values are: SSelect this object to be included in the extraction. XExclude this object from the extraction.
28
Define Extract
VSelect this object to be included in a view. BInvoke RC/Browse for this object. RC/Browse is a powerful component of Unicenter RC/Update that lets you easily view object data. You must have a valid Unicenter RC/Update license to invoke this feature. RDisplay the Select Related Objects screen, but do not include any related objects. This option is helpful for large amounts of data that may be time consuming to display. Once in the Select screen, you can specify data display variables and select or exclude objects for the extraction. CDisplay immediate children objects within the Select Related Objects screen for possible inclusion in the extraction. PDisplay immediate parent objects within the Select Related Objects screen for possible inclusion in the extraction. ADisplay all objects within the Select Related Objects screen for possible inclusion in the extraction. Status Displays the current status of an object. Valid values are: STARTThis object is the starting object for the extraction (the start object cannot be excluded). SELECTThe object has been selected for the extraction. EXCLUDThe object has been excluded from the extraction. (This value displays only if PF5 has been selected to show excluded objects. PF5 is a toggle to display or hide excluded objects.) Object Displays the name of the object. The object may be the start object or another object in a set of objects related to the start object. Creator Displays the ID of the creator of the object. Type Displays the type of object (views or tables). Total Limit Specify a total limit of rows to be extracted from an object. This limit applies to the entire extraction. Once this limit is reached, no further extractions from the object will occur. This might prevent an intact set of RI data from being retrieved.
29
Define Extract
CHILD WHERE Clause Specify whether to use the Extended Query Facility (EQF) to define the data to be extracted from any table or view (not just the start object) included in the source definition. The WHERE clause is appended to the SELECT statement used to extract data from the table or view during the extraction process when the table or view occurs as the child in a relationship. If a query is specified, it must be satisfied for the row to be extracted. When a WHERE clause is specified, it will be output to the audit file during batch processing. Valid values are: NDo not use an extended query. This is the default. YEdit an extended query definition. Specify the name of the query you want to use on the Data Query Edit screen. SSpecify the extended query name you want to use. If no query name is specified, select an extended query from the selection list that is presented. See the Extended Query Facility (EQF) chapter in the General Facilities Reference Guide for more information about using EQF.
Relationship Mode
RXEDT ---------------- RC/EXTRACT Source Definition -------------------------COMMAND ===> SCROLL ===> PAGE Source Definition: USER002.NEWSOURC Source SSID: D81A Description ===> NEW SOURCE DEFINITION Share Option ==> N Start Object Parameters: -----------------------------------------------------Sampling Ratio ==> ____ of ____ Initial # Rows ==> _______ WHERE Clause ==> N ________ Key File Input ==> N _______________________________________________________ Registry SSID: D81A ----- Display Mode: Relationship ---------------- USER002 CMD ___ ___ ___ ___ ___ ___ STATUS SELECT SELECT SELECT SELECT SELECT SELECT PARENT ACT DEPT DEPT DEPT DEPT DEPT CHILD PROJACT DEPT DEPT2 DEPT3 DEPT4 EMP RELNAME RPAA RDD RDD RDD RDD RED CP PC Y N Y N Y N Y N Y N Y N
CP: (Y/N) Y-Extract parent row for an extracted child row PC: (Y/N) Y-Extract child rows for parent rows extracted when CP rule = Y PF7/8: Scroll Up/Down PF6: Object Display Mode PF3/15: End Commands - INSERT, PLAN Line Commands - S, X
210
Define Extract
The following fields are available when the display mode is Relationship: CMD Enter a line command to specify the selection status of the relationship. Valid values are: SSelect this relationship to be included in the extraction. XExclude a relationship from the extraction that was previously selected. Status Displays the current status of a relationship. Valid values are: SELECTThe relationship has been selected for the extraction. EXCLUDThe relationship has been excluded from the extraction. Parent Displays the parent in a relationship. Child Displays the child in a relationship. Relname Displays the name of the relationship. CP Specify whether the parent rows of an extracted row should also be extracted. Valid values are: YSpecifies that the parent rows should be extracted. NSpecifies that the parent rows should not be extracted. PC This rule applies when a row was extracted from an object because it is the parent of another object and the CP rule on the relationship between the two objects is Y. The PC rule specifies whether the child rows should be extracted. Valid values are: YExtract child rows for parent rows extracted when CP rule is Y. NDo not extract child rows.
211
Define Extract
Select Related Tables Screen

When you specify you want to select additional tables to be included in the extraction from the Source Definition screen and press Enter, the Select Related Tables screen appears.
RXEDT ---------------- RC/EXTRACT Source Definition -------------------------COMMAND ===> SCROLL ===> PAGE ________________ RC/Extract Select Related Tables ________________ Source D| | Descrip| COMMAND ===> SCROLL ===> PAGE | Start Ob| PF10/11: SELECT/EXCLUDE ALL | Samplin| | WHERE C| TABLE NAME: DSN8610.DEPT3 | Key Fil| SELECT ===> A (A-ALL, C-CHILDREN, P-PARENTS) | Registry| LEVEL ===> * (IF CHILDREN OR PARENTS, *-ALL LEVELS) | | CREATOR ===> * NAME ===> * | CMD ST | PLAN ===> * PACKAGE ===> * | ___ ST | REGISTRY SSID: D81A ------------------------------------ USER002 | ___ SE | S OBJECT NAME CREATOR | ___ SE | S ACT DSN8610 | A__ SE | S DEPT DSN8610 | ___ SE | S DEPT2 DSN8610 | ___ SE | S DEPT3 DSN8610 | ___ SE | S DEPT4 DSN8610 | | S EMP DSN8610 | | S EMPPROJACT DSN8610 | PF7/8: | S PROJ DSN8610 | PF10/11:| S PROJACT DSN8610 | Commands|____________________________________________________________________|
The following describes the fields on the Select Related Tables screen: Table Name Displays creator and the name of the table that related tables are being selected from to be included in the extraction. The format of the display is:
uuuuuuuu.ssssssss
where: uuuuuuu is the creator ID of the table. sssssss is the table name. Select Specify what tables you want displayed in the listing on the bottom half of the screen. From the tables displayed, you can specify which to include or exclude in the data extraction. ADisplay all related tables of the selected table. CDisplay children tables of the selected table. PDisplay parent tables of the selected table. Level Specify the level of children or parent tables to display. When displaying all levels, the default is *. When displaying children or parent tables, the level is 0001.
212
Define Extract
Creator Specify the creator of the tables you want displayed. Name Specify the name of the tables you want displayed. Plan Display tables included only within a specific plan through referential integrity relationships. This powerful feature lets you perform an extraction on all or a subset of data from a specific plan. Package Display tables included only within a specific package through referential integrity relationships. S Select tables you want included within the extraction. S (Select) is the only valid line command. Removing the S excludes the tables. The PF10 key selects all tables. The PF11 key excludes all tables. Object Name Displays the table name whose data you may select for extraction. You can vary the tables displayed within this section by the values entered in the above header fields. Creator Displays the creator name of the table whose data you may select for extraction.
213
Define Extract
Insert Object Selection Screen

When you specify INSERT on the Source Definition screen and press Enter, the Insert Object Select screen appears. On this screen, you can select objects that are unrelated to the referential integrity (RI) set for extraction:
RXEDT ---------------- RC/EXTRACT Source Definition --------------------------COMMAND ===> INSERT SCROLL ===> PAGE .---- RC/Extract Insert Object Selection -----. Source Definition: USER002.TST | | Description ==> ___________| COMMAND ===> SCROLL ===> PAGE | Start Object Parameters: ------| | Sampling Ratio ==> ____ of ___| SSID ===> D81A | WHERE Clause ==> N _________| LOCATION ===> LOCAL | Key File Input ==> N _________| OBJECT CREATOR ===> USER002 | Registry SSID: D81A ---------- | OBJECT NAME ===> * | | OBJECT TYPE ===> T MATCHCASE ON | CMD STATUS OBJECT | WHERE ===> N | ___ START TAB1RC171 | REGISTRY SSID: D81A ------------- USER002 | ___ SELECT TAB2RC171 | S OBJECT NAME CREATOR TYPE | ****************************** | ************ BOTTOM OF DATA *********** | | | | | | | | | | | PF7/8: Scroll Up/Down P | | PF10/11: Select/Exclude All P | | Commands: INSERT, PLAN | | '---------------------------------------------'
Enter values into the following fields on the Insert Object Selection screen to select additional objects: SSID Enter the DB2 subsystem identifier where the object resides. A question mark (?) can be entered in this field to bring up a list of identifiers. This field must contain a value. Location Identify the location of the subsystem. This can be used with SSID to specify that the object be on a remote DB2 subsystem. LOCAL should be specified if it is not. A question mark (?) can be entered in this field to bring up a list of locations. This field must contain a value. Object Creator Identify the creator of the object you want to use. Placing an asterisk (*) or blanking this field brings up a list of all the creators that have views or tables on this subsystem. The wildcard percent sign (%) is also supported.
214
Define Extract
Object Name Enter the object name you want to use as your object. Placing an asterisk (*) or blanking this field brings up a list of all the views or tables on this subsystem. The wild card percent sign (%) is also supported.
Tip: Depending on the size of your subsystem, it is usually best not to blank both the Object Creator and Object Name fields together. The ensuing list could be too long and unwieldy to be of much practical use. Object Type Enter the object type you want to use as your object. Enter one of the following: TTables. This is the default. VViews *Both tables and views For information about the MATCHCASE setting, see the Profile section in this guide. WHERE Toggle the SQL WHERE clause on (Y) or off (N). Default is N. You can also enter S to choose from a query list.
Data Query Edit Screen

When you set the WHERE Clause option to Y on the Source Definition screen and press Enter, the Data Query Edit screen appears. The Data Query Edit screen lets you create data queries.
------------------- Data Query Edit ---- ( Caps Off ) COMMAND ===> Query Name ==> NEWSOURC Description ==> Confirm Replace ==> N TEST COUNT ==> N VIEW SQL ==> N SEL C ORD COLUMN NAME S __ 1 ACTNO S __ 2 ACTKWD S __ 3 ACTDESC SCROLL ===> PAGE
For Table ==> DSN8610.ACT Share ==> N Default ==> N Auto Cast ==> N Userid - USER002 SHRINK ==> N ROW LIMIT ==>
TYPE ----------- WHERE CONDITION ------- AND SMALLINT C(6) V(20)
01 02 03 04
EXTENDED WHERE (Use secondary paging keys to scroll)
215
Define Extract
The following describes the fields on the Data Query Edit screen: Query Name Enter the name of the query, up to eight characters. The query cannot currently exist (under your ID). If you do not enter a query name, EQF assigns a temporary name called TEMP. Temporary queries are not saved after you leave the function or object you are accessing. Therefore, you must enter a name if you want to save the query. For Table Indicate the name of the object associated with the data query. Description Enter a short description associated with the query (Optional). Share Indicate how other users can access your query. NThe query cannot be accessed by any other users. This is the default. YThe query can be accessed by other users, but they cannot update the query. UThe query can be accessed and updated by other users. Default Indicate if the query is the default for the object or function. NThe query is not the default. YThe query is the default. Anytime you invoke a product function that has a default query, it will automatically be executed. You can designate only one default query per product function or object. Confirm Replace Confirm replacement of existing queries. Valid values are: NWhen a query will replace an existing query, no confirmation will be requested. YWhen a query will replace an existing query, request confirmation. This is the default. Autocast Specify whether to establish the default cast option. Valid values are: YIf you want UDT columns casted to their internal source data type. NIf you do not want UDT columns casted. Userid Specify the user ID of creator of the source definition.
216
Define Extract
Test Count Enter Y to receive a count of the number of rows that will be retrieved based on the current SELECT statement. You can use this number to gauge the scope of your SELECT statement. Enter N to not receive a count. The COUNT primary command performs the same function as entering a Y in this field. View SQL Enter Y to view the SQL select statement in standard SQL format. All conditions, including the EXTENDED WHERE, will be displayed. Otherwise, enter N. The SQL command performs the same function as entering Y in this field. Shrink Display a subset of the columns listed in the SELECT statement section. This is useful for reducing the object columns to display only pertinent columns. Valid values are: YShow any columns that are selected, have ordering specifications, or have a WHERE condition. NShow all columns in the object. SShow all columns that are selected. WShow columns with a WHERE condition. OShow columns that are used in an order by. Row Limit Enter the maximum number of rows you want returned from the query. SEL Indicate if you want to include the column in the SELECT statement. Valid values are: SEnter S next to the column names you want to select. You can deselect columns by removing the S in the SEL field. #Enter a number to select the column order in the generated SELECT statement. Enter 1 for the first column, 2 for the second, and so on. FIn RC/Edit, you can enter F to freeze the field upon entry to the editor. Frozen columns are displayed before sequence numbered columns and before selected columns. C Enter one of the following to control casting at the column level. YIf you want this column casted to its internal source data type. NIf you do not want this column to be casted. blankSpecifies no casting control at the column level.
217
Define Extract
Ord Enter a sequence number if you want to control the sort order of the retrieved rows within each column. The numbers control the sort order, with the lowest number representing the outer-most sort field. You can enter a number from 1 to 9, and it can be followed by an A for ascending or D for descending. A is the default. For example, 6D is a valid entry. Column Name The DB2 column number and name. The column abbreviation number appears to the left of each column name. The column abbreviation can be used in the extended where to represent a column name. If the column number is highlighted, the column is defined as NOT NULL WITHOUT DEFAULT. Type The column type. The TYPE command also toggles to the full DB2 type definition. WHERE Condition Enter column-specific WHERE information. The condition is applied to the column name on its left. All standard SQL syntax is supported. If your WHERE information is more complex, enter the WHERE condition in the EXTENDED WHERE section. AND Controls how all conditions listed under the WHERE Condition field are joined to each other. ANDSpecifies that all conditions must be true for the row to be selected. ORSpecifies that any of the conditions can be true for the row to be selected. Extended WHERE Enter the conditions you want in this section if you cannot enter the WHERE conditions using the fields in the middle section of the screen. You will need to use this section when you must mix AND/OR conditions or use parentheses to separate conditions. You can enter up to 25 lines of free-form text for your WHERE condition. You can also use column abbreviations instead of typing in column names.
218
Perform Extract
Perform Extract
This section describes the screens that are used to perform the extract.
Process Source Definition Screen

When you select option 2, Perform Extract, from the Extract/Load Services menu, the Process Source Definition screen appears.
RXPEXT ---------------- Process Source Definition ---------------------------COMMAND ===> SCROLL ===> PAGE Source Definition: Creator ===> USER002 (Blank or pattern for list) Name ===> NEWSOURC (Blank or pattern for list) Extract Object ===> USER002.NEWSOURC.EXTOBJ Registry SSID: D61A ---------------------------------------------- USER002 Execution Options: Process Mode ===> (O - Online, B - Batch) Extract Method ===> S (S - SQL, U - Utility) Update Options ===> N (Y - Yes, N - No) Update Allocations ===> N (Y - Yes, N - No) Intercept Errors ===> Y (Y - Yes, N No) DDL Options: Extract DDL ===> Y (Y - Yes, N - No)
PF3/15: End
Enter: Process
The Process Source Definition screen initiates the extraction process. On this screen, you: Specify an existing source definition to define the extract. (Selection criteria can be used to bring up a selection list of source definitions.) Specify the name of a data set to contain the extract object and other parameters for the extraction process. The following are the fields on the Process Source Definition screen: Creator Specify the creator of an existing source definition or enter selection criteria to generate a list of source definitions. Name Specify the name of an existing source definition or enter selection criteria to generate a list of source definitions.
219
Perform Extract
Extract Object Specify the name of a data set that will contain the extract object. Up to 36 characters can be specified for the data set name. If the data set does not exist, it will be created automatically based on the allocation options specified. If the data set already exists, you will be notified that the data set exists and prompted to specify whether the extraction process should overwrite the existing data set. If a current source definition is established, then this field will default to uuuuuuuu.sssssss.extobj (where uuuuuuuu is your TSO user ID, ssssssss is the name of the current source definition). Note: The current source definition is the last source definition that was created or updated. Process Mode Specify the process mode for the extract object. Valid values are: OPerform the extraction process online. BPerform the extraction process in batch. If this option is chosen, a batch processor stream (JCL that invokes the CA Batch Processor) is created to perform the extraction. You are then taken to the Batch Processor screen where you can preview and edit the batch job, immediately submit the batch job, or save the batch job in a data set for later invocation. Extract Method Specify the method by which data will be extracted from the objects in the source definition. SUse SQL statements to unload the source objects. This method is always used for online extractions. UUse the Unicenter Fast Unload utility to unload the source objects. Use this method for view extractions, in batch, and when the entire table is to be read. Update Options Enter Y in this field if you want to view or update the default extraction options. Otherwise, enter N. Update Allocations Enter Y in this field if you want to view or update the default allocation options for the extract object. Otherwise, enter N.
220
Perform Extract
Intercept Errors Enter Y in this field if you want Unicenter RC/Extract to capture information about all abends before termination in order to permit restart processing after the point of the errors, preserving data that has been extracted successfully. Note: Restart is not available for extractions that have not begun to write table rows to the extract object, and or that have not completed at least one iteration of one step of the extraction. The incomplete extract object will also not be saved and registered for restart if the error or abend indicates possible corruption of the extract object. Extract DDL Specify whether to gather information from the catalog that can be used to autocreate the target objects. YGather information from the catalog. This is the default. NDo not gather information from the catalog. Note the following: If the extract object already exists, you are prompted to specify whether to proceed and overwrite the existing data set. If you respond Yes, the data set is deleted and a new one is created. The allocation information will default based on the settings maintained in the Unicenter RC/Extract (RCX) parmlib member. Use the Update Options field to override the defaults. To use Unicenter RC/Migrator for DB2 UDB for z/OS and OS/390 (Unicenter RC/Migrator) to create your target objects, set this option to N for optimal performance. A valid license is required.
221
Perform Extract
SQL Extract Options Screen

If you specified S in the Extract Method field and Y in the Update Options field on the Process Source Definition screen, the SQL Extract Options screen appears.
RXHXOS01 ---------------- RC/EXTRACT SQL Extract Options ---------------------COMMAND ===> Advanced Features: Keys Mode ==> 0 (0 - private, 1 - 1 dataspace, 2 - n dataspaces)
PF3 End/Continue
CANCEL Abandon Changes
The following are the fields on the SQL Extract Options screen: Keys Mode During an extraction, a list of keys is maintained for rows that have already been extracted. This field enables extremely large extractions to use data spaces. Specify the storage technique to be used for the keys. 0The keys for all tables are stored in the private area of the address space where the extraction is run. This is sufficient for most extractions and is used in all online extractions. This is the default 1The keys for all tables will be stored in a single data space. 2The keys for each table will be stored in a separate data space. This mode is not recommended if a large number of tables are selected for the extraction. Use it when large amounts of data are extracted from a small number of tables and 1 for this field is not enough. The initial data space created for each table is 4 MB in size. If 4 MB is not sufficient, it is incrementally expanded by 4 MB up to 2 GB.
222
Perform Extract
PFU Extract Options Screen

If you specified U in the Extract Method field and Y in the Update Options field on the Process Source Definition screen, the PFU Extract Options screen appears. If you select PFU Extract Options, Unicenter Fast Unload retrieves a row and passes it to the Unicenter RC/Extract exit routine. Unicenter RC/Extract checks to see if the row should be written and writes the row if necessary. Unicenter RC/Extract then sets a return code for Unicenter Fast Unload indicating that Unicenter Fast Unload should not write that row and Unicenter Fast Unload regains control. Unicenter Fast Unload then retrieves the next row and passes it to Unicenter RC/Extract. This continues until all the rows are processed. Note: You must have a valid Unicenter Fast Unload for DB2 UDB for z/OS and OS/390 (Unicenter Fast Unload) license to invoke this feature.
RXPXOPT2 COMMAND ===> -------- RC/EXTRACT PFU Extract Options -------
Extract Options: Share Level Use Image Copy
==> R ==> N
(C - Change, I - Ignore, R - Reference) (Y - Yes, N - No) (0-private, 1-1 dataspace, 2-n dataspaces) (N-No, Y-Yes, U-Update default allocations) (N-None, X-Sort Only, S-System only, U-User RI)
Advanced Options: Keys Mode ==> 0 Split Extract ==> N Dup Elimination ==> U
The following are the fields on the PFU Extract Options screen: Share Level Specifies the level of data integrity to be used by CA Fast Unload. This option will be ignored when extraction from an image copy is requested. CChange. The table is not locked. IIgnore. The UNLOAD is performed regardless of the status of the tablespace or any other DB2 activity against the table. The table is not locked. RReference. The table has a SHR lock.
223
Perform Extract
Use Image Copy Specifies whether to use an image copy for an extraction. Valid values are: YUse the latest image copy for the tablespace to which the table belongs as the source of the extraction. The extraction is performed in batch. Note: To use a different image copy, you can manually specify the data set names during the extraction. See the Unicenter RC/Extract User Guide for more information about extraction from image copies. NDo not use an image copy as the source of the extraction. This is the default. Keys Mode During an extraction, a list of keys is maintained for rows that have already been extracted. This field lets extremely large extractions use data spaces. Specify the storage technique to be used for the keys. Valid values are: 0The keys for all tables are stored in the private area of the address space where the extraction is run. This is sufficient for most extractions and is used in all online extractions. This is the default. 1The keys for all tables will be stored in a single data space. 2The keys for each table will be stored in a separate data space. We do not recommend this mode if a large number of tables are selected for the extraction. Use it when large amounts of data are extracted from a small number of tables and the value 1 for this field is not enough. The initial data space created for each table is 4 MB in size. If 4 MB is not sufficient, it is incrementally expanded by 4 MB up to 2 GB. Split Extract Creates a Split Extract Object consisting of multiple data sets when this option is used with ACCESSMETHOD(PFU) extractions. There is a data set with the name that was specified in the Extract Object field on the Process Source Definition screen. This data set contains the control information. The extracted rows are put into one load data set for each table in the extraction. These load data sets have an .Lnnn suffix (nnn is an identifier assigned by Unicenter RC/Extract). You can use the default allocations for these data sets or override them. Various features of Unicenter RC/Extract do not support Split Extract Objects. This option is intended only to be used for extremely large extractions. Valid values are: NDo not create a Split Extract Object. YCreate a Split Extract Object. UUpdate/View the allocations for the load data sets.
224
Perform Extract
Dup Elimination Specifies the techniques that Unicenter RC/Extract uses to prevent writing the same row to the extract object multiple times. During an extraction, if an object is processed in more than one step, the same row can be extracted more than once. However, in certain extractions, such as those with keys defined with User RI using RI Manager, the key may not be unique, meaning that rows with duplicate keys may exist and should be extracted. Unicenter RC/Extract uses several methods to make sure that the same row is not included in the Extract Object more than once. You can use the Dup Elimination option to control the methods you want to use. Notes: If no unique index is defined on the table and the Split Extraction option was not specified, then duplicate rows may be initially written to the Extract Object but can be eliminated during the sort phase of the extraction. If user keys are defined (using RI/Manager) for columns that are not unique, then you should specify S, X or N. If the sort method must be used, then indexed access cannot be used when extracting rows from the table. A tablespace scan will be used. If you are extracting a small number of rows from a very large table, consider defining an index on the table or specifying N for this option for better performance. If a table is not processed in multiple steps, is not within a loop and does not have multiple inputs, then the Dup Elimination option has no effect on how the table is processed. Valid values are as follows: UUse system unique indexes, user RI, or sort exit. This is the default and the recommended setting. When you specify this option, Unicenter RC/Extract first looks for a system unique index. If one is defined, Unicenter RC/Extract uses it. If Unicenter RC/Extract cannot find a system unique index, it then looks for a user key. If no indexes are defined and you did not specify the Split Extract option, then Unicenter RC/Extract eliminates the duplicates during the sort phase. If you specified the Split Extract option, there is no sort phase. These methods require CPU and virtual storage resources. If the duplicates can be discarded during the loading of the target objects, consider specifying option N to eliminate this overhead.
225
Perform Extract
SUse system unique indexes or sort exit When you specify this option, Unicenter RC/Extract searches for a system unique index. If one is not defined and you did not specify the Split Extract option, Unicenter RC/Extract eliminates the duplicates during the sort phase. These methods require CPU and virtual storage resources. If the duplicates can be discarded during the loading of the target objects, consider specifying option N to eliminate this overhead. XUse sort exit. When you specify this option, Unicenter RC/Extract uses the sort method to eliminate duplicate rows during the sort. You cannot specify this option if you specified the Split Extract option. When you specify this option, Unicenter RC/Extract cannot use indexed access when processing the table. In this situation, Unicenter RC/Extract uses a tablespace scan. This option is only appropriate for extracting large amounts of data. This option may reduce both virtual storage and CPU requirements for a large extraction NDo not attempt to eliminate duplicates. When you specify this option, Unicenter RC/Extract does not perform processing to prevent duplicate rows from being written to the Extract Object; instead, it uses the Load process to discard duplicates. You can use this option to reduce CPU or virtual storage requirements or to allow a table to be processed using indexed access, if the sort method would otherwise be required to eliminate duplicates.
226
Perform Extract
Extract Options Screen

If you specified a U in the Extract Method field and Y in the Update Allocations field on the Process Source Definition screen, the Extract Options screen appears. However, you should rarely have to alter these optionsthe default values should work for all extractions.
RXPXOPT ---------------- RC/EXTRACT Extract Options --------------------------COMMAND ===> EXTRACT OBJECT ALLOCATIONS: BEGIN WRITING THE EXTRACT OBJECT TO DISK ( DISK, TAPE )
IF WRITING TO DISK, USE THE FOLLOWING INITIAL ALLOCATION: PRIMARY QTY ==> 1 ( PRIMARY SPACE ALLOACTION ) SECONDARY QTY ==> 1 ( SECONDARY SPACE ALLOCATION ) SPACE UNIT ==> CYL ( CYL,TRK,BLK ) SMS PARAMETERS MANAGEMENT CLASS ==> ( BLANK FOR DEFAULT MANAGEMENT CLASS ) STORAGE CLASS ==> ( BLANK FOR DEFAULT STORAGE CLASS ) DATA CLASS ==> ( BLANK FOR DEFAULT DATA CLASS ) IF ALLOCATION IS NOT SUFFICIENT, OVERFLOW TO DISK ( DISK, TAPE, NONE )
PF3 End/Continue
You can specify the following extract options on this screen: Begin Writing the Extract Object to Disk Specify DISK or TAPE. Primary Qty Specify the primary allocation of the extract data set. Secondary Qty Specify the secondary allocation of the extract data set. Space Unit Specify one of the following: CYLCylinders TRKTracks BLKBlocks Management Class Enter the SMS management class. Consult your system administrator to determine if your site uses SMS and to obtain an SMS management class name to use. Leave blank for the default.
227
Perform Extract
Storage Class Enter the SMS storage class. Consult your system administrator to determine if your site uses SMS and to obtain an SMS storage class name to use. Leave blank for the default Data Class Enter the SMS data class. Consult your system administrator to determine if your site uses SMS and to obtain an SMS data class name to use. Leave blank for the default. If Allocation is not Sufficient, Overflow to Disk Specify DISK, TAPE, or NONE. If overflow occurs, the overflow is created on disk or tape, as specified. If NONE is specified and overflow occurs, the job abends.
228

This chapter describes the screens used in the Load Functions. You access the Extract/Load Services menu by selecting option 1 from the Main Menu, shown following:
RXM --------------- RC/EXTRACT Extract/Load Services -------------------------OPTION ===> ---------------------------------------------------------------------- USER002 REGISTRY SSID ===> D81A VERSION ===> VxRxMx Extract Functions 1 - Define Extract (Create/Update a Source Definition) Current Source Definition is USER002.NEWSOURC 2 - Perform Extract (Create an Extract Object from a Source Definition) Current Extract Object is USER002.NEWSOURC.EXTOBJ Load Functions 3 - Define Targets 4 - Perform Load (Create/Update a Target Definition) (Load from Extract Object Using Target Definition)
31
Define Targets
Define Targets
This section describes the define target screens for load functions.
Target Definition Selection Screen

When you select option 3, Define Targets, from the Extract/Load Services menu, the Target Definition Selection screen appears:
RXPTDS ----------- RC/EXTRACT Target Definition Selection -------------------COMMAND ===> SCROLL ===> PAGE Extract Object ===> USER002.NEWSOURC.EXTOBJ Target Definition: Creator ===> USER002 (Blank or pattern for list) Name ===> @TRGDEF1 (Blank or pattern for list) ------------------------------------------------------------------------------
PF7/8: Up/Down
PF3/15: End
The Target Definition Selection screen is where you enter the name of the target definition you want to create or update. You can enter selection criteria in the Creator and Name fields to bring up a list of existing source definitions and then select the desired one. Use the following fields to identify the target definition you want to create or update: Extract Object A target definition is defined for an extract object and is required to uniquely identify subsequent load processing. You must supply the name of the extract object for which the target definition is or will be defined. Creator The usage of this field depends upon the desired function: Creating a New Target DefinitionThe creator field must be your TSO user ID. If you change this field to something other than your user ID, Unicenter RC/Extract assumes you are attempting to update a target definition created by another user. Updating an Existing Target DefinitionEnter the creator of the target definition you want to update. You can enter selection criteria to bring up a list of target definitions. This field defaults to your TSO user ID.
32
Define Targets
Name The usage of this field depends on the desired function: Creating a New Target DefinitionEnter the name of the target definition you want to create. Updating an Existing Target DefinitionEnter the name of the target definition you want to update, or enter selection criteria to bring up a list of target definitions. If a target definition has been established, this field defaults to the name of the current target definition. If one has not been established, it will default to @TRGDEF1. If you enter selection criteria in the Extract Object field, the Extract Object Selection screen appears, letting you select an existing extract object.
RXPTDS ----------- RC/EXTRACT Target Definition Selection -------------------COMMAND ===> SCROLL ===> PAGE _________ RC/Extract Extract Object Selection ________ Extract Object ===> | | Target Definition: | COMMAND ===> | Creator ===> | EXTRACT OBJECT DSN MASK: | Name ===> | | ------------------- | ===> USER002.* | | | | ------------------------------------------------------ | | S EXTRACT OBJECT DATASET | | _ USER002.CA11.SPFLOG1.LIST | | _ USER002.CA11.SPFTEMP1.WORK | | _ USER002.CLIST | | _ USER002.FORKEY1.EXTOBJ | | _ USER002.FROMJOE.EXTOBJ | | _ USER002.ISPF.ISPPROF | | _ USER002.NEWDATA.EXTOBJ | | _ USER002.PDN.PARMLIB | | _ USER002.PRF.JCL | | _ USER002.RCX.ISSUES | | _ USER002.RP99C.PARMLIB | PF7/8: Up/Down | _ USER002.SAVED.EXTOBJ | |________________________________________________________|
33
Define Targets
Extract Objects Containing More Than One Target Definition

On the Target Definition Selection screen, if you specify an extract object but do not specify the Creator and Name field, you are presented with a list of all target definitions for that extract object. Select the target definition you want to work with.
RXPTEDT ---------------- RC/EXTRACT Target Mapping --------------------------COMMAND ===> SCROLL ===> PAGE Extract Object ===> USER002.FINAL.EXTOBJ Target Definition: Creator ===> * (Blank or pattern for list) Name ===> * (Blank or pattern for list) -----------------------------------------------------------------------------S S NAME DESCRIPTION CREATOR O S @TRGDEF1 NEW DEFINITION USER002 N _ @TRGDEF2 NEW TARGET 2 USER002 N _ @TRGDEF3 NEW TARGET 3 USER002 N _ NEWTARG TARGET DEFINITION USER002 N ******************************** BOTTOM OF DATA *---- LAST UPDATE -----* USER DATE TIME USER002 2004/11/16 11:33 USER002 2004/11/15 16:31 USER002 2004/11/15 16:32 USER002 2004/11/15 18:33 *******************************
PF7/8: Scroll Up/Down PF10/11: Scroll Left/Right
PF5: Global Change PF6: Show Dependent Objects Line Commands - B, S, T, X
PF3/15: End
Target Mapping Screen

After you have identified the target definition, the Target Mapping screen appears:
RXPTEDT ---------------- RC/EXTRACT Target Mapping --------------------------COMMAND ===> SCROLL ===> PAGE Extract Object: USER002.NEWSOURC.EXTOBJ Target Definition: USER002.@TRGDEF1 Description ===> NEW TARGET DEFINITION Share Option ===> N Registry SSID: D81A ------------------------------------------------- USER002 Source SSID ===> D81A Target SSID ===> D81A Location ===> LOCAL Location ===> LOCAL C _ _ _ _ _ _ _ S S S S S S S S SOURCE OBJECT ACT DEPT DEPT2 DEPT3 DEPT4 EMP EMPPROJACT CREATOR DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 TYPE T T T T T T T TARGET OBJECT ACT DEPT DEPT2 DEPT3 DEPT4 EMP EMPPROJACT CREATOR DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 TYPE T T T T T T T MAP YES YES YES YES YES YES YES
PF3/15: End
34
Define Targets
When you scroll to the right (using PF11 or the RIGHT command), you can see the following additional fields:
RXPTEDT ---------------- RC/EXTRACT Target Mapping --------------------------COMMAND ===> SCROLL ===> PAGE Extract Object: USER002.NEWSOURC.EXTOBJ Target Definition: USER002.@TRGDEF1 Description ===> NEW TARGET DEFINITION Share Option ===> N Registry SSID: D81A ------------------------------------------------- USER002 Source SSID ===> D81A Target SSID ===> D81A Location ===> LOCAL Location ===> LOCAL C _ _ _ _ _ _ _ TARGET OBJECT ACT DEPT DEPT2 DEPT3 DEPT4 EMP EMPPROJACT CREATOR DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 TYPE T T T T T T T MAP YES YES YES YES YES YES YES DB NAME DSN8D61A DSN8D61A DSN8D61A DSN8D61A DSN8D61A DSN8D61A DSN8D61A DB STAT EXISTS EXISTS EXISTS EXISTS EXISTS EXISTS EXISTS TS NAME DSN8S61P DSN8S61D DSN8S61D DSN8S61D DSN8S61D DSN8S61E DSN8S61P TS STAT EXISTS EXISTS EXISTS EXISTS EXISTS EXISTS EXISTS
PF3/15: End
When you issue the INDEXES primary command, you can see the indexes associated with the source and target objects.
RXPTEDT----------------- RC/EXTRACT Target Mapping --------------------------COMMAND ===> SCROLL ===> PAGE Extract Object: USER002.NEWTESTA.EXTOBJ Target Definition: USER002.@TRGDEF1 Description ===> NEW TARGET DEFINITION Share Option ===> N Registry SSID: D81A ------------------------------------------------- USER002 Source SSID ===> D81A Target SSID ===> D81A Location ===> LOCAL Location ===> LOCAL C S SOURCE OBJECT _ S ACT S XACT1 S XACT2 _ S DEPT S XDEPT1 S XDEPT2 S XDEPT3 CREATOR DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 TYPE T I I T I I I TARGET OBJECT ACT XACT1 XACT2 DEPT XDEPT1 XDEPT2 XDEPT3 CREATOR DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 DSN8610 TYPE T I I T I I I MAP YES YES
PF3/15: End
35
Define Targets
Use the following fields on the Target Mapping screen to define the target: Extract Object Displays the name of the extract object being mapped. Target Definition Displays the creator and name of the target definition that is currently being edited. The format of the display will be:
uuuuuuuu.ssssssss
Where: uuuuuuu is the creator ID of the target definition. sssssss is the name of the target definition. Description Enter up to 25 characters to describe the target definition. Share Option Change the share option by entering one of the following values: NOther users cannot reference or copy your target definition. This is the default. YOthers can use, but not update, your target definition. UOthers can use and update your target definition. Source SSID Denotes the subsystem identifier of the source object. Location Denotes the location that the source objects came from. Target SSID Specify the subsystem identifier of the target objects. Location Denotes the location of the target objects. C Valid values are: BIf the target object exists, you can enter B in this field to jump from Unicenter RC/Extract into Unicenter RC/Update to browse the target object yourself. You must have a valid Unicenter RC/Update license to use this command. See the Unicenter RC/Update User Guide for additional information. SInclude this object in the target load. This is the default.
36
Define Targets
TIf the target object does not exist, you can enter T in this field to jump into Unicenter RC/Update to create the target object yourself, using the existing source object as a template. You specify object parameters on the Unicenter RC/Update CA Table Template screen, and when you have finished, you are returned to the Target Mapping screen. You must have a valid Unicenter RC/Update license to use this command. XExclude this object from the target load. S Shows whether the object is selected (S) or excluded (X). Source Object Displays the name of the source object in a related set of objects. The object may be the start object or another object in a set of objects related to the start object. Creator Displays the creator of the source object. Target Object Specify the name of the target object that the source object will map to. This field will default to the name of the source object. Creator Specify the creator of the target object that the source object is to map to. This field defaults to the source object creator. Type Displays the object type of the source. Valid values are: TIndicates the object is a table. IIndicates the object is an index. VIndicates the object is a view. Mapped Indicates whether the source object maps to the target object. The values and their meanings are as follows: NEWThe target object does not exist. Unicenter RC/Extract will automatically create it when loading the extracted data, if the target database and tablespace exist. YESThe target object exists and has columns that correspond to each of the columns in the source object NOThe target object exists but does not have columns that map to each of the columns in the source object. UNKCannot determine because a connection to the target subsystem could not be established.
37
Define Targets
DB Name Specify the name of the target database. This field defaults to the source database. DB Stat Displays the status of the target database. Valid values are: EXISTSDatabase exists on the target subsystem. NEWDatabase does not exist. User must create this database before performing the load, or the load will fail. UNKCannot determine because a connection to the target subsystem could not be established. TS Name Specify the name of the target tablespace. This field defaults to the source tablespace. TS Stat Displays the status of the target tablespace. Valid values are: EXISTSTablespace exists on the target subsystem. NEWTablespace does not exist. User must create this tablespace before performing the load, or the load will fail. UNKCannot determine because a connection to the target subsystem could not be established.
38
Perform Load
Perform Load
This section describes the perform load screens for load functions.
Process Target Definition Screen

To load an extract object using the target definition, select option 4, Perform Load, from the Extract/Load Services menu. The Process Target Definition screen appears:
RXLOAD ----------------- Process Target Definition --------------------------COMMAND ===> SCROLL ===> PAGE Extract Object ===> USER002.NEWTESTA.EXTOBJ Target Definition: Creator ===> USER002 (Blank or pattern for list) Name ===> @TRGDEF1 (Blank or pattern for list) Registry SSID: D81A ---------------------------------------------- USER002 Execution Options: Process Mode ===> (O - Online, B - Batch) Load Method ===> S (S - SQL, U - Utility) Update Load Parms ===> N (Y - Yes, N - No) Update Allocations ===> N (Y - Yes, N - No) Parallel Load ===> N (Y - Yes, N - No) DDL Options: Create Tables Create Indexes Create Views Create RI Check Utility ===> ===> ===> ===> ===> N N N N N (Y (Y (Y (Y (Y Yes, Yes, Yes, Yes, Yes, N N N N N No) No) No) No) No)
PF3/15: End
Enter: Process
Use the following fields on the Process Target Definition screen to specify the target definition load options: Extract Object Specify the name of the extract object to be used for the load process, or enter selection criteria to bring up a list of candidate extract objects. The selection criteria supported for this field is the asterisk (*). Creator Enter the creator of the target definition that defines the objects to load the data into, or enter selection criteria to bring up a list of target definitions. Name Enter the name of the target definition that defines the objects to load the data into, or enter selection criteria to bring up a list of target definitions.
39
Perform Load
Process Mode Enter one of the following values to specify process mode: OPerform the load process online. This is applicable only if the SQL load method is chosen. If the utility method is chosen, B must be specified for the process mode. BPerform the load process in batch. If this option is chosen, a batch processor stream (JCL that invokes the CA Batch Processor) is created to perform the extraction. From the Batch Processor screen that appears, you can preview and edit the batch job, immediately submit the batch job, or save the batch job to a data set for later invocation. Load Method Enter one of the following values to specify the load method: SUse SQL statements to load the target objects. UUse load utility to load the target objects. Update Load Parms Enter Y in this field if you want to view or update the default load parameters. Otherwise, enter N. Update Allocations Enter Y in this field if you want to view or update the default allocations. Otherwise, enter N. See the Allocation Options Screen section for additional information. Parallel Load Specify whether you want to load extracted data in separate load jobs so that the load jobs can run in parallel. See the Split Allocations Screen section for additional information. Create Tables Specify whether target tables are automatically created. When load processing is performed, the DDL to create the tables is generated, if the tables do not already exist. Create Indexes Specify whether target indexes are automatically created. When load processing is performed, the DDL to create the target indexes is generated, if the indexes do not already exist. Create Views Specify whether views are automatically created. When load processing is performed, the DDL to create the views is generated, if the views do not already exist. You must use the SQL Load engine to load a table through a view.
310
Perform Load
Create RI Specify whether ALTER DDL is automatically generated to add foreign keys to applicable objects, so referential integrity is maintained. Check Utility Specify whether a check utility is generated for all tablespaces. The check utility function helps verify, once the data is loaded, that the data is referentially intact.
SQL Load Options Screen

If you specified Y in the Update Load Parms field on the Process Target Definition screen, the SQL Load Options screen appears.
RXLOPTS --------------- RC/EXTRACT SQL LOAD Options -------------------------COMMAND ===> SQL Load Options: Empty Target Table Before Loading Update Existing Rows in Target Table Commit Frequency for Load Operation Skip Insert row on -530 SQLCODE ==> ==> ==> ==> N Y 20 N (Y (Y (0 (Y Yes, N Yes, N commit Yes, N - No) - No) after each table) - No)
PF3 End/Continue
Use the following fields to specify your SQL Load parameters: Empty Target Table Before Loading Clears out the target table before loading. NDo not clear target table. This is the default. YClear target table. Update Existing Rows in Target Table Modify existing rows if they match the key fields of the source record (that is, key collision). NIf key collision, you will receive the error condition SQL code -803. YIf key collision, update record. This is the default.
311
Perform Load
Commit Frequency for Load Operation Twenty (20) is the default. Note: Regardless of this value, at the end of each extraction, one final commit is performed so that data is not lost. Skip Insert row on -530 SQLCODE Allow SQL Load to continue processing when an SQL code -530 is returned. This code indicates that the row being inserted is a child row but the required parent is not present. Note: This option is not recommended when tables are related by circular RI. NDo not allow SQL Load to continue processing when an SQL code -530 is returned. This is the default. YAllow SQL Load to continue processing when an SQL code -530 is returned. This option does not need to be set to Y when Unicenter RC/Extract is automatically creating the objects as part of the load procedure, because the -530 SQL code will not occur in this situation. Note: Skipped rows are not written to a discard file. To insert skipped rows, rerun the Load of the same extract object, using options Update=N and Skip=Y. Then verify that the skipped rows were inserted. Do not specify these options during the first execution of a Load. Otherwise, you risk losing an update.
IBM Load Options Screen

If you specified Y in the Update Load Parms field on the Process Target Definition screen and IBM in the Load Utility field on the Profile screen, the IBM Load Options screen appears:
RXLOPT1 --------------- RC/EXTRACT IBM LOAD Options --------------------------COMMAND ===> IBM LOAD UTILITY OPTIONS: Load Resume/Replace ==> Log Data ==> SORTKEYS ==> Number of Keys ==> ENFORCE CONSTRAINTS ==> SYSERR Error log ==> MAPDDN Error log ==> Save Discarded rows ==> Max Discard rows ==> N N N 0 N Y Y Y 0 ( Y - Yes, N - No, or R - Replace ( Y/N - Y = Data is Logged as Loaded ( Y/N - Y = Keys Sorted as Loaded V5 and Above ( Estimated Number of Keys V5 and Above ( Y/N - Y = Enforce System RI Constraints ( Y/N - Y = Error info logged to SYSERR ( Y/N - Y = SYSMAP DD for error information ( Y/N - Y = allocate SYSDISC Error Dataset ( Max errors allowed, 0 = no limit ) ) ) ) ) ) ) ) )
PF3 End/Continue
312
Perform Load
A valid IBM license is required to use this utility. On this screen, you can specify the following load options: Load Resume/Replace Specify how you want to process the rows in the table by entering one of the following values: YThe existing rows of the table will not be deleted. If the tablespace is not empty, the records are added at the end of the file. If the tablespace is empty, a warning is issued and processing continues. NIf the tablespace is not empty (if it contains any rows in any table in that tablespace), processing stops. RIf you specify R, all existing rows in the tablespace are deleted, and the load processing is started from the beginning of the empty table. Log Data Specify whether to log data. NData is not logged. This is the default. YData is logged as loaded. Sortkeys Specify whether to sort keys. NDo not sort keys. This is the default. YKeys sorted as loaded V5 and above. Number of Keys Specify the estimated number of keys V5 and above. The default is 0. Enforce Constraints Specify whether to enforce system referential integrity constraints. Valid values are: NDo not enforce. This is the default. YEnforce. SYSERR Error log Specify whether to create a SYSERR error log. YError information is logged to SYSERR. This is the default. NError information is not logged. MAPDDN Error log Specify whether to create a MAPDDN error log. YError information is logged to SYSMAP DD. This is the default. NError information is not logged.
313
Perform Load
Save Discarded rows Specify whether to save discarded rows in the SYSDISC error data set. YAllocate SYSDISC error data set. This is the default. NDo not save discarded rows. Max Discard rows Specify the maximum number of discard rows permitted. If you enter 0, there is no limit.
Fast Load Options Screen

If you specified Y for the Update Load Parms field on the Process Target Definition screen and PFL (Unicenter Fast Load) in the Load Utility field on the Profile screen, the Fast Load Options screen appears. Note: You must have a valid Unicenter Fast Load license to invoke this feature.
RXLOPT2 --------------- RC/EXTRACT FAST LOAD Options ------------------------COMMAND ===> Load Resume/Replace MAPDDN Error log Save Discarded rows ALLMSGS Messages Max Discard rows ==> ==> ==> ==> ==> N Y Y N 0 ( ( ( ( ( Y - Yes or N - No or R - Replace ) Y/N, Y = SYSMAP DD for error info ) Y/N - Y = alloc SYSDISC error dataset) Y/N, Y = additional error message ) Max errors allowed, 0 = no limit ) ==> ==> ==> ==> ==> ==> ==> ==> N N N N N N N N
IGNORE THE MARKED ERRORS DURING THE LOAD ==> N 01. VARCHAR TOO LARGE ==> N 02. DATA VALUE TOO LARGE 03. DATA NOT NUMERIC ==> N 04. DATA FIELD TOO LARGE 05. INVALID DATA FOUND ==> N 06. DATE FIELD INVALID 07. TIME FIELD INVALID ==> N 09. INVALID GRAPHICS DATA 15. DUPLICATE INDEX KEY ==> N 16. INDEX KEY SEQUENCE ERR 18. FAILED FIELDPROC ==> N 19. FAILED VALIDPROC CHECK 20. FAILED OBID CHECK ==> N 21. FAIL CONDITIONAL CHECK 22. FAILED PARTITION KEY ==> N 100. FAILED WHEN SELECTION
PF3 End/Continue
314
Perform Load
On this screen, you can specify the following load options: Load Resume/Replace Specify how you want to process the rows in the table by entering one of these values: YResume the load. Do not delete the existing rows of the table. If the tablespace is not empty, the records are added at the end of the file. If the tablespace is empty, a warning is issued and processing continues. NIf the tablespace is not empty (if it contains any rows in any table in that tablespace), stop processing. RDelete all existing rows in the tablespace and start the load processing from the beginning of the empty table. MAPDDN Error log Specify where to write a formatted report of all errors. You can extract this report later using the Discard Processing program. The DD name must be six characters or less. (The seventh and eight characters are used as increments.) YUse SYSMAP DD for error information. This is the default. NDo not use SYSMAP DD for error information. Save Discarded rows Specify whether to save discarded rows. YAllocate SYSDISC error data set. This is the default. NDo not allocate the SYSDISC error data set. ALLMSGS Messages Specify whether you want Unicenter Fast Load to issue additional information on the load. Messages are written to the PTIIMSG data set if one is specified. Otherwise, messages are written to the PTIMSG data set. Valid values are: YIssue additional messages. NDo not issue additional messages. This is the default. Max Discard rows Specify maximum errors allowed. If you enter 0, there is no limit. Valid values are: 0No limit on number of errors allowed. This is the default. (integer)Maximum number of errors allowed. Ignore the Marked Errors During the Load Ignore the errors that are marked in the selection list. Valid values are: YIgnore the errors that are marked in the selection list. NDo not ignore any marked errors during load.
315
Perform Load
Allocation Options Screen

If you specified Y for the Update Allocations field on the Process Target Definition screen, the Allocation Options screen appears:
RXAOPT1 --------------- RC/EXTRACT Allocation Options ------------------------COMMAND ===> ALLOCATION OPTIONS Device Parameters: Device Type Volume Serial SMS Parameters: Management Class Storage Class Data Class Space Parameters: Discards PRI Errors PRI Map PRI SORTWK1 PRI SORTWK2 PRI
==> DISK ==> ==> ==> ==> ==> ==> ==> ==> ==> 50 50 50 1 1
( DISK/TAPE ) ( Blank for authorized default volume ) ( Blank for default Management Class ) ( Blank for default Storage Class ) ( Blank for default Data Class ) SEC SEC SEC SEC SEC ==> ==> ==> ==> ==> 50 50 50 1 1 UNITS UNITS UNITS UNITS UNITS ==> ==> ==> ==> ==> TRK TRK TRK CYL CYL ( ( ( ( ( TRK/CYL TRK/CYL TRK/CYL TRK/CYL TRK/CYL ) ) ) ) )
PF3 End/Continue
On this screen, you can specify the following allocation options. Device Type Enter the device type: DISK or TAPE. Volume Serial Enter the volume serial number, or leave blank for authorized default volume. Management Class Enter the SMS management class, or leave blank for the default. Storage Class Enter the SMS storage class, or leave blank for the default. Data Class Enter the data class, or leave blank for the default. Discards Specify the primary (PRI) and secondary (SEC) discard data set allocations in tracks (TRK) or cylinders (CYL). PRIDefault is 50 tracks. SECDefault is 50 tracks. Errors Specify the primary (PRI) and secondary (SEC) error data set allocations in tracks (TRK) or cylinders (CYL). PRIDefault is 50 tracks. SECDefault is 50 tracks.
316
Perform Load
Map Specify the primary (PRI) and secondary (SEC) map data set allocations in tracks (TRK) or cylinders (CYL). PRIDefault is 50 tracks. SECDefault is 50 tracks. SORTWK1 Specify the primary (PRI) and secondary (SEC) sort Work1 data set allocations in tracks (TRK) or cylinders (CYL). PRIDefault is 1 cylinder. SECDefault is 1 cylinder. SORTWK2 Specify the primary (PRI) and secondary (SEC) sort Work2 data set allocations in tracks (TRK) or cylinders (CYL). PRIDefault is 1 cylinder. SECDefault is 1 cylinder.
Split Allocations Screen

If you chose to load extracted data in separate load jobs by specifying Y in the Parallal Load field on the Process Target Definition screen, the Split Allocations screen appears.
RXAOPT2 --------- RC/EXTRACT Split Allocations --------COMMAND ===> ALLOCATION OPTIONS SMS Parameters: Management Class Storage Class Data Class
==> ==> ==>
( Blank for default Management Class ) ( Blank for default Storage Class ) ( Blank for default Data Class )
. CREATOR TABLE NAME DEVICE UNITS PRIMARY SECONDARY DSN8710 ACT DISK 00042 0000018 0000018 DSN8710 DEPT DISK 00080 0000009 0000009 DSN8710 EMP DISK 00113 0000031 0000031 DSN8710 EMPPROJACT DISK 00052 0000074 0000074 DSN8710 PROJ DISK 00086 0000020 0000020 DSN8710 PROJACT DISK 00045 0000077 0000077 ******************************* BOTTOM OF DATA *******************************
On this screen, you can specify the following options. Management Class Enter the SMS management class, or leave blank for the default. Storage Class Enter the SMS storage class, or leave blank for the default. Data Class Enter the data class, or leave blank for the default.
317
Perform Load
Device If you want to change the device type from the one used for the original extract object, you can change the values for these fields as follows: If the original extract object was on Disk, and you want to write these files to tape, change the Device field to TAPE and blank out everything else. If the original extract object was on Tape, and you want to write some or all files to Disk, change the Device to DISK, and supply values for the Units, Primary, and Secondary fields. Important! If the original extract object was on Disk and you want to write these files to Disk, we do not recommend changing the values provided by Unicenter RC/Extract for UNITS, PRIMARY, and SECONDARY since these computed values are very accurate. Units Enter a numeric value (for block type allocation), CYL (for cylinders), or TRK (for tracks). If the original extract object is on tape, you can specify CYL or TRK. This field cannot be blank. If you enter a numeric value, the space is allocated in blocks of the size specified. Primary Enter a numeric value for the primary space allocation for a DISK data set. The original value displayed is the number of rows extracted from the table. If you specified TRK or CYL for Units, you should enter an appropriate numeric value in this field. Otherwise, it can be unchanged. Secondary Optionally provide a numeric value that represents the number of units to be allocated for the file if the primary allocation is not sufficient to contain the file. Note: Overflow processing is not available in the Split Allocations process, so the addition of a secondary allocation value provides a safeguard in the event that the value you specified for the primary allocation is not sufficient.
318

This chapter describes the screens used by the Command Center. You can access the Command Center menus by selecting option ? from the Main Menu. The major features of the Command Center are identified on the following example:
RXCC ---------------- RC/EXTRACT Command Center -----------------------------COMMAND ===> SCROLL ===> PAGE Registry SSID ===> D81A Srcdef Name ===> * Creator ===> * Source SSID ===> * Trgdef Name ===> * Creator ===> * Target SSID ===> * ---------------------------------------------------------------------- USER002 T S S NAME DESCRIPTION CREATOR P O SSID _ ________ ________________________ USER002 _ N ____ _ DEMO3 NEW SOURCE DEFINITION USER005 S U D81A _ USER001.DEMO3.EXTOBJ X * D81A _ @TRGDEF1 NEW TARGET DEFINITION USER001 T U D81A _ USER005.DEMO3.EXTOBJ X * D81A _ @TRGDEM3 NEW TARGET DEFINITION USER005 T U D81A _ @TRGDE03 NEW TARGET DEFINITION USER005 T U D81A _ @TRGDE03 NEW TARGET DEFINITION USER005 T U D81A _ DOH05 NEW SOURCE DEFINITION USER002 S N D81A _ USER002.DOH05.EXTOBJ X * D81A _ @TRGDEF1 NEW TARGET DEFINITION USER002 T N D81A PF7/8: Scroll Up/Down PF10/11: Scroll Left/Right *---- LAST UPDATE -USER DATE <==== OBJECT CREATE USER001 2005/04/23 USER001 2005/04/23 USER001 2005/04/23 USER005 2004/04/12 USER005 2004/04/12 USER005 2004/04/12 USER005 2004/04/12 USER002 2004/03/29 USER002 2004/03/29 USER002 2004/03/29 PF3/15: End
Header Fields
In the following fields (except Registry SSID), the percent sign (%) or asterisk (*) can be used as a wildcard character: Registry SSID Denotes the DB2 subsystem where the Unicenter RC/Extract Registry resides (where the Unicenter RC/Extract objects are stored). Srcdef Name Filters the source definitions that are displayed. Only source definitions whose names match this field are displayed. Creator Filters the source definitions that are displayed. Only source definitions whose creator matches this field are displayed. Source SSID Denotes the subsystem identifier of the source object. Use this field to filter the source definitions that are displayed. Only source definitions defined to extract objects from the DB2 subsystem that match this field are displayed.
41
List Fields
Trgdef Name Filters the target definitions that are displayed for extract objects under a source definition. Only target definitions whose names match this field are displayed. Creator Filters the target definitions that are displayed for extract objects under a source definition. Only target definitions whose creator matches this field are displayed. Target SSID Filters the target definitions that are displayed for extract objects under a source definition. Only target definitions whose target subsystem identifier matches this field are displayed.
List Fields
The following are the list fields that appear on the bottom half of the Command Center: S Enter a line command to act on an object. On the Object Create line, enter C to create a new source or target definition. Enter a question mark (?) or slash (/) next to an object to bring up a list of valid commands for that type of object. Note: See Command Center Object Command List for a complete listing of all valid commands for this field. Name Displays the name of the source definition, extract object, or target definition. Description Displays the description of the object. On the Object Create line, enter the description for the object you are about to create. Creator Displays the creator of the object. Incomplete extract objects display **INC** in this field (if you specified Y for Intercept Errors on the Process Source Definition screen). This means that the data to fulfill the requirements of the RI set described in the source definition (SRCDEF) was not completely extracted when the job that created the file was abnormally terminated. To rebuild and restart an incomplete extract, use the K line command.
42
List Fields
TP Displays the type of object: SSource definition XExtract object TTarget definition Use the Object Create field to specify the type of object you want to create. Note: Only source definitions and target definitions can be created on this line. SO Describes the share option of the object. Valid values are: NIndicates that the object will be visible only to the creator of the object. YIndicates that the object will be visible to all users; however, only the creator can update the object. UThe object will be visible to all users, and anyone an update the object. An asterisk (*) in this field indicates that the share option is not applicable to the object. Note: The SO field is not intended for use as a security mechanism. If a user has access to an extract object created by a different user and creates a target definition under this extract object, the source definition will become visible to the user even if the creator specified a Share Option of N on the Source Definition screen. SSID For source definitions and extract objects, this is the source DB2 subsystem identifier. For target definitions, this is the target subsystem identifier. User Displays the user ID of the last person who updated the object. Date Displays the date the object was last updated. Time Displays the time the object was last updated.
43
Command Center Object Command List

The Command Center displays source definitions, extract objects, and target definitions in the same list. Different line commands are available for each type of object, as shown in the following sections. Note: If you specify the Split Extraction option, the following functions are not available: From the Process Target Definition screen, do not specify S (SQL) for the Load Method. Specify U (Utility) for the Load Method. From the Command Center, do not specify P, F, E, K, and Z against this type of Extract Object. Do not specify P and Z against Target Definitions created under this type of Extract Object.
MATCHCASE Primary Command

Like the Matchcase profile variable, the MATCHCASE primary command lets you use DB2 object names that contain any valid characters accepted by DB2, including uppercase characters, lowercase characters, and embedded blanks. You can enter this command in the command line of any screen that lets you enter DB2 object names to immediately affect object names (such as tables, indexes, aliases, views, and so on). Note: This feature does not affect characters typically used by DB2 as wild cards, such as percent (%) and underscore (_). Your options are as follows: MATCHCASEEnter MATCHCASE (or abbreviate your entry to MATCH) in the command line of any screen and press enter to check the current status of the MATCHCASE command at any time. A message displays under the command line informing you of the current status. MATCHCASE ONEnter MATCHCASE ON (or abbreviate your entry to MATCH ON) and press Enter if you want Unicenter RC/Extract to consider object names on a case-sensative basis. MATCHCASE OFFEnter MATCHCASE OFF (or abbreviate your entry to MATCH OFF) and press Enter if you want Unicenter RC/Extract to consider object names regardless of case. Note: This option is SQL intensive. MATCHCASE CAPS(Default) Enter MATCHCASE CAPS (or abbreviate your entry to MATCH CAPS) and press Enter if you want Unicenter RC/Extract to automatically convert any lowercase characters in object names you enter to uppercase characters, then process the full name as all uppercase characters. As search criteria, Unicenter RC/Extract returns only the uppercase values that match.
44
Source Definition Object Type

The valid line commands for source definition object types are: CCreate a new source definition (on Object Create line). DDelete a source definition. TTemplate a source definition. UUpdate a source definition. XPerform extraction. SSingle step extract/load in batch. ZSingle step extract/delete/load in batch.
Extract Object Type

The valid line commands for extract object types are: CCreate a target definition. DDelete an extract object. RDisplay an extract report. XRefresh an extract object. IInsert into default targets using SQL. PSQL delete from default targets. ZUtility delete from default targets. FFind data in extract object. EEncrypt selected columns in extract object. KRebuild and restart incomplete extract.
45
Extract Object Search Facility
Target Definition Object Type

The valid line commands for target definition object types are: CCreate a new target definition (on Object Create line). DDelete a target definition. TTemplate a target definition. UUpdate a target definition. IInsert rows using a target definition. PPurge/delete rows using SQL. ZPurge/delete rows using utilities.
Tip: To get a pop-up screen listing the valid commands for that type of object, enter a question mark (?) or slash (/) next to the object in the S column.
Note: See the Unicenter RC/Extract User Guide for information about how to use all these line commands.

The Extract Object Search Facility screen is where you enter the object identification criteria to find data within your extract object. This screen appears when you specify F from the Command Center screen in the S column next to the extract object that you want to find data in, and press Enter.
RXPXSRC ---------- RC/EXTRACT Extract Object Search Facility ----------------COMMAND ===> SCROLL ===> PAGE Extract Object: USER002.DOHO5.EXTOBJ Execution Mode Object Creator Object Name Column Search Value ===> ===> ===> ===> ===> O * * * (O - Online; B - Batch) Matchcase ON
PF3/15: End
Enter: Process
Note: The encryption function is not available on a split extract.
46
Use the following fields to identify your search value. Extract Object The data set that contains the selected extract object. Execution Mode Enter one of the following values to specify execution mode: OPerform the search facility online. BPerform the search facility in batch. If this option is chosen, a batch processor stream (JCL that invokes the CA Batch Processor) is created to perform the extraction. At the Batch Processor screen that appears, you can preview and edit the batch job, immediately submit the batch job, or save the batch job to a data set for later invocation. Object Creator Identify the creator of the object you want to use. For information about the MATCHCASE setting, see the Profile section in this guide. Object Name Enter the object name you want to use as your start object. By placing an asterisk (*) in both the Object Creator and Object Name fields and pressing Enter, a pop-up screen displays objects (and their creators) within the extract object. Column The DB2 column name. Once you have selected an object, by placing an asterisk (*) in this field and pressing Enter, a pop-up screen displays columns within the selected object that which you can search. Search Value Enter the value exactly as it should appear in the column. Character fields will be truncated or blank filled on the right to correct data length in the column. Numeric fields will be truncated or zero filled on the left. Non-integer fields will maintain the precision and scale appropriate to the column. Signs must appear to the left of the signed number.
47
Post Encryption Facility Services

The Post Encryption Facility Services screen is where you select objects and columns for encryption, and specify file name and file management values for the encrypted file.
RXPXENC COMMAND ===> --Post Encryption Facility Services --SCROLL ===> PAGE
Extract Object ===> USER002.NEWXXXA6.EXTOBJ Execution Mode ===> (O - Online; B - Batch) Encryption Routine ===> RXL#EXIT Encrypted File high level ===> USER002 Encrypted File low level ===> ENCROBJ Dataclas = DEFAULT Storclas = WORK Mgmtclas = WORK Matchcase ON --------------------------------------------------------- USER002 C CREATOR OBJECT COLUMN _ *_______ *_________________ *_________________ ******************************** BOTTOM OF DATA *******************************
PF7/8: Scroll Up/Down
Cancel: Exit without processing PF3/15: Process Enter: Continue
Note: For information about the MATCHCASE setting, see the Profile section in this guide. Use the following fields to specify encryption data: Extract Object The data set that contains the selected extract object. Execution Mode Enter one of the following values to specify execution mode: OPerform the search facility online. BPerform the search facility in batch. If this option is chosen, a batch processor stream (JCL that invokes the CA Batch Processor) is created to perform the extraction. At the Batch Processor screen that appears, you can preview and edit the batch job, immediately submit the batch job, or save the batch job to a data set for later invocation. Encryption Routine The name of the encryption engine. By default, this is RXL#EXIT, however you can specify your own encryption routine. Note: A user-defined encryption routine is an Assembler program you provide, which must be assembled and linked into PTILIB. For more information about user-defined encryption routines, see Encryption Routines.
48
Encrypted File high level Specify a 1- to 8-character name, such as your TSO user ID to be used as the high-level qualifier of the encrypted file. You must have authority to use the name specified. By default, the name of the original extract object is specified. Note: This name is combined with the mid-level of the original extract object and the low-level qualifier specified in the Encrypted File low level field to create a unique data set name for the encrypted file. Encrypted File low level Specify a 1- to 8-character name for the low level qualifier of the encrypted file. The default is ENCROBJ. Dataclas, Storclas, and Mgmtclas The file management fields for the encrypted file. Values from the original extract object are automatically provided as the default. You can change these values as needed. C Line command field. Valid entries are: IInsert or select an object and column for encryption. DDelete or remove an object and column previously inserted. This lets you modify the list of objects and columns as you want, before processing the encryption. Object Creator Identify the creator of the object you want to use. Object Name Enter the DB2 object name. By placing an asterisk (*) in both the Object Creator and Object Name fields and pressing Enter, a pop-up screen displays objects (and their creators) within the extract object. Column The DB2 column name. Once you have selected an object, by placing an asterisk (*) in this field and pressing Enter, a pop-up screen displays columns within the selected object that which you can search.
49
Encryption Routines
An encryption routine is specified on the Post Encryption Facility Services screen header. The same encryption routine is called for each column in an extract object which is selected for encryption. The default encryption routine RXL#EXIT contains algorithms to encrypt most data types. It probably meets your data protection needs, unless your data has a specific pattern that you want to disguise in a particular way, or you need to encrypt data types which are not supported by RXL#EXIT. RXL#EXIT guarantees uniqueness when encrypting primary and foreign keys. This is essential to retaining the RI relationships between primary and foreign keys, even after they have been encrypted.
Changing the Default

You can replace the default encryption routine with your own encryption routine, but remember that your exit routine must maintain the uniqueness of primary and foreign keysall primary and foreign key values must protect out the same way. For example, do not use time-sensitive values to perform your encryption algorithm, because the primary key is encrypted at a slightly different time than the foreign key. To change the default encryption routine, edit the parmlib member RCX, and replace PROTECTION-EXIT (RXL#EXIT) with your encryption routine name.
Cascading Data Protection

Cascading encryption is provided for primary and foreign key fields, so you can protect your data without compromising the relational integrity of the data. When you specify encryption for a primary or foreign key column, it is automatically applied to all referentially related columns in an RI structure when the extract object is processed. This applies to all tables in an RI structure, regardless of which table you specifically encrypt. For example, if you encrypt the foreign key in a child table, the primary key in the parent table is also encrypted. You specify encryption for primary or foreign key columns the same way you specify it for other columns.
410
Specifying a Routine
You can supply your own encryption routine. The routine must be assembled and linked into PTILIB. Enter the name in the RCX parmlib member variable PROTECTION-EXIT, or in the Encryption Routine field on the Post Encryption Facility Services screen. Five parameters are passed to the encryption routine. The parameters are the addresses to the following fields: colname An eight character field containing the one- to eight-character name of the column to be encrypted. coldata The data to be encrypted. If the data is type VARCHAR, LONGVARCHAR, VARGRAPHIC, or LONGVARGRAPHIC, then the first two bytes are the SMALLINT length of the data value being passed. If the column is nullable, an additional one-byte character at the end of the data is the null indicator. NNot NULL YNULL You must use the values of the coltype, colength, and nullind fields to determine the real length of the data field. See Nullable Integer Data and Non-nullable Varchar Data for examples. Coltype The data type of the column to be encrypted; this is the address of a field which is eight characters in length, and may contain the following values. INTEGERInteger SMALLINTSmall integer FLOATFloat DECIMALDecimal CHARCharacter VARCHARVarchar VARGVargraphic LONGVARLong Varchar LONGVARGLong Vargraphic GRAPHICGraphic DATEDate
411
colength The length of the column to be encrypted. Two-byte SMALLINT. The column length is increased by two for columns of type VARCHAR, LONGVARCHAR, VARGRAPHIC, and LONGVARGRAPHIC. It is also increased by one for nullable columns. Note: You must also use the values of the coltype and nullind fields to determine the real length of the data field. See Nullable Integer Data and Non-nullable Varchar Data. nullind The null indicator, a one-byte character. This field indicates whether there is an additional one-byte NULL indicator included in the coldata parameter. NThere is no NULL indicator in coldata. YThere is a NULL indicator in coldata.
Examples
Nullable Integer Data The column COL1 is an integer field, with the value 7. It is nullable. colnameCOL1 coldataX0000000700 coltypeINTEGER colengthX05the value 5 nullindY The last byte of the coldata field is X00 because the value is not null. The colength is 5: the four-byte integer field plus the one-byte null indicator. Non-nullable Varchar Data The column COL2 is a non-nullable Varchar field of length 18. The value being passed is COMASSOC, which is only eight characters. colnameCOL2 coldataX0008 C3D6D4C1E2E2D6C3 coltypeVARCHAR colengthX14the value 20 nullindN The first two bytes of the coldata field, X0008, show the actual length of the data value. There is no null indicator byte at the end of the coldata field. The colength value X14 (20) reflects the VARCHAR field length of 18 plus the two-byte data length at the beginning of the VARCHAR field.
412
Restart Incomplete Extract Screen

The Restart Incomplete Extract screen appears when you specify the K line command in the S column next to the name of an incomplete extract object from the Command Center.
RXPREST COMMAND ===> --------- Restart Incomplete Extract --------SCROLL ===>
Source Definition: Creator ===> (These fields for information only) Name ===> Extract Object ===> Registry SSID: ---------------------------------------------- USER02 Execution Options: Process Mode ===> (O - Online, B - Batch) Extract Method ===> S (S - SQL, U - Utility) Update Options ===> N (Y - Yes, N - No) Update Allocations ===> N (Y - Yes, N - No) Intercept Errors ===> Y (Y - Yes, N - No) DDL Options: DDL not extracted during Restart. If DDL was originally extracted, it will be included in the final Extract Object. PF3/15: End Enter: Process
The following fields are on the Restart Incomplete Extract screen: Creator Displays the creator of the source definition. Name Displays the name of the source definition. Extract Object Displays the name of the incomplete extract object. Process Mode Specify the process mode for the incomplete extract object. Valid values are: OPerform the extraction process online. BPerform the extraction process in batch. If this option is chosen, a batch processor stream (JCL that invokes the CA Batch Processor) is created to perform the extraction. You are then taken to the Batch Processor screen where you can preview and edit the batch job, immediately submit the batch job, or save the batch job in a data set for later invocation.
413
Extract Method Specify the method by which data will be extracted from the objects in the source definition. SUse SQL statements to unload the source objects. This method is always used for online extractions. UUse the Unicenter Fast Unload utility to unload the source objects. Use this method for view extractions, in batch, and when the entire table is to be read. Update Options Enter Y in this field if you want to view or update the default extraction options. Otherwise, enter N. Update Allocations Enter Y in this field if you want to view or update the default allocation options for the extract object. Otherwise, enter N. Note: If you enter Y in this field, the Extract Options screen appears where you can change extract object allocation parameters. However, you should rarely have to change these optionsthe defaults should work for most extractions. WARNING! Writing the extract object to a disk or tape data set is supported. However, for optimal performance, we recommend that you choose DISK. Intercept Errors Enter Y to recover again in the event of errors that may occur during the restart of the incomplete object. This can be helpful in the event of memory errors or in case you have grossly underestimated the size of the file. Note: Restart is not available for extractions that have not begun to write table rows to the extract object, and or that have not completed at least one iteration of one step of the extraction. The incomplete extract object will also not be saved and registered for restart if the error or abend indicates possible corruption of the extract object.
414
Index
A
allocation options screen, 3-16
H
header fields, 4-1
C
command center screen, 4-1 commands PROFILE, 1-1
I
IBM load options screen, 3-12 incomplete extract object, 4-2 insert object selection screen, 2-14
D
data query edit screen, 2-15 define extract screens, 2-2 define targets, 3-2
K
K line command, 4-13
L
line commands extract object types, 4-5 K, 4-13 source definition object types, 4-5 target definition types, 4-6 list fields, 4-2 load functions, 3-1 define targets, 3-2 perform load, 3-9
E
encryption routine default, 4-10 specifying, 4-8, 4-11 extract definition line commands, 4-5 extract functions define extract, 2-2 perform extract, 2-19 extract object search facility screen, 4-6 extract object selection screen, 3-3 extract options screen, 2-27
M
MATCHCASE primary command, 4-4 matchcase profile option, 1-2
F
Fast Load options screen, 3-14
O
object mode, 2-8
Index1
P
perform extract, 2-19 perform load, 3-9 PFU extract options screen, 2-23 post-encryption support, 4-6 primary commands MATCHCASE, 4-4 process source definition screen, 2-19 process target definition screen, 3-9 profile, 1-1 PROFILE primary command, 1-1 profile screen, 1-1
profile, 1-1 Restart Incomplete Extract, 4-13 select related tables, 2-12 source definition, 2-6 source definition selection, 2-2 Split Allocations, 3-17 SQL extract options, 2-22 SQL load options, 3-11 start object selection, 2-4 target definition selection, 3-2 target mapping, 3-4 select related tables screen, 2-12 source definition object type line commands, 4-5 source definition screen, 2-6 source definition selection screen, 2-2 Split Allocations screen, 3-17
R
relationship mode, 2-11 Restart Incomplete Extract screen, 4-13
SQL extract options screen, 2-22 SQL load options screen, 3-11 start object selection screen, 2-4
S
screens allocation options, 3-16 command center, 4-1 data query edit, 2-15 extract object search facility, 4-6 extract object selection, 3-3 extract options, 2-27 Fast Load options, 3-14 IBM load options, 3-12 insert object selection, 2-14 PFU extract options, 2-23 process source definition, 2-19 process target definition selection, 3-9
T
target definition line commands, 4-6 target definition selection screen, 3-2 target mapping screen, 3-4 targets, 3-2
U
Unicenter Fast Unload interface with Unicenter RC/Extract, 2-23
Index2

Rcextract Ref Db2 Enu

Hochgeladen von

Dokumentinformationen

Originalbeschreibung:

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Rcextract Ref Db2 Enu

Hochgeladen von

Copyright:

Verfügbare Formate

Unicenter RC/Extract for DB2 UDB for z/OS

2006 CA. All rights reserved.

Chapter 2: Extract Functions

Chapter 3: Load Functions

Chapter 4: Command Center

Uncenter RC/Extract Reference Guide

ENTER - Process Information

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Chapter 2: Extract Functions

Source Definition Selection Screen

PF7/8: Scroll Up/Down

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Start Object Selection Screen

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Source Definition Screen

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Select Related Tables Screen

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Insert Object Selection Screen

Unicenter RC/Extract Reference Guide

Data Query Edit Screen

TYPE ----------- WHERE CONDITION ------- AND SMALLINT C(6) V(20)

EXTENDED WHERE (Use secondary paging keys to scroll)

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Process Source Definition Screen

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

SQL Extract Options Screen

CANCEL Abandon Changes

Unicenter RC/Extract Reference Guide

PFU Extract Options Screen

Extract Options: Share Level Use Image Copy

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Extract Options Screen

CANCEL Abandon Changes

Chapter 2: Extract Functions

Unicenter RC/Extract Reference Guide

Chapter 3: Load Functions

Chapter 3: Load Functions

Target Definition Selection Screen

Unicenter RC/Extract Reference Guide

Chapter 3: Load Functions

Extract Objects Containing More Than One Target Definition

PF7/8: Scroll Up/Down PF10/11: Scroll Left/Right

PF5: Global Change PF6: Show Dependent Objects Line Commands - B, S, T, X

Target Mapping Screen

PF7/8: Scroll Up/Down PF10/11: Scroll Left/Right