1. Database Structure › 1.3 Data Content › 1.3.3 Archive SAS File Label Conventions

1.3.3 Archive SAS File Label Conventions

The SAS File Label plays an integral role in the use and
access of data stored in archive form.  The following
discussion presents the conventions and rules for these file
labels.

The SAS label that identifies a unique file within the
archive contains two parts (part1.part2) where part1 names
the archive type and data set (e.g., DAYS) and part2 the
required File.  The SAS File Label must be associated with
applicable OS data set name storing the SAS File.

Therefore, a SAS file label that is used for the SAS SET
statement is defined as shown below, along with the required
DD statement to allocate the associated data set.

                                      PART1.PART2
                                    aaiiifff.iiifff
    Archive type definition__________| |  |   |  |
                                       |  |   |  |
                                       |  |   |  |
     Information Area level definition_|_ | __|  |
                                          |      |
             File level definition________|______|


    The JCL DD statement associated to File Label is:

    //aaiiifff  DD  DSN=prefix.MICS.type.aaiiifff(0),DISP=SHR
        where 'type' is either AUDIT,HISTW, or HISTM.

Archive Type Definition:  The archive type may include
AU for Audit, HW for Weekly History, and HM for Monthly
History.

Information Area:  The level names that may appear for
Information Area include ADM, TSO, HAR, SCP, and BAT, for
Administrative, TSO, Hardware Utilization, MVS SCP, and the
Batch Information Areas respectively.  See the individual
product guides for a full list of information areas.

File:  The names that may appear for Files are a function
of each Information Area.

The following reflects several examples of referencing a
specific SAS file in each of the archive versions:

Retrieve Batch User Job Activity from last week's archive
audit file:

    //AUBATJOB  DD  DSN=prefix.MICS.AUDIT.BATJOB(0),DISP=SHR

    SET AUBATJOB.BATJOB;

Retrieve CPU Processor Activity from the archive weekly
history archive file:

    //HWHARCPU  DD  DSN=prefix.MICS.HISTW.HARCPU(0),DISP=SHR

    SET HWHARCPU.HARCPU;

Retrieve TSO System Activity from the archive monthly
history archive file:

    //HMTSOTSO  DD  DSN=prefix.MICS.HISTM.TSOTSO(0),DISP=SHR

    SET HMTSOTSO.TSOTSO;

Note that the BAT_TS and BAT_ST files in the archive
monthly history must be referenced as BAT0TS and BAT0ST to
avoid a JCL error (underscore is an invalid character for
data set or DD names), with the underscore being replaced by
a zero.