HP 3000 Manuals HP 3000 Manuals
KSAM/3000 Reference Manual Printed in U.S.A. HP Part No. 30000-90079 Edition I0886 Printed May 1979
The information contained in this document is subject to change without notice. HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance or use of this material. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard. This document contains proprietary information which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language without the prior written consent of Hewlett-Packard Company. Æ 1979,1981,1986 PREFACE This publication is the reference manual for KSAM/3000. KSAM stands for Keyed Sequential Access Method, a method of accessing files indexed by keys. KSAM/3000 operates on the HP 3000 Computer System. The methods used to access a KSAM/3000 file differ depending on the particular language used. A COBOL user, an RPG user, a BASIC user, and an SPL user each has his own set of procedures with which to access a KSAM file; a FORTRAN user can choose to access a KSAM file with either COBOL or SPL procedures. All users can create, copy, purge, or perform other utility functions with the KSAMUTIL and FCOPY programs. This manual is organized so that the more general functions available to all users are described in the first two sections followed by a section describing KSAM access from each of the four languages: COBOL, SPL, FORTRAN, and BASIC. Access to KSAM from a COBOL II program is through COBOL II's indexed I/O Module and is not documented in this manual. Access to KSAM files from an RPG program is not described in this manual, but is included as part of the RPG manual: RPG/3000 Compiler Application & Reference Manual (32104-90001, Second Edition, 2/77) In order to use this manual effectively, you should be familiar with the MPE Operating System and with FCOPY. Also, it is assumed that you are familiar with the language in which you are programming. The following manuals contain all the information you might need as a supplement to this manual: MPE Commands Reference Manual (30000-90009) MPE Intrinsics Reference Manual (30000-90010) FCOPY/3000 Reference Manual (03000-90064) COBOL II/3000 Reference Manual (32233-90001) COBOL/3000 Reference Manual (32213-90001) SPL/3000 Reference Manual (30000-90024) EDIT/3000 Reference Manual (03000-90012) FORTRAN/3000 Reference Manual (30000-90040) BASIC/3000 Interpreter Reference Manual (30000-90026) BASIC/3000 Compiler Reference Manual (32103-90001) System Manager/System Supervisor Reference Manual (30000-90014) Using Files (30000-90102) SECOND EDITION The second edition of the KSAM manual provides the following new information: * Full syntax for and description of how to use the new KSAMUTIL commands: KEYSEQ, KEYDUMP, and KEYINFO. (section II) * Enhancements to the KSAMUTIL utility to allow abbreviated command names, offline listing of displays, and entry of MPE commands from KSAMUTIL. (section II) * Discussion of record pointer positioning in all languages; with special emphasis on using the record pointers for shared access. (sections III, IV, VI) * Description of how pointers are set internally. (appendix B) * Discussion of recovery procedures in case of system failure. (appendix E) In addition, there are minor corrections throughout the manual as well as documentation of minor enhancements. This edition covers the version of KSAM number A.02.04 release on the 1918 IT. CONVENTIONS USED IN THIS MANUAL NOTATION DESCRIPTION COMMAND Commands are shown in CAPITAL LETTERS. The names must contain no blanks and be delimited by a non-alphabetic character (usually a blank). KEYWORDS Literal keywords, which are entered optionally but exactly as specified, appear in CAPITAL LETTERS. parameter Required parameters, for which you must substitute a value, appear in bold italics. parameter Optional parameters, for which you may substitute a value, appear in standard italics. [ ] An element inside brackets is optional. Several elements stacked inside a pair of brackets means the user may select any one or none of these elements. Example: [ A ] [ B ] user may select A or B or neither. When brackets are nested, parameters in inner brackets can only be specified if parameters in outer brackets or comma place-holders are specified. Example: [parm1[,parm2[,parm3] ] ] may be entered as parm1,parm2,parm3 or parm1,,parm3 or ,,parm3 ,etc. { } When several elements are stacked within braces the user must select one of these elements. Example: { A } { B } user must select A or B or C. { C } ... An ellipsis indicates that a previous bracketed element may be repeated, or that elements have been omitted. user input In examples of interactive dialog, user input is underlined. Example: NEW NAME? ALPHA1 superscriptc Control characters are indicated by a superscriptc . Example: Yc . (Press Y and the CNTL key simultaneously.) RETURN RETURN indicates the carriage return key.