►►─ ARChive PACkage ─ package-id ──────────────────────────────────────────────►
►─ TO ─┬─ DDName ─ ddname ───────────────────────────────────────────┬─────────►
└─ DSNname ─ dsname ─┬──────────────────────────────────────┬─┘
└─ MEMber ─ member-name ─┬───────────┬─┘
└─ REPlace ─┘
►─┬─────────────────────────────────────────────────────────┬── . ────────────►◄
└─ OPTion ─ ¤ ─┬─ WHEre OLDer THAn ─ number ─ DAYs ─┬─ ¤ ─┘
└─ DELete ───────┬─────────────────┬─┘
└─ AFTer ARChive ─┘
ARCHIVE PACKAGE package-id
The ARCHIVE PACKAGE clause identifies the package you are archiving. You can either fully specify, partially wildcard or fully wildcard the package ID. If you wildcard the package ID and specify the OPTIONS DELETE AFTER ARCHIVE clause, 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 characters (for example, 12345) then enclose the package ID in either single or double quotation marks.
TO DDNAME ddname
DSNAME dsname
MEMBER member-name
REPLACE
The TO clause identifies the data set to which you are archiving the package. You must enter either a DDname or a data set name. Specify only one of the two statements. The archive package file must be defined with variable length records and have a minimum record length of 4200. The data set blocksize must be 4 bytes greater than the record length. We recommend that you define a blocksize of 0 and let the system default to the optimum block size
The TO DDNAME clause identifies the name of an allocated DD statement. The DD statement must reference a sequential data set or a partitioned data set with an explicit member.
Note: When coding mulitple ARCHIVE PACKAGE statements with the TO DDNAME clause, use a DISP=MOD to assure that all data is retained.
The TO DSNAME clause identifies the name of an existing, catalogued data set. If the data set is a partitioned data set, you can use the member clause to specify a member name to be created. If you do not specify a MEMBER clause, the member name created is TEMPNAME. The REPLACE clause replaces an existing, like-named member. You can use the REPLACE clause is only if the MEMBER clause is specified.
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 archiving. The package must be older than the number of days you specify in order for it to be archived. For example, if you specify WHERE OLDER THAN 30 DAYS and the current date is January 31, only packages executed successfully or committed on or before January 1 are archived. There is no default value for the WHERE OLDER THAN clause. You must specify the WHERE OLDER THAN clause if you wildcard the package ID and specify the OPTIONS DELETE AFTER ARCHIVE clause. If you fully specify the package ID, the WHERE OLDER THAN clause is ignored. 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 AFTER ARCHIVE-This option deletes the package after the package definitions are successfully archived. If this is a promotion package, all versions of the package are deleted.
Example : Archive Package SCL
The following is an example of ARCHIVE PACKAGE SCL. The SCL archives all packages that begin with PAYROLLPKG and are older than 30 days. The packages are deleted after they have been archived.
ARCHIVE PACKAGE PAYROLLPKG*
TO DSNAME 'PAY.PACKAGE.ARCHIVE'
OPTIONS WHERE OLDER THAN 30 DAYS
DELETE AFTER ARCHIVE.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|