Copy Graph Format (CPYGPHFMT)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Copy Graph Format (CPYGPHFMT) command copies an existing graph format into a graph format specified by the user.

Top

Parameters

Keyword Description Choices Notes
FROMFMT From format Qualified object name Required, Positional 1
Qualifier 1: From format Name
Qualifier 2: Library Name, QPFRDATA, *CURLIB
TOFMT To format Qualified object name Optional, Positional 2
Qualifier 1: To format Name, *FROMFMT
Qualifier 2: Library Name, *FROMLIB, *CURLIB
REPLACE Replace *NO, *YES Optional
Top

From format (FROMFMT)

Specifies the graph format from which the copy is to be created.

This is a required parameter.

The possible library values are:

QPFRDATA
The IBM-supplied performance library, QPFRDATA, is where the copy of the graph format is located.
*CURLIB
The current library for the job is used to locate the graph format. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the graph format is located.
format-name
Specify the name of the graph format.
Top

To format (TOFMT)

Specifies the graph format location where the copy is to be created.

The possible library values are:

*FROMLIB
The graph format is located in the library specified on the FROMFMT parameter.
*CURLIB
The current library for the job is where the copy of the graph format will be located. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the copy of the graph format will be located.
*FROMFMT
The graph format name specified on the FROMFMT parameter is used.
format-name
Specify the name of the copy of the graph format.
Top

Replace (REPLACE)

Specifies whether to replace the graph format in the To format prompt (TOFMT parameter) if the graph format already exists.

*NO
The existing graph format is not replaced with the new graph format.
*YES
The existing graph format is replaced with the new graph format.
Top

Examples

Example 1: Sending a Copy to the Default Library

CPYGPHFMT   FROMFMT(MYFMT)  TOFMT(YOURFMT)

This command makes a copy of MYFMT and sends it to YOURFMT in the QPFRDATA library.

Example 2: Sending a Copy to a Specified Library

CPYGPHFMT   FROMFMT(MYLIB/FMT1)  TOFMT(YOURLIB/FMT2)

This command makes a copy of FMT1 in the MYLIB library and sends it to FMT2 in the YOURLIB library.

Top

Error messages

*ESCAPE Messages

PFR9043
&1 does not exist in library &2.
Top