<FILEATTR> Tag syntax

The <FILEATTR> and corresponding </FILEATTR> tags identify the beginning and end of a file attribute definition for an archive file. The following attributes may be found on the <FILEATTR> tag:

name="file name | pathname"
specifies one of the following:
  • The name of the original MVS™ data set or VSAM cluster in this archive
  • The pathname for the original UNIX file or directory in this archive
Note:
  1. The first character of the absolute pathname of a file or directory in the UNIX file system must be a slash (/).
  2. If the value of the name attribute does not begin with a slash, it is assumed to be an MVS data set name (sequential, partitioned, and VSAM data sets) and must conform to the MVS data set naming conventions.
  3. When a file or directory in the UNIX file system is specified, the name can be from 1 to 1023 bytes long with 255 characters between delimiters (/). The value can be any character from X'40' through X'FE' except '<', '>', '&', and double quotation mark ("). All data beyond column 72 is ignored, including blanks. The pathname of a file or directory in the UNIX file system is case sensitive and will not to be converted to uppercase alphabetic during GIMUNZIP processing. (Data set names are not case sensitive. They will be converted to uppercase alphabetic during GIMUNZIP processing.)
description="file description"
specifies a text description for the file. The value GIMZIP produces is copied from the description value, if specified, on the corresponding input <FILEDEF> tag. The description can be up to 500 characters long.
type="file type"
specifies a file type indicator that describes the contents of the file, identifies how the file is to be processed by GIMZIP, and also how the file will be processed by the SMP/E RECEIVE command. Any of the following values may be specified:
SMPHOLD
indicates that the data set or file contains SMP/E HOLDDATA statements.
SMPPTFIN
indicates that the data set or file contains SMP/E modification control statements (MCS).
SMPRELF
indicates that the data set contains an SMP/E RELFILE data set associated with a SYSMOD contained in the SMPPTFIN file.
If the type attribute is not specified, then the data set specified on the name attribute can be either sequential or partitioned.
level="vv.rr.mm.pp"
indicates the service level of the GIMZIP service routine used to create this file attribute file. The individual values are as follows:
vv
version
rr
release
mm
modification level
pp
PTF level
dsntype="type"
specifies the type of partitioned data set, VSAM cluster, or UNIX file or directory for the original data.
DIR
indicates a directory in the UNIX file system.
FILE
indicates a file in the UNIX file system.
ESDS
indicates a VSAM cluster that is an entry sequence data set.
KSDS
indicates a VSAM cluster that is a keyed sequence data set.
LDS
indicates a VSAM cluster that is a linear data set.
RRDS
indicates a VSAM cluster that is a relative record data set.
LIBRARY
indicates a PDSE partitioned data set.
PDS
indicates a PDS partitioned data set.
dsorg="organization"
specifies the organization of the original data set, file, or directory.
PO
indicates a partitioned data set
PS
indicates a sequential data set
UFS
indicates a file or directory in the UNIX file system
VSAM
indicates a VSAM cluster
recfm="format"
specifies:
  • When dsorg="PS" or dsorg="PO", the record format of the sequential or partitioned MVS data set in an archive
  • When dsorg="VSAM", the record format of the data set used to contain the REPROed VSAM data
The value can be from 1 to 3 alphabetic characters.
lrecl="length"
specifies the logical record length of the original data set. The value can be from 1 to 5 decimal digits.
lreclu="length"
specifies:
  • When dsorg="PO", the logical record length of the IEBCOPY unloaded format of the original data set
  • When dsorg="VSAM", the logical record length of the data set used to contain the REPROed VSAM data from the cluster
In either case, the value can be from 1 to 5 decimal digits.
blksize="size"
specifies the block size of the original data set. The value can be from 1 to 5 decimal digits in the range of 00000 through 32760.
blksizeu="size"
specifies:
  • When dsorg="PO", the block size of the IEBCOPY unloaded format of the original data set
  • When dsorg="VSAM", the block size of the data set used to contain the REPROed VSAM data from the cluster
In either case, the value can be from 1 to 5 decimal digits in the range of 00000 through 32760.
primary="prispace"
specifies:
  • When dsorg="PS" or dsorg="PO", the primary space needed to reload the sequential or partitioned MVS data set in an archive
  • When dsorg="VSAM", the primary space needed to create a temporary data set to contain the REPROed VSAM data
The value must be non-zero and can be from 1 to 8 decimal digits.
secondary="secspace"
specifies:
  • When dsorg="PS" or dsorg="PO", the secondary space needed to reload the sequential or partitioned MVS data set in an archive
  • When dsorg="VSAM", the secondary space needed to create a temporary data set to contain the REPROed VSAM data
The value must be non-zero and can be from 1 to 8 decimal digits.
dirblocks="blocks"
specifies the number of directory blocks in the original data set. The value must be non-zero and can be from 1 to 5 decimal digits.
allocunits="units"
specifies:
  • When dsorg="PS" or dsorg="PO", the units to be used when allocating the data set used to reload the sequential or partitioned MVS data set in an archive
  • When dsorg="VSAM", the units to be used to create a temporary data set to contain the REPROed VSAM data
The value can be one of the following:
BLOCK
indicates space is to be allocated in blocks. The size of the blocks is specified on the length attribute.
CYLINDER
indicates space is to be allocated in cylinders.
RECORD
indicates space is to be allocated in records. The average length of these records is specified on the length attribute.
TRACK
indicates space is to be allocated in tracks.
length="average record length | block length"
specifies either the block length, or the average record length, used to allocate the primary and secondary space for reloading the data from the archive. If allocunits="BLOCK" is specified, then this value represents the block length. If allocunits="RECORD" is specified, then this value represents the average record length. The value of the length attribute must be from 1 to 5 decimal digits and must be non-zero.
avgrec="multiplier"
indicates the multiplier for the primary and secondary space allocation values only when allocunits="RECORD".
U
indicates that the primary and secondary space quantities represent the number of records in units (multiplier of 1).
K
indicates that the primary and secondary space quantities represent the number of records in thousands (multiplier of 1024 or 1K).
M
indicates that the primary and secondary space quantities represent the number of records in millions (multiplier of 1048576 or 1M).
  • When dsorg="PS" or dsorg="PO", this value represents the multiplier to be used for allocating the sequential or partitioned data set in an archive.
  • When dsorg="VSAM", this value represents the multiplier to be used for allocating the temporary data set to contain the REPROed VSAM data.
Start of changeempty="Y | N"End of change
Start of changeindicates whether the original data set was empty. When the value is 'Y', the original data set was empty. When the value is 'N', or if the empty attribute is not specified, the original data set was not empty. If an original data set is empty, it is not included in the resulting archive file. Only its File Attribute File is included in the archive file.End of change
Parent topic: File attribute file