The <FILEDEF> and corresponding </FILEDEF> tags
identify the beginning and end of a file definition. Each file described
by a <FILEDEF> tag is input to GIMZIP and is to be a
component of the GIMZIP package. The following attributes may be
found on the <FILEDEF> tag:
- name="file name"
- specifies the name of a data set or file that is to be a component
of the GIMZIP package. The name attribute can specify
either a sequential, partitioned, or VSAM data set, or the absolute
pathname for a file or directory in the UNIX file system.
The first character of
the absolute pathname of a file or directory in the UNIX file system must be a slash (/). If the
name does not begin with a slash, GIMZIP processing will assume that
it is an MVS™ data set name and
that it will conform to the MVS data
set naming conventions. 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 contain any character from X'40' through X'FE',
except '<', '>', '&', and the 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 be converted to uppercase alphabetic
during GIMZIP processing. Data set names are not case sensitive and
will be converted to uppercase alphabetic during GIMZIP processing.
Note
the following facts:
- When a VSAM data set is being specified, the true cluster name
must be used. Do not reference a VSAM data set by a path name. Although
an alternate index may be defined to the cluster, the alternate index
does not become part of the archive. If an alternate index is desired
at the destination site after the archive is unzipped, then the alternate
index must be defined and built at the destination site.
- GIMZIP processing uses the z/OS® UNIX System Services pax command
for creating archive files. Although GIMZIP will attempt to process UNIX file and directory names of
up to 1023 bytes in length, this processing is subject to the limitations
of the pax command. See z/OS UNIX System Services Command Reference for
information about the pax command.
- archid="archive id"
- specifies a unique archive id value to be associated with the
archive file created for the data set, file, or directory identified
by the associated name attribute. The value of this
attribute will most likely be something like a ddname or the low level
qualifier of an MVS library
name or some generic specification for a file or directory in the UNIX file system.
The value can
be from 1 to 243 characters in length. The value can contain any character
from X'40' through X'FE', except '<', '>', '&',
'/' and the double quotation mark ("). The archid value
is case sensitive and will not be converted to uppercase alphabetic
by GIMZIP processing.
The same archid value
may not be used in more than one file definition group in the same
package.
- description="file description"
- specifies a text description for the file. The description can
be up to 500 characters long.
- subdir="subdirectory name"
- specifies the subdirectory in which to store the file specified
by the corresponding name attribute. The subdirectory name can be
from 1 to 500 bytes long with 255 characters between delimiters (/).
This
attribute can only be specified if the file type attribute is either
not specified or is README.
The subdirectory name is a relative
pathname for the desired subdirectory, so the first character of
the subdirectory name cannot be a slash (/). However, the subdirectory
name may be specified with or without an ending slash.
"SMP",
all capitalized, cannot be specified as the first three characters
of the subdir attribute value. Other case variations are allowed.
- 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:
- README
- indicates that the associated file is a sequential text data set
or a file in the UNIX file system
that is intended to be viewable text after it is placed in the package.
These files are not placed in archives by GIMZIP and are not compressed.
They are only copied into the package by GIMZIP. The file name specified
on the associated name attribute must identify a
file in the UNIX file
system or a sequential data set that does not have a record format
of VS (variable spanned).
- SMPHOLD
- indicates that the associated data set or file contains SMP/E
HOLDDATA statements. These files are placed in archives by GIMZIP
and compressed. The name specified on the associated name attribute
must identify a sequential data set with a logical record length of
eighty (80) bytes and a record format of FB (fixed block), or it must
identify a file in the UNIX file
system.
- SMPPTFIN
- indicates that the associated data set or file contains SMP/E
modification control statements (MCS). These files are placed in archives
by GIMZIP and compressed. The name specified on the associated name
attribute must identify a sequential data set with a logical record
length of eighty (80) bytes and a record format of FB (fixed block),
or it must identify a file in the UNIX file
system.
- SMPRELF
- indicates the data set specified on the name attribute
is an SMP/E RELFILE data set associated with a SYSMOD contained in
the SMPPTFIN file. Data sets with the SMPRELF file type must be either
a partitioned data set or an IEBCOPY unloaded sequential image of
a partitioned data set. These data sets are placed in archives by
GIMZIP and compressed.
The type attribute must not be
specified when a VSAM data set or a UNIX file system directory is specified on the name attribute.
If the type attribute is not specified, then the data set
specified on the name attribute can be either a sequential,
partitioned, or VSAM data set, or a file or directory in the UNIX file system.
- volume="file volume"
- specifies the volume serial number of the volume containing the
data set specified on the name attribute. The volume
identifier must be from 1 to 6 alphanumeric characters and should
be specified only if the name attribute identifies an uncataloged
data set.
If the associated name attribute identifies a
file or directory in the UNIX file
system (the name begins with a slash), the volume attribute will be
checked for syntax, but it will be ignored otherwise.
Note: The volume
is used to allocate data sets. However, VSAM data sets must be catalogued.
Information needed for the archival of VSAM data sets is gathered
from the catalog and related areas, such as the VVDS - VSAM volume
data set.