Previous Topic: ALTER Statement (VSAM)

Next Topic: ALTER Statement (Physical Sequential)


ADD Statement (Physical Sequential)

The ADD statement for Physical Sequential defines a physical sequential data set or pattern to CA Compress, indicating that the individual data set or data sets matching the pattern should be compressed using the attributes specified.

ADD{PSDSN=datasetname}|{PSPATTERN=patternname}
{,SUPEREXP|FDT=fdtname,[STANDARD]DICTIONARY=dictionary}
{,DCBMODEL=datasetname}|{,RECFM=recfm,LRECL=lrecl,BLKSIZE=blksize}
{,RECFM=recfm,LRECL=lrecl,BLKSIZE=blksize}
{,EFFDATE=yyddd}|{ANYDATE}
 [,GDG=YES|NO|ONLY]
 [,SDB=YES|NO]
 [,ERASEUNCAT=YES|NO]
 [,EXCLUDE]
 [,NON-COMP=#]
 [,SCOPE=CICS|ALL]
 [,DEVTYPE=TAPE|DA|ALL]
 [,UEXIT=YES|NO]
PSDSN=data-setname

Specifies a physical sequential data set which is to be compressed.

PSPATTERN=patternname

Specifies a data set name pattern which selects data sets for compression. The pattern can contain any character that is valid in a data set name along with the special characters ?, !, and /. These special characters are defined in the section Syntax Rules in this chapter.

SUPEREXP|FDT=fdtname[,STANDARD]|DICTIONARY=dictionary

Selects the type of compression desired for the data set or pattern being defined.

The optional parameter STANDARD can be specified only in conjunction with the FDT=fdtname parameter. It informs CA Compress that the FDT specified should provide the compression or expansion tables only, and that the RDL specified in the FDT should be ignored. The STANDARD parameter allows one FDT to be used for a number of data sets that can share character distribution characteristics but not different noncompressible area. STANDARD is implied if the FDT parameter specifies a name of the form STDTBLxx where xx is a numeric value from 01 thru 06. The DICTIONARY parameter can specify a CA-supplied IBM Hardware Compression dictionary of the form HC#STDxx (where xx is numeric 01 to 05).

SUPEREXP specifies the low-overhead compression algorithm called Super Express.

DCBMODEL=data-setname/RECFM=recfm/LRECL=lrecl/BLKSIZE=blksize

These parameters supply the DCB attributes of the uncompressed data. These values must be kept in the Control File because they are unavailable elsewhere.

DCBMODEL specifies a cataloged data set from which to extract RECFM, LRECL, and BLKSIZE attributes. It can be the data set being compressed, or any other PS or PO disk data set, unless it is compressed but not implemented.

RECFM, LRECL, and BLKSIZE supply each individual attribute. They can be combined with DCBMODEL, in which case any individual attribute coded overrides the value implied by DCBMODEL.

For PS Patterns, these parameters are optional. DCB attributes in PS Pattern records serve only to supply defaults to matching PS Dsname records as they are created.

For PS Dsname records, these parameters are individually optional, but some combination must provide a valid RECFM, LRECL, and BLKSIZE for the data set. A consistency check is performed. If any are missing, or if in combination they are invalid, or if DCBMODEL specifies a data set which is compressed but not implemented in the Control File, the statement is rejected. For these values to be correct is vital.

EFFDATE=yyddd/ANYDATE

These parameters are optional and mutually exclusive.

EFFDATE specifies the Julian date that compression is to be implemented on the data set. When the date becomes current or past, the data set is compressed the next time it is created or replaced.

ANYDATE specifies that the data set should be considered compressed already. If it is opened for output, compressed data is written, and if it is read, each record is expanded. ANYDATE should be specified when you are implementing a data set already compressed in an earlier release of CA Compress using the SUBSYS JCL parameter; otherwise CA Compress assumes that the data is still uncompressed until the data set is recreated, and applications receive compressed data.

GDG=YES|NO|ONLY

Specifies whether pattern matches should be recognized for all data sets including GDGs (GDG=YES), excluding GDGs (GDG=NO), or only for GDGs (GDG=ONLY). The default is GDG=YES.

SDB=YES|NO

Specifies whether compressed data set BLKSIZE should be calculated by the IBM System Determined Blocksize (SDB) facility or set to the uncompressed data set BLKSIZE. SDB=YES gives better compression and I/O performance, but may cause I/O errors if a smaller BLKSIZE is coded on JCL which reads the compressed data set without CA Compress. The input BLKSIZE should never be coded except when using SUBSYS to invoke CA Compress, but until such JCL is corrected, SDB=NO will make it work correctly. The default is YES unless NOSDB is specified in the CA Compress started task JCL.

ERASEUNCAT=YES|NO

Specifies whether the entry should be purged from the Control File when the data set is uncataloged. This is an optional parameter and interacts with the GDG parameter. The default is YES for GDG=ONLY and NO for GDG=YES and GDG=NO.

EXCLUDE

Specifies that the data set is excluded from compression.

NON-COMP=#

Specifies a noncompressible area at the beginning of each record for other than custom Huffman or Tailored RDL methods. This parameter is especially helpful for setting aside noncompressible bytes to enable record selection or other processing on the data set without having to expand and compress records.

SCOPE=CICS|ALL

Specifies whether data set should be considered defined as compressed only under CICS (SCOPE=CICS) or always (SCOPE=ALL). This parameter is primarily intended as a conversion aid. The default is SCOPE=ALL.

DEVTYPE=TAPE|DA|ALL

Specifies whether data set should be considered defined as compressed only if on tape (DEVTYPE=TAPE), on direct access (DEVTYPE=DA), or anywhere. The default is DEVTYPE=ALL.

UEXIT=YES|NO

Specifies whether the Transparency User Exit is to be invoked during compression and expansion of each record. The default is NO.