HP 3000 Manuals HP 3000 Manuals
HP RPG/XL Utilities-Part 1 XSORT Extra Function Sort XSORT HP Part No. 30318-90006 Printed Oct 1989
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 prior written consent of Hewlett-Packard Company. Copyright Æ 1989 by HEWLETT-PACKARD COMPANY PRINTING HISTORY New editions are complete revisions of the manual. Update packages, which are issued between editions, contain additional and replacement pages to be merged into the manual by the customer. The date on the title page and back cover of the manual changes only when a new edition is published. When an edition is reprinted, all the prior updates to the edition are incorporated. No information is incorporated into a reprinting unless it appears as a prior update. The edition does not change. The software product part number printed alongside the date indicates the version and update level of the software product at the time the manual edition or update was issued. Many product updates and fixes do not require manual changes, and conversely, manual corrections may be done without accompanying product changes. Therefore, do not expect a one on one correspondence between product updates and manual updates. First Edition October 1989 30318A.00.04 PREFACE TO EXTRA FUNCTION SORT FOR RPG (XSORT) This manual is intended for the use of inexperienced as well as seasoned programmers. To answer the needs of programmers with varied backgrounds, the manual presents information of varying complexity, especially in explaining the XSORT specifications. Most of this manual will be devoted to the five-part specifications. The information will be presented under the following headings: Overview of XSORT Specifications shows you which columns of the specifications you must consider when you are preparing a sort. Overviews serve as a quick reminder to those who are familiar with the program Overview of Column Entries lists all possible entries for each column in the specifications. These are brief descriptions and explanations of the entries and their purposes. Column Entries provide detailed discussions of the meanings of all possible entries, their relationships to other entries within the specifications type and other entries in other specification types. They are intended for new users of XSORT. Using XSORT Commands gives you the various MPE commands necessary to use XSORT in job stream and interactive session, with different arrangements of input and output files. XSORT Applications demonstrate how specifications are adapted to the requirements of particular jobs. The more extensive the user's experience, the more readily will XSORT's versatility and efficiency become apparent. The manual takes into consideration that some users will be employing the program for the first time. Information and instruction are provided for several levels of experience so that the new user should be able to put XSORT to work after reading the manual. In using XSORT, you may have programs and systems that interface with the Keyed Sequential Access Method (KSAM/3000), the IMAGE Data Base Management System (IMAGE/3000), and the Data Entry and Forms Management System (V/3000). For information about these systems, please read: Manual Title Part Number -------------------------------------------------------------------------------------- IMAGE/3000 Data Base Management Reference System 30000-90041 KSAM/3000 Reference Manual 30000-90079 VPLUS/3000 Reference Manual 32209-90001 Conventions NOTATION DESCRIPTION UPPERCASE Within syntax statements, characters in uppercase must be entered in exactly the order shown, though you can enter them in either uppercase or lowercase. For example: SHOWJOB Valid entries: showjob ShowJob SHOWJOB Invalid entries: shojwob ShoJob SHOW_JOB italics Within syntax statements, a word in italics represents a formal parameter or argument that you must replace with an actual value. In the following example, you must replace filename with the name of the file you want to release: RELEASE filename punctuation Within syntax statements, punctuation characters (other than brackets, braces, vertical parallel lines, and ellipses) must be entered exactly as shown. { } Within syntax statements, braces enclose required elements. When several elements within braces are stacked, you must select one. In the following example, you must select ON or OFF: {ON } SETMSG {OFF} [ ] Within syntax statements, brackets enclose optional elements. In the following example, brackets around ,TEMP indicate that the parameter and its delimiter are optional: PURGE {filename} [,TEMP] When several elements with brackets are stacked, you can select any one of the elements or none. In the following example, you can select devicename or deviceclass or neither: SHOWDEV [devicename] [deviceclass] Conventions (continued) NOTATION DESCRIPTION [...] Within syntax statements, a horizontal ellipsis enclosed in brackets indicates that you can repeatedly select elements that appear within the immediately preceding pair of brackets or braces. In the following example, you can select itemname and its delimiter zero or more times. Each instance of itemname must be preceded by a comma: [,itemname][...] If a punctuation character precedes the ellipsis, you must use that character as a delimiter to separate repeated elements. However, if you select only one element, the delimiter is not required. In the following example, the comma cannot precede the first instance of itemname: [itemname][,...] |...| Within syntax statements, a horizontal ellipsis enclosed in parallel vertical lines indicates that you can select more than one element that appears within the immediately preceding pair of brackets or braces. However, each element can be selected only one time. In the following example, you must select ,A or ,B or ,A,B or ,B,A : {,A} {,B}|...| If a punctuation character precedes the ellipsis, you must use that character as a delimiter to separate repeated elements. However, if you select only one element, the delimiter is not required. In the following example, you must select A or B or AB or BA. The first element cannot be preceded by a comma: {A} {B}|,...| ... Within examples, horizontal or vertical ellipses indicate where portions of the example are omitted. Å Within syntax statements, the space symbol Å shows a required blank. In the following example, you must separate modifier and variable with a blank: SET[(modifier)]Å(variable); underlining User input is underlined. For example: PROMPT?response In a syntax statement, brackets, braces or ellipses are underlined if you must enter them. For example: COMMAND [[ParameterA]] = ParameterB Conventions (continued) NOTATION DESCRIPTION shading Within an example of interactive dialog, shaded characters indicate user input or responses to prompts. In the following example, OMEGA is the user's response to the NEW NAME prompt: NEW NAME? OMEGA The symbol indicates a key on the terminal's keyboard. For example, CTRL indicates the Control key. CTRLchar CTRLchar indicates a control character. For example, CTRLY means you have to simultaneously press the Control key and the Y key on the keyboard. base prefixes The prefixes %,#, and $ specify the numerical base of the value that follows: %num specifies an octal number. #num specifies a decimal number. $num specifies a hexadecimal number. When no base is specified, decimal is assumed.