Use this page to when adding or modifying an entry to the catalog or cataloged data set.
To rename a data set in a catalog, click
Rename. This open the
Rename Catalog Entry dialog box. In the
New Name field, type the new name for the catalog data sets and then click
Rename.
Note: When a data set is renamed, the underlying physical file is also renamed, as long as it is stored within a directory under
the one in which the catalog file is stored. To enable a physical file stored outside of the catalog subdirectories to be
renamed, set the environment variable MF_PCRENAME_LAX=Y. This enables the filename to be changed, but the location remains
the same. For allocation overrides to take effect, which might include changing the directory the file is stored in, set MF_PCRENAME_LAX=D.
See
JCL-specific environment variables for more information.
- Catalog
- Check this if you want the file to be included in the catalog. By default, this is checked.
- DS Name
- Specify the data set name of the file, in mainframe format. If you are viewing an entry, it displays the data set name of
the file, in mainframe format.
- Physical File
- If you are adding an entry, specify the filename of the physical file held on your machine, in the format of your local operating
system. If you are viewing an entry, shows the filename of the file, in the format of your local operating system.
- DS Org
- The data set organization can be one of the following:
- GDG
- Generation Data Group
- IS
- Indexed Sequential
- PO
- Partitioned
- PS
- Physical Sequential
- VSAM
- Virtual Storage Access Method
- UNKNOWN
-
Note: Depending on the value selected additional fields might be displayed. See below for more information.
- Codeset
- Specify the codeset in which you want the contents to be stored as. This field defaults to ASCII:
- LRECL
- The record length in bytes for fixed-length records, or the maximum record length for variable-length records, including the
4-byte record header.
- BLKSIZE
- The length of a block in bytes.
- RECFM
- The record format of the data set. For all data set organizations except VSAM can be one of the following:
- F
- Fixed format with no control characters and no record delimiters.
- FA
- Fixed format with ANSI control characters and no record delimiters.
- FB
- Fixed blocked format with no control characters and no record delimiters.
- FBA
- Fixed blocked format with ANSI control characters and no record delimiters.
- FBM
- Fixed blocked format with machine control characters and no record delimiters.
- FBS
- Fixed blocked spanned format with no control characters and no record delimiters.
- FM
- Fixed format with machine control characters and no record delimiters.
- FS
- Fixed spanned format with no control characters and no record delimiters.
- LSEQ
- Line sequential format with no control characters and carriage return and line feed as record delimiters.
- U
- Undefined format. Results can be unpredictable on Windows and UNIX.
- V
- Variable format with no control characters and
Micro Focus type record delimiters.
- VA
- Variable format with ANSI control characters and
Micro Focus type record delimiters.
- VB
- Variable blocked format with no control characters and
Micro Focus type record delimiters.
- VBA
- Variable blocked format with ANSI control characters and
Micro Focus type record delimiters.
- VBM
- Variable blocked format with machine control characters and
Micro Focus type record delimiters.
- VBS
- Variable blocked spanned format with no control characters and
Micro Focus type record delimiters.
- VM
- Variable format with machine control characters and
Micro Focus type record delimiters.
- VS
- Variable spanned format with no control characters and
Micro Focus type record delimiters.
If VSAM data set organization has been selected then the following options are available:
- ES
- Entry Sequence
- KS
- Key Sequence
- LS
- Linear Sequence
- RR
- Relative Record
- Created
- The date and time the file was created.
- Last Referenced
- The date and time the file was last used in a job.
- Expiration Date
- The expiration date of the catalog entry. Takes the format YYYY/DDD where YYYY is the year and DDD is the day or the year,
where January 1st is 001 and December 31st is 365 or 366 for a leap year.
- MGMTCLASS
- The management class for an SMS-managed data set.
- File Size
- The size of the catalog entry file in bytes.
Additional GDG Fields
If you specify
GDG in the
DS Org field, then the following additional fields will be displayed:
- GDG Max
- This is the maximum number of Generation Data Sets (GDS) in the Generation Data Group (GDG).
The minimum value is 1 and the maximum value supported is 255.
- Roll Disp
-
The following options are available:
- No Scratch and No Empty
- If the data set is a non-SMS managed then the data set is not removed from any volumes it occupies. If the data set is an
SMS-managed data set then it is recataloged as a non-VSAM data set in rolled-off status, and is no longer associated with
the GDG base.
In addition, only the oldest GDS entry are removed when a new GDS is created that causes GDG LIMIT to be exceeded.
- Scratch and No Empty
- The GDS is deleted from all disks it occupies when uncataloged from the GDG base.
In addition, only the oldest GDS entry are removed when a new GDS is created that causes GDG LIMIT to be exceeded.
- Scratch and Empty
- The GDS is deleted from all disks it occupies when uncataloged from the GDG base.
In addition, all GDS entries are removed from GDG base when a new GDS is created that causes the GDG LIMIT to be exceeded.
- No Scratch and Empty
- If the data set is a non-SMS managed then the data set is not removed from any volumes it occupies. If the data set is an
SMS-managed data set then it is recataloged as a non-VSAM data set in rolled-off status, and is no longer associated with
the GDG base.
In addition, all GDS entries are removed from GDG base when a new GDS is created that causes the GDG LIMIT to be exceeded.
Additional PO Fields
If you specify
PO in the
DS Org field, then the following additional fields will be displayed:
- Dynamic PDS
- Check this field to enable a dynamic Partitioned Data Set (PDS) which will require you to specify the
Physical File and
PDS Exts fields.
Note: In this case, the
Physical File field will point to a folder, not a file.
- PDS Exts
- Specifies the files to include by typing in a list of one or more filename extensions separated by spaces or commas. Alternatively,
to include all files regardless of the filename extension and to also include files that have no filename extension at all,
specify
* (asterisk).
Additional VSAM Fields
If you specify
VSAM in the
DS Org field, then the following additional fields will be displayed:
- VSAM Type
-
The following options are available:
- Cluster
- Index
- Data
- Alternate Index
- Path
- DSCB Model
- VSAM Attr
- Indicates if the key/index is unique or if duplicates exist.
- Key Start
- Indicates the position in the record the key starts, in bytes.
- Key Length
- Indicates the length of the key, in bytes.
- Record Maximum Length
- Indicates the maximum record length, in bytes.
- Record Average Length
- Indicates the average record length, in bytes.
- Cross Region
- Valid values are 0, 1, 2, 3 or 4. A value of 0 (zero) means that SHAREOPTIONS are not applied to the DSN. See
SHAREOPTIONS for more information.
- Cross System
- Valid values are 0, 3 or 4. Any value set is read and stored in the catalog and in the data file, which can be included when
sending a job step to the mainframe for processing.