Batch Processing › SARBCH Control Statements › PERM

PERM

The PERM control statement sets a SYSOUT group to permanent status (can be used for long term archiving) or removes it from permanent status.

When the SYSOUT group is set to permanent status, its period of retention and its location are dependent on the Expanded Retention Option initialization parameters and table statements. These parameters and statements are processed during the CA View started task backup cycle.

When the SYSOUT group is removed from permanent status, it no longer resides under the control of the Expanded Retention Option.

Note: Setting a SYSOUT to PERM when the ERO Initialization Option (EROOPT) is NO, causes the following:

• All retention values (NGEND and/or NGENT) are ignored
• The report stays permanent on the database

If the SYSOUT was on disk when it was set to PERM, the SYSOUT remains on disk indefinitely. If the SYSOUT was only on tape, it remains on tape indefinitely.

Syntax:

/PERM  DELETE
       DISK
       GEN=nnnnn
       ID=id
       SEQ=nnnnn
       TAPE

where:

DELETE

Specifies that the SYSOUT group is to be removed from permanent status.

DISK

Specifies that the SYSOUT group is to be set to a permanent "on disk" status.

When this keyword is specified, the SYSOUT group must currently reside in a disk or temporary disk status. This parameter cannot be specified with the DELETE and TAPE keywords. If the DELETE, DISK, and TAPE keywords are omitted, DISK is the default.

GEN=nnnnn

Specifies the absolute or relative number of the generation of the SYSOUT group to be set to permanent status or removed from permanent status.

ID=id

Specifies the SYSOUT ID of the SYSOUT group to be set to permanent status or removed from permanent status.

The value can be 1 to 32 characters.

Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".

SEQ=nnnnn

Specifies the absolute or relative SYSOUT sequence number of the SYSOUT group to be set to permanent status or removed from that status.

• If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
• If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.

EX: SEQ=-1

The second most recently archived SYSOUT is processed regardless of its generation and sequence number.

EX: SEQ=-2

The third most recently archived SYSOUT is processed regardless of its generation and sequence number.

TAPE

Specifies that the SYSOUT group is to be set to a permanent on tape status.

This parameter cannot be specified with the DELETE and DISK keywords.