Extract Utility User's Guide - Supra - Cincom

⎡DIRECT⎤⎢SERIAL⎥QUALIFIER ( ⎢⎥ )⎢SEQUENTIAL⎥⎢⎥⎣INDEX⎦DescriptionDefaultOptional. Indicates the access mode you want Extract to use to access thecurrent file.SERIALOptions DIRECT Reads a specific record either by RRN or by key. For moreinformation, see considerations below.ConsiderationsSERIALAccesses the file serially without regard to chain sequence.SEQUENTIAL Accesses the related file sequentially by a specific linkpath.INDEX♦♦Accesses the file using a specific Secondary Key.Do not code QUALIFIER (SEQUENTIAL) for a primary file.As shown in the format, QUALIFIER has four options. Depending on the typeof file (primary (P) or related (R)) and the access mode you code, thefollowing statements are either required (r), optional (o), or invalid (i):QUALIFIER: DIRECT SERIAL SEQUENTIAL INDEXFile Type: P R P R P R P RRRN i r i i i i i iLINKPATH i i i i i r i iKEY r i i i i o o oRRN-RANGE i i o o i i i iMAXIMUM i i o o i o o oSECONDARY-KEY i i i i i i r r♦♦♦If you code the QUALIFIER statement, you must put it before the RECORDstatements.If you code a QUALIFIER(DIRECT) statement subordinate to the first FILEstatement in your UCL, the function extracts only one record from thespecified file. For subsequent FILE statements in your UCL, however, asubordinate QUALIFIER(DIRECT) statement extracts one record for each keyvalue supplied from an earlier file. Therefore, multiple records may beextracted if multiple key values are passed by the program.If you code QUALIFIER (SEQUENTIAL) and the LINKPATH and KEYstatements, the function extracts only the chain containing the key valueyou coded.Extract Utility User's Guide, P25-9513-03 35Chapter: 5. Coding the Extract functionSection: Coding the UCL for the Extract function