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

Managing Packages in Batch › The Cast Package Action › Cast Package Syntax

Cast Package Syntax

►►─ CASt PACkage ─ package-id ────────────────────────────────────────────────►
 ►─┬────────────────────────────────────────────────────────────┬─ . ─────────►◄
   └─ OPTion ─ ¤ ─┬───────────────────────────────────────┬─ ¤ ─┘
                  ├─┬─ BACKOut ─┬──────┬ ─ ENAbled ─┬─────┤
                  │ │           └─ IS ─┘            │     │
                  │ └─ BACKOut ─ IS NOT ─ ENAbled ──┘     │
                  ├─┬─ VALidate COMPonent ◄ ────────────┬─┤
                  │ ├─ VALidate COMPonent WITh WARning ─┤ │
                  │ └─ DO NOT VALidate COMPonent ───────┘ │
                  ├─ EXECUTion WINdow ─┤ FROM TO ├ ───────┤
                  │             ┌─ , ───────────┐         │
                  └─ NOTE= ─ ( ─▼─ 'note-text' ─┴─ ) ─────┘

Expansion of FROM TO

├── FROmfrom-datefrom-time ─┬────────────────────┬─────────────────────────────┤
                            └─ TOto-dateto-time ─┘

CAST PACKAGE package-id

The CAST PACKAGE clause identifies the package you are casting. The package ID can be either fully specified, partially wildcarded or fully wildcarded.

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

OPTIONS

Option clauses allow you to further specify package actions.

BACKOUT IS ENABLED/NOT ENABLED-The BACKOUT IS ENABLED/NOT ENABLED option indicates whether the backout facility will be available for this package.

VALIDATE COMPONENTS-The VALIDATE COMPONENTS option enables component validation within the package. You can only use this clause if your site allows you to specify whether component validation is to be performed.

The VALIDATE COMPONENTS clause causes the action to fail if component validation fails. The VALIDATE COMPONENTS WITH WARNING clause generates a warning if component validation fails. For information on component validation see the Packages Guide.

EXECUTION WINDOW FROM from-date from-time TO to-date to-time-The EXECUTION WINDOW clause allows you to change the execution window of the package as part of cast processing. You can use the EXECUTION WINDOW clause only if the package ID is fully qualified. Specify date values in DDMMMYY format and the time values in HH:MM format. If you specify the from-date, you must also specify the from-time. If you specify the to-date, you must also specify the to-time.

NOTES-Use the NOTES clause to add remarks to the package definition. Enclose the note text in either single or double quotation marks. If you use multiple text lines, enclose each text line in quotation marks and separate by commas. You can specify a maximum of 8 note text lines of up to 60 characters each. This text replaces any text that is already associated with the package.

Example: Cast Package SCL

The following is an example of CAST PACKAGE SCL. The SCL casts a package called PAYROLLPKG01.

CAST PACKAGE PAYROLLPKG01.