DS1 PDF
DS1 PDF
DS1 PDF
System i
Programming
Business Graphics Utility for System i commands
Version 6 Release 1
System i
Programming
Business Graphics Utility for System i commands
Version 6 Release 1
Note
Before using this information and the product it supports, be sure to read the information in
“Notices,” on page 23.
This edition applies to version 6, release 1, modification 0 of IBM Business Graphics Utility for System i (product
number 5761-DS2) and to all subsequent releases and modifications until otherwise indicated in new editions. This
version does not run on all reduced instruction set computer (RISC) models nor does it run on CICS models.
© Copyright International Business Machines Corporation 1998, 2008. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Create Graphics Data File (CRTGDF) . . 1 Display Graphics Data File (DSPGDF) 17
The Create Graphics Data File (CRTGDF) command creates a graphics data file (GDF) from a chart
format and a data file defined by the Business Graphics Utility (BGU).
Parameters
Keyword Description Choices Notes
FILE File Qualified object name Required,
Positional 1
Qualifier 1: File Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Member Name, *FIRST Optional,
Positional 2
MBROPT Member option *NOREPLACE, *REPLACE Optional
AUT Authority Name, *LIBCRTAUT, *CHANGE, *ALL, *EXCLUDE, *USE Optional
TEXT Text Character value, *CHTHDG Optional
CHTFMT Chart format Single values: *DFT, *GDF Optional
Other values: Qualified object name
Qualifier 1: Chart format Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CHTDTAFILE Chart data file Single values: *DFT Optional
Other values: Qualified object name
Qualifier 1: Chart data file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CHTDTAMBR Chart data member Name, *FIRST Optional
RCDFMT Record format Name, *FIRST Optional
DTAFMT Data format *FILEDFT, *NONPAIR, *PAIR Optional
FROMRCD Starting record number 1-2147483647, *FIRST Optional
NBRRCDS Number of records 1-999, 100, *END Optional
CHTHDG Chart heading Character value, *CHTFMT Optional
Top
Member (MBR)
Specifies the database file member in which the GDF is to be stored. If the database file member already
exists, you must specify *REPLACE in the MBROPT parameter to have the member replaced. If the
member does not exist, it will be created.
Authority (AUT)
Specifies the authority to the graphics data file.
Text (TEXT)
Describes the contents of the GDF member. The text string can be up to and including 50 characters.
Examples
None
Top
Error messages
*ESCAPE Messages
BGU0670
BGU is already active.
Top
The Delete Chart Format (DLTCHTFMT) command deletes a chart format or a group of chart formats
from one or more libraries.
Parameters
Keyword Description Choices Notes
CHTFMT Chart format Qualified object name Required,
Positional 1
Qualifier 1: Chart format Generic name, name
Qualifier 2: Library Name, *LIBL, *ALL, *ALLUSR, *USRLIBL, *CURLIB
Top
Examples
None
Top
Error messages
*ESCAPE Messages
CPF2105
Object &1 in &2 type *&3 not found.
CPF2110
Library &1 not found.
CPF2113
Cannot allocate library &1.
CPF2114
Cannot allocate object &1 in &2 type *&3.
CPF2117
&4 objects type *&3 deleted. &5 objects not deleted.
CPF2182
Not authorized to library &1.
CPF2189
Not authorized to object &1 in &2 type *&3.
Top
The Display Chart (DSPCHT) command displays a chart defined by the Business Graphics Utility (BGU).
You can type this command to display a chart on a graphics-capable work station without starting BGU.
Parameters
Keyword Description Choices Notes
CHTFMT Chart format Single values: *DFT Optional,
Other values: Qualified object name Positional 1
Qualifier 1: Chart format Name
Qualifier 2: Library Name, *LIBL, *CURLIB
FILE File Single values: *DFT Optional,
Other values: Qualified object name Positional 2
Qualifier 1: File Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Member Name, *FIRST Optional
OUTPUT Output *, *PLOT, *PRINT Optional
RCDFMT Record format Name, *FIRST Optional
DTAFMT Data format *FILEDFT, *NONPAIR, *PAIR Optional
FROMRCD Starting record number 1-2147483647, *FIRST Optional
NBRRCDS Number of records 1-999, 100, *END Optional
CHTHDG Chart heading Character value, *CHTFMT Optional
DEVTYPE Device type 7372, 7371, 5224, 5225, 4234, IPDS, 4214, 6180, 6182 Optional
PENRATE Plotter pen rate 1-100, 100 Optional
PENWTH Plotter pen width 1-10, 3 Optional
PLTADR Plotter address 1-31, *SEARCH Optional
HRZPPR Plotter paper horizontal *YES, *NO Optional
CHRSHAPE Maintain character shape *YES, *NO Optional
PPRSIZE Plotter paper size *SMALL, *LARGE Optional
FORMFEED Form feed *AUTOCUT, *CUT Optional
File (FILE)
Specifies the database file (physical or logical) containing the data to be charted. The data is charted
using the format specified in the CHTFMT parameter.
Member (MBR)
Specifies the database file member containing the data to be charted. The data is charted using the format
specified in the CHTFMT parameter.
Output (OUTPUT)
Specifies that the chart is either displayed (at a graphics-capable work station), plotted, or printed.
Note: This parameter overrides the chart heading only. To change the chart heading permanently, you
must select option 3 (Chart change format) from the Business Graphics Utility (BGU) menu.
Top
Examples
None
Top
The Display Graphics Data File (DSPGDF) command displays, prints, and plots a graphics data file
defined by the Business Graphics Utility (BGU), by a system graphics application, or by an application on
a different system that produces the graphics-data-file-orders which are compatible with the system.
Parameters
Keyword Description Choices Notes
FILE File Qualified object name Required,
Positional 1
Qualifier 1: File Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Member Name, *FIRST Optional,
Positional 2
OUTPUT Output *, *PLOT, *PRINT Optional
DEVTYPE Device type 7372, 7371, 5224, 5225, 4234, IPDS, 4214, 6180, 6182 Optional
PENRATE Plotter pen rate 1-100, 100 Optional
PENWTH Plotter pen width 1-10, 3 Optional
PLTADR Plotter address 1-31, *SEARCH Optional
HRZPPR Plotter paper horizontal *YES, *NO Optional
PPRSIZE Plotter paper size *SMALL, *LARGE Optional
FORMFEED Form feed *AUTOCUT, *CUT Optional
Top
File (FILE)
Specifies the physical database file containing the graphics data to be displayed.
Member (MBR)
Specifies the database file member containing the data to be displayed.
Output (OUTPUT)
Specifies that the file is either displayed (at a graphics-capable work station), plotted, or printed.
Examples
None
Top
Error messages
*ESCAPE Messages
BGU0670
BGU is already active.
BGU9002
BGU session ended abnormally.
BGU9003
Unrecoverable error detected during BGU operation.
Top
The Start Business Graphics Utility (STRBGU) command starts the Business Graphics Utility (BGU).
Parameters
None
Top
Examples
None
Top
Error messages
*ESCAPE Messages
BGU0670
BGU is already active.
BGU9002
BGU session ended abnormally.
BGU9003
Unrecoverable error detected during BGU operation.
Top
IBM may not offer the products, services, or features discussed in this document in other countries.
Consult your local IBM representative for information on the products and services currently available in
your area. Any reference to an IBM product, program, or service is not intended to state or imply that
only that IBM product, program, or service may be used. Any functionally equivalent product, program,
or service that does not infringe any IBM intellectual property right may be used instead. However, it is
the user’s responsibility to evaluate and verify the operation of any non-IBM product, program, or
service.
IBM may have patents or pending patent applications covering subject matter described in this
document. The furnishing of this document does not give you any license to these patents. You can send
license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan
The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION
PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some
states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this
statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication.
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
Such information may be available, subject to appropriate terms and conditions, including in some cases,
payment of a fee.
The licensed program described in this document and all licensed material available for it are provided
by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement,
IBM License Agreement for Machine Code, or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the
results obtained in other operating environments may vary significantly. Some measurements may have
been made on development-level systems and there is no guarantee that these measurements will be the
same on generally available systems. Furthermore, some measurements may have been estimated through
extrapolation. Actual results may vary. Users of this document should verify the applicable data for their
specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of
those products.
All statements regarding IBM’s future direction or intent are subject to change or withdrawal without
notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs.
Each copy or any portion of these sample programs or any derivative work, must include a copyright
notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. ©
Copyright IBM Corp. _enter the year or years_. All rights reserved.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks
of Adobe Systems Incorporated in the United States, and/or other countries.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon,
Intel SpeedStep, Itanium, and Pentium are are trademarks or registered trademarks of Intel Corporation
or its subsidiaries in the United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other
countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product, or service names may be trademarks or service marks of others.
Appendix. Notices 25
Terms and conditions
Permissions for the use of these publications is granted subject to the following terms and conditions.
Personal Use: You may reproduce these publications for your personal, noncommercial use provided that
all proprietary notices are preserved. You may not distribute, display or make derivative works of these
publications, or any portion thereof, without the express consent of IBM.
Commercial Use: You may reproduce, distribute and display these publications solely within your
enterprise provided that all proprietary notices are preserved. You may not make derivative works of
these publications, or reproduce, distribute or display these publications or any portion thereof outside
your enterprise, without the express consent of IBM.
Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either
express or implied, to the publications or any information, data, software or other intellectual property
contained therein.
IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of
the publications is detrimental to its interest or, as determined by IBM, the above instructions are not
being properly followed.
You may not download, export or re-export this information except in full compliance with all applicable
laws and regulations, including all United States export laws and regulations.
Printed in USA