Extract Utility User's Guide - Supra - Cincom
Extract Utility User's Guide - Supra - Cincom Extract Utility User's Guide - Supra - Cincom
RestrictionsDescriptionAttributesIf you code a element, it must appear after a tag but beforethe matching tag. You cannot have a without identifyingthe of which it is a subfield.Optional. Describes a field in the extracted output flat file. Extract placesdata in the extracted output flat file field by field as described by the tags. The order in which you code tags determines the order in whichthe associated data appears in each extracted output record. With the tag, however, you direct Extract to place only part of the data ofthe Physical Field in the extracted output.Name=”subfield-name” Required. Identifies the subfield. This can be anyname.Type=”subfield-type” Required. Identifies the data type of the extractedsubfield. Valid values are:C Character text stringB Binary integer numbersF Floating point numbersP Packed decimal stringZ Zoned decimal numericD Zoned leading decimal numericOPENVMS L Leading separate numericOPENVMS N Numeric trailing overpunchOPENVMS T Trailing separate numericOPENVMS O Numeric leading overpunchLength=”subfield-length” Required. Identifies the data length of theextracted subfield. Valid values are integers in the range 1 to the length of thefield of which this is a subfield. You must supply the length as a two-digitnumber (with a leading zero for length values less than 10, e.g. 06).Extract Utility User's Guide, P25-9513-03 56Chapter: 5. Coding the Extract functionSection: Coding the XML for the Layout Control file
Displacement=”subfield-displacement” Conditional. Defines the offsetwithin the field at which the subfield begins. You may omit this attribute ifthe subfield starts at the beginning of the parent field. Otherwise, you mustcode a Displacement. Valid values are integers in the range 1 to the length ofthe field of which this is a subfield. You must supply the displacement as atwo-digit number (with a leading zero for length values less than 10, e.g. 06).Null=”subfield-null-value” Optional. Identifies the null value for theextracted subfield. If you specify the Null attribute, Extract compares thesubfield-null-value against the data value of the extracted field. If theymatch, then nothing is written in the extracted output flat file, resulting in twoconsecutive delimiters.Format=”subfield-format-mask” Optional. Specifies an editing mask forformatting extracted numeric subfields. If you omit this attribute, Extractcopies the data unchanged from the database file to the extracted output flatfile. If you specify this attribute, you must ensure that the data incoming toExtract is numeric. This attribute specifies only the following conditions: sign,number of integer digits, decimal position, and number of decimal places.Specify the mask using the following characters:- Indicates the data type is signed and you want an explicit leading minusincluded in the extracted output.. Indicates you want a decimal point inserted within the extracted output.# Indicates a digit. If you code a decimal point in the mask, you must code asingle # to the left of the decimal point in the mask. This allows for anynumber of digits to the left of the decimal point in the extracted output.On the other hand, the number of # symbols you provide to the right of thedecimal point in the mask tells Extract the exact number of digits togenerate to the right of the decimal point in the extracted output.Extract Utility User's Guide, P25-9513-03 57Chapter: 5. Coding the Extract functionSection: Coding the XML for the Layout Control file
- Page 5 and 6: 5. Coding the Extract function ....
- Page 7 and 8: OpenVMS installation and tailoringD
- Page 9 and 10: The FUNCTION statement initiates th
- Page 11 and 12: Coding null argumentsDefault values
- Page 13 and 14: Validating programsThe program list
- Page 15 and 16: Running debug and trace for DBA uti
- Page 17 and 18: 3. Executing the Extract utilityOve
- Page 19 and 20: File definitions in z/OSThese files
- Page 21 and 22: File definitions in OpenVMSYou must
- Page 23 and 24: Choosing run-time options in z/OSZ/
- Page 25 and 26: Run-timeoptionsResults of different
- Page 27 and 28: Estimating the size of the stack/he
- Page 29 and 30: Coding the UCL for the control sect
- Page 31 and 32: SCHEMA (schema-name)Description Req
- Page 33 and 34: Coding the UCL for the Extract func
- Page 35 and 36: ⎡DIRECT⎤⎢SERIAL⎥QUALIFIER (
- Page 37 and 38: ⎧D'dec-string'⎫⎪⎪KEY ( ⎨X
- Page 39 and 40: ⎡low-rrn⎤⎢⎥RRN - RANGE (⎢
- Page 41 and 42: SECONDARY-KEY(secondary-key)Restric
- Page 43 and 44: SELECT (f1element1[,f1element2,...,
- Page 45 and 46: ⎧RECORD ( ALL ⎫⎨⎬)⎩record
- Page 47 and 48: ♦Additional constraints apply in
- Page 49 and 50: This section explains the detailed
- Page 51 and 52: RestrictionsDescriptionFormatConsid
- Page 53 and 54: Format=”field-format-mask” Opti
- Page 55: Considerations♦♦♦♦♦Each X
- Page 59 and 60: Extract examplesThe examples in thi
- Page 61 and 62: The output report listing is:---TTT
- Page 63 and 64: The output report listing is:1TIS/X
- Page 65 and 66: The first few records of the extrac
- Page 67 and 68: The output report listing is:---TTT
- Page 69 and 70: The first few records of the extrac
- Page 71 and 72: Extract Utility User's Guide, P25-9
- Page 73 and 74: 0 CSUL0307I : ALL CONTROL SECTIONS
- Page 75 and 76: IndexAaccess linkpathspecifying for
- Page 77: STEPLIB filez/OS 19storage 23supero
Displacement=”subfield-displacement” Conditional. Defines the offsetwithin the field at which the subfield begins. You may omit this attribute ifthe subfield starts at the beginning of the parent field. Otherwise, you mustcode a Displacement. Valid values are integers in the range 1 to the length ofthe field of which this is a subfield. You must supply the displacement as atwo-digit number (with a leading zero for length values less than 10, e.g. 06).Null=”subfield-null-value” Optional. Identifies the null value for theextracted subfield. If you specify the Null attribute, <strong>Extract</strong> compares thesubfield-null-value against the data value of the extracted field. If theymatch, then nothing is written in the extracted output flat file, resulting in twoconsecutive delimiters.Format=”subfield-format-mask” Optional. Specifies an editing mask forformatting extracted numeric subfields. If you omit this attribute, <strong>Extract</strong>copies the data unchanged from the database file to the extracted output flatfile. If you specify this attribute, you must ensure that the data incoming to<strong>Extract</strong> is numeric. This attribute specifies only the following conditions: sign,number of integer digits, decimal position, and number of decimal places.Specify the mask using the following characters:- Indicates the data type is signed and you want an explicit leading minusincluded in the extracted output.. Indicates you want a decimal point inserted within the extracted output.# Indicates a digit. If you code a decimal point in the mask, you must code asingle # to the left of the decimal point in the mask. This allows for anynumber of digits to the left of the decimal point in the extracted output.On the other hand, the number of # symbols you provide to the right of thedecimal point in the mask tells <strong>Extract</strong> the exact number of digits togenerate to the right of the decimal point in the extracted output.<strong>Extract</strong> <strong>Utility</strong> <strong>User's</strong> <strong>Guide</strong>, P25-9513-03 57Chapter: 5. Coding the <strong>Extract</strong> functionSection: Coding the XML for the Layout Control file