Previous Topic: The Commit Package ActionNext Topic: The Define Package Action


Commit Package Syntax

►►─ COMMit PACkage ─ package-id ──────────────────────────────────────────────►

 ►─┬─────────────────────────────────────────────────────────┬─ . ────────────►◄
   └─ OPTion ─ ¤ ─┬────────────────────────────────────┬─ ¤ ─┘
                  ├─ WHEre OLDer THAn ─ number ─ DAYs ─┤
                  └─ DELete PROMotion HIStory ─────────┘

COMMIT PACKAGE package-id

The COMMIT PACKAGE clause identifies the package you are committing. You can use a fully specified, partially wildcarded or fully wildcarded package ID. If you wildcard the package ID, you must specify the WHERE OLDER THAN clause. If you fully specify the package ID, the WHERE OLDER THAN clause is ignored.

You can include imbedded spaces in the package ID. If the package ID contains an imbedded space or comprises only numeric digits (for example, 12345), enclose the package ID in either single or double quotation marks.

OPTIONS

OPTION clauses allow you to further specify package actions.

WHERE OLDER THAN number DAYS-This clause allows you to specify the minimum age of the package you are committing. A package must be older than the number of days you specify in order to commit it. For example, if you specify WHERE OLDER THAN 30 DAYS and the current date is January 31, only packages executed successfully on or before January 1 are committed. There is no default value for the WHERE OLDER THAN clause. If you wildcard the package ID you must specify the WHERE OLDER THAN clause. The WHERE OLDER THAN value must be between 0 and 999, inclusive. You receive an error message if you specify a value outside this range.

DELETE PROMOTION HISTORY-This option is for promotion packages and it deletes all the promotion history associated with previous versions of the package.

Example: Commit Package SCL

The following are two examples of SCL for the COMMIT PACKAGE action. The first example commits a specific package called PAYROLLPKG01. The second example commits all packages that begin with PAYROLLPKG and are more than 30 days old.

Example One

COMMIT PACKAGE PAYROLLPKG01.

Example Two

COMMIT  PACKAGE PAYROLLPKG*
    		OPTIONS WHERE OLDER THAN 30 DAYS.