Utilities › TMSIDATA Utility—Build a TMC from VSAM or Operating System Catalog Listing › SYSIN Control Parameters

SYSIN Control Parameters

The SYSIN control parameters for TMSIDATA are used to dynamically define and allocate two VSAM work data sets, VWORK1 (the ddname for Volume records) and VWORK2 (the ddname for DSNB records). VWORK1 and VWORK2 are used to properly chain Volume and DSNB records.

Note: At the beginning of the TMSIDATA process, IDCAMS DELETE commands are issued for these data sets to prevent the possible duplication of data set names. However, VWORK1 and VWORK2 are left intact at the end of processing. You can manually delete these VSAM data sets or use them for further analysis. The record layouts for VWORK1 and VWORK2 are listed under the control parameter definitions for WKVOL1 and WKVOL2.

Each control parameter specification must begin with a keyword in position 1. A given parameter must be entirely contained on one statement; no continuations are allowed. As many parameter statements as necessary may be coded. The maximum length of data on a SYSIN statement is 79 positions followed by a blank.

The SYSIN control parameters can be coded using either format listed below:

  1
  NUMVOL=nnnnnn
  NUMDSN=nnnnnnn
  WKVOL1=xxxxxx
  WKVOL2=xxxxxx
  INDXVOL=xxxxxx
  WKNODE=xxxxxx
 [EXPDT={keyword|preferred date|Julian date}]

Or

  1
  NUMVOL=nnnnnn,NUMDSN=nnnnnnn,WKVOL1=xxxxxx,WKVOL2=xxxxxx,INDXVOL=xxxxxx
  WKNODE=xxxxxx,[EXPDT={keyword|preferred date|Julian date}]

Control Parameter Definitions

NUMVOL=nnnnnn

Specifies the anticipated number of Volume records to be processed by TMSIDATA, where nnnnnn is an integer that can have a maximum value of 999999. This number is used to properly size the VSAM work data set (VWORK1) for Volume records. Secondary extents are calculated at 10 percent of the NUMVOL value. Generally, VSAM can extend a keyed sequential data set up to 127 times, depending on the DASD space available. This parameter is required.

NUMDSN=nnnnnnn

Specifies the anticipated number of DSNB records to be processed by TMSIDATA, where nnnnnnn is an integer that can have a maximum value of 2500000. This number is used to properly size the VSAM work data set (VWORK2) for DSNB records. Secondary extents are calculated at 10 percent of the NUMDSN value. Generally, VSAM can extend a keyed sequential data set up to 127 times, depending on the DASD space available. This parameter is required.

WKVOL1=xxxxxx

Specifies the DASD volume on which to allocate the VSAM work data set (VWORK1) for Volume records, where xxxxxx is a one- to six-character alphanumeric value. This parameter is required.

The record layout for VWORK1 is:

V1AREA   DS 0CL97 
V1KEY    DS 0CL6 VSAM key field
V1VOLSER DS CL6 volume serial number
V1VOLSEQ DS XL2 volume sequence number
V1DSN    DS CL44 data set name
V1DSN17  DS CL17 last 17 characters of data set name
V1CREATE DS PL4 data set creation date
V1EXPIRE DS PL4 expiration date
V1FIRST  DS CL6 first volume pointer
V1PREV   DS CL6 previous volume pointer
V1NEXT   DS CL6 next volume pointer
V1DEN    DS XL1 density
V1TRTCH  DS XL1 recording technique

WKVOL2=xxxxxx

Specifies the DASD volume on which to allocate the VSAM work data set (VWORK2) for DSNB records, where xxxxxx is a one- to six-character alphanumeric value. For best performance, the two VSAM work data sets should be on separate volumes. This parameter is required. The record layout for VWORK2 is:

V2AREA   DS 0CL72 
V2KEY    DS 0CL8 VSAM key field
V2LSTVOL DS CL6 last volume that data set resides on
V2FILSEQ DS XL2 file sequence number of data set
V2DSN    DS CL44 data set name
V2MOTHER DS CL6 DSNB mother volume serial
V21STVOL DS CL6 DSNB first volume pointer
V2CREATE DS PL4 creation date
V2EXPIRE DS PL4 expiration date

TMSIDATA will not delete the two VSAM work data sets when the process finishes. These record layouts are provided so that you can, if desired, report on or analyze the data sets. In the event of a rerun, however, a DELETE is issued at the beginning of the process.

INDXVOL=xxxxxx

Specifies the DASD volume on which to allocate the VSAM indexes for the VWORK1 and VWORK2 VSAM data sets, where xxxxxx is a one- to six-character alphanumeric value. For best performance, this volume should be different from both VWORK1 and VWORK2. This parameter is required.

WKNODE=xxxxxx

Specifies a high-level qualifier(s) for naming the VWORK1 and VWORK2 VSAM data sets so that they comply with your site-specific naming conventions. The value of xxxxxx can be a maximum of 17-bytes, and no period is allowed at the end of this parameter. TMSIDATA appends an appropriate suffix to the WKNODE to complete the data set name, as illustrated in the following examples.

xxxxxx.CA1.IDATA.DSNCLUST
xxxxxx.CA1.IDATA.VOLCLUST

This parameter must follow standard MVS data set naming conventions and is required.

EXPDT={keyword|preferred date|Julian date}

Specifies a default expiration date for the Volume records to be created. This value can be a CA 1 keyword, an actual date in your preferred date pattern, or a date in Julian format (yyyy/ddd). If this parameter is omitted, TMSIDATA uses CATALOG as the default expiration date. This parameter is optional.