Contents: | Main | Chapter | See Also: | Getting Started Manual | Programmer Manual |
The Find Archived Entries option scans an archive file and retrieves an archive entry (or entries) that matches the NAME field (#.01) and/or the PRIMARY KEY and/or Identifier field(s) of the requested entry. On the prompts for lookup values and on the resulting report, PRIMARY KEY and Identifier fields are both called "Identifiers." The information contained in the archived entry is printed in CAPTIONED format [field name (field number)=value]. This option should only be used with tapes or files archived under VA FileMan V. 19.0 or later.
NOTE: The PRIMARY KEY is new with Version 22.0
Several requests for archived entries can be made at a time. An "(id)" next to a prompt indicates an Identifier, PRIMARY KEY, or Specifier field. One set of all the prompts makes one request.
The matching process is dependent on the presence or absence of an index on the archive file or tape. The matching process for archive files or tapes with no index can be more time-consuming, since it has to read the entire archived file to determine all matches. The matching process finds a match when the values of all the answered prompts match with that of an archived entry. If a partial value is typed at any prompt, the matching process finds all matches that begin with the partial value for that particular prompt.
Select ARCHIVE OPTION: FIND ARCHIVED ENTRIES This option will scan your archived file and will attempt to retrieve entries that match the name (.01) field and/or the identifier field(s) of the archived file. Magnetic tapes should be opened with variable length records. SEQUENTIAL ARCHIVE DEVICE: HFS DISK FILE HOST FILE NAME: TMP.TMP// ARC.DAT You are reading archived information from the CHANGE file. Do you want to continue? YES// Multiple requests may be made. One set of all prompts makes one request. This archived file contains an index of all archived entries. Do you want to see the index now? YES// NO. VERSION PROGRAMMER 101 17.10 DOE,JANE 102 17.32 DOE,JOHN 103 17.35 DOE,JOHN 330 17.09 DOE,JULIA Enter NO.: Enter VERSION (id) : Enter PROGRAMMER (id) : DOE,JULIA Enter NO.: Enter VERSION (id) : Enter PROGRAMMER (id) : Enter NO.: PRINT FOUND ENTRIES TO DEVICE: DECSERVER Searching archived file... Formatting found entries... Press RETURN to continue or '^' to exit: ARCHIVE RETRIEVAL LIST AUG 30,1992 PAGE: 1 REQUEST: 1 PROGRAMMER = DOE,JU -------------------------------------------------------------------- ARCHIVE FILE: CHANGE (#16000) LOOKUP VALUE (#.01): 330 IDENTIFIERS: VERSION (#1) = 17.09 PROGRAMMER (#7) = DOE,JULIA FIELDS: FIELD NAME: NO. (#.01) = 330 FIELD NAME: VERSION (#1) = 17.09 MATCHES FOUND: 1
Reviewed/Updated: March 4, 2007