Operand

Description

*

You can substitute an asterisk for the entity type, name, and version for the current entity occurrence.

name

Definition to duplicate:

• 1‑ to 18‑character name of an unmodeled (sequential or VSAM file) dataview.
• One‑ to eight‑character program, report, or panel name
• 1‑ to 15‑character system name or user name
• One‑ to three‑character system ID or user ID

version

Version of the entity to duplicate. For information on valid versions to specify, see Using Version Clauses in CA Ideal Commands in the “Preliminary Concepts” chapter.

Operand

Description

SYSTEM sid

Three‑character system short identifier for the program, panel, or report to duplicate. If you do not enter an ID, the current system is the default.

Note: This option applies to PANEL, PROGRAM, and REPORT. You cannot specify the SYSTEM parameter with DUPLICATE USER, SYSTEM or DATAVIEW.

newname

Name the definition copies to. The keyword NEWNAME is required.

Note: You cannot use NEWNAME with SYSTEM or USER. This is because you cannot duplicate a user or system to a new name because one of the attributes is a short‑id that is also an alias for the entity. Duplicating results in a duplicate alias, which Datadictionary does not allow. You can duplicate these entities only to a new version.

NEXT

Copies the definition to the next version of that definition (default).