Adding and Editing the Catalog Entry

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:
  • ASCII
  • EBCDIC
  • Unknown
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.