Extract Utility User's Guide - Supra - Cincom

Extract Utility User's Guide - Supra - Cincom Extract Utility User's Guide - Supra - Cincom

11.07.2015 Views

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

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!