Browse Prior Art Database

Two-Dimensional Array Formatting

IP.com Disclosure Number: IPCOM000061475D
Original Publication Date: 1986-Aug-01
Included in the Prior Art Database: 2005-Mar-09
Document File: 3 page(s) / 91K

Publishing Venue

IBM

Related People

Smith, GH: AUTHOR

Abstract

Background - This article is concerned with programs that assist people in debugging software problems by analyzing and displaying the contents of storage saved in a dump data set, or from live storage. In programs, such as the Interactive Problem Control Setup (IPCS), PRINT DUMP, SNAP and Multiple Virtual Spaces (MVS), system control blocks and data areas are displayed via a formatting service. This service is called by exit programs via a service router program. The exit program passes a format parameter list, in which the location (storage address) of the object, and the format model to be used is specified. A format model describes the object to the formatter in terms of field offsets, lengths, labels and data types.

This text was extracted from a PDF file.
At least one non-text object (such as an image or picture) has been suppressed.
This is the abbreviated version, containing approximately 52% of the total text.

Page 1 of 3

Two-Dimensional Array Formatting

Background - This article is concerned with programs that assist people in debugging software problems by analyzing and displaying the contents of storage saved in a dump data set, or from live storage. In programs, such as the Interactive Problem Control Setup (IPCS), PRINT DUMP, SNAP and Multiple Virtual Spaces (MVS), system control blocks and data areas are displayed via a formatting service. This service is called by exit programs via a service router program. The exit program passes a format parameter list, in which the location (storage address) of the object, and the format model to be used is specified. A format model describes the object to the formatter in terms of field offsets, lengths, labels and data types. Also, each field description contains a view control field, which permits displaying subsets of the fields. Display Requirement - With the addition of vector registers to the XA hardware, there became a requirement for displaying the contents of the vector registers saved in a dump data set. The vector registers form a two-dimensional array of four-byte values, and they are located by coordinates (row, column); thus, the display of the values should be in those terms. The two-dimensional array formatting function was added to the format service to meet this requirement. It will handle not only arrays like the vector registers, but a wide variety of structures, including arrays of structures. It also provides several options to meet the needs of individual formatting applications. Formatting Models - Formatting models are created through the use of assembler macros. To support two-dimensional array formatting, keywords were added to a macro to describe the array in the model. An array description in a model includes: 1. The dimensions of the array, if they are static. 2. The order of processing, row-column or vice versa. 3. The description of items within an array element (column). 4. A view control field that applies to the whole array.
5. Options: a. Number rows and columns in decimal/hexadecimal. b.

Limit the numbers of columns displayed on one line. c. Suppression of row numbers. d. Suppression of column numbers. e. Starting column of the output buffer (left margin). f. Spacing between columns. g. Spacing between items within a column. h. Suppression of column headers. Format Parameter List - Fields were added to the format parameter list to allow an exit program to specify the dimensions of the array, if they were not specified in the model. This allows use of a generalized format model for different arrays, and the use of one model to han...