End of support This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Tape data set filtering


Select Tape Data Set Filtering to advance to the data entry panel that enables you to:

  • Specify any or all of the parameters described in the following table by using the tape filtering dialogs

    Use the OP fields to set comparison operators for the values that you enter. Most non-numeric or single entry fields allow masking and stacking (multiple entries) of values separated by a comma. Some fields have two sets of OP and value entry fields. These fields allow for exclusions and ranges.

  • Use the SVOSPARM member containing FLST parameters described in the FLST parameters in SVOSPARM member SMFT31xx that can be used to filter data for the Tape management Data Set Details by DSN view (TDSDD) in conjunction with parameters in the tape data set filtering dialog or on its own.

Note

The first DSN entry field in the dialog has a continuation line. You must completely fill the first line before using the next line because the two lines are treated as one contiguous string.

Tape data set filtering parameters

Parameter

Description

Masking allowed

Multiple entries

Application Name

Filters on Application Name or mask

+

+

DSN

Filters on the data set name or mask (MYDSN or MYDSN/) or list (MYDSN/,MYDSN2/...)

+

+

Volume

Filters on the name of the volume or volume list (vol123,vol2/,vol/)

+

+

Location

Filters on the tape data set location as determined by the Tape Management Software

+

+

ATL Library

Filters on the name of an Automated Tape Library (ATL)

+

+

VTS Library

Filters on the name of a Virtual Tape System (VTS) library

+

+

Expiration Date Type

Filters on the expiration date type to select

Valid values are:

  • D Expiration date
  • J Expiration date from JCL
  • CA-1 Tape Management Software
    • K CA-1 EXPDT keyword (see list below)
  • Control-T Tape Management Software
    • C Number of cycles
    • E Controlled by EDM
    • I Number of days in vault
    • L Days since last reference
    • M Controlled by the MVS catalog
    • P Permanent
    • S Controlled by the SMS class
    • V Controlled by the vault

The following CA-1 EXPDT values are available with EXPTYPE=K:

  • 88 uuu User-defined tape not under TMS control
  • 90 ddd Tape will be retained for ddd days and then pass to MVS control
  • 98000 Nonresident tape not under TMS control
  • 98 ddd Days since last reference
  • 99000 Controlled by the MVS catalog
  • 99366 Permanent
  • 99 ccc Number of cycles

+

 

Stacked

Filters on whether a tape data set with a file sequence number of 2 or more is selected

Valid values are:

Y - Yes

N - No

 

 

Cataloged

Filters on whether a cataloged tape data set is selected

Valid values are:

Y - Yes

N - No

 

 

Multi-Volume

Filters on whether a tape data set with a volume sequence number of 2 or more is selected

Valid values are:

Y - Yes

N - No

 

 

In ATL Library

Filters on whether a tape data set in a Automated Tape Library (ATL) is selected

Valid values are:

Y - Yes

N - No

 

 

In VTS Library

Filters on whether a tape data set in a Virtual Tape System (VTS) is selected

Valid values are:

Y - Yes

N - No

 

 

Allocation Size

Filters on the allocation size of the data set in KBs

 

 

Last Read Date

Filters on the last read date of the data set in yyyymmdd format

 

 

Last Write Date

Filters on the last write date of the data set in yyyymmdd format

 

 

Last Referenced Date

Filters on the last referenced date of the data set in yyyymmdd format

 

 

Expiration Date (EXPDT)

Filters on the expiration date for the data set in yyyymmdd format

 

 

Expiration Type Number

Filters on the numerical value in the expiration date field of a tape data set in nnnnn format

Valid values are 0-99999.

 

 

Days Since Last Read

Filters on the number of days since the data set was last read

The system calculates this number by subtracting the last read date from the tape scan date.

Valid values are 0-99999.

 

 

Days Since Last Write

Filters on the number of days since the data set was last written

The system calculates this number by subtracting the last write date from the tape scan date.

Valid values are 0-99999.

 

 

Days Since Last Referenced

Filters on the number days since the data set was referenced

Valid values are 0-99999.

 

 

Adjusted Days Since Last Read

Filters on the calendar-adjusted number of work days since the data set was last read

The system calculates this number by subtracting the calendar-adjusted last read date from the tape scan date.

Valid values are 0-99999.

 

 

Adjusted Days Since Last Write

Filters on the calendar-adjusted number of work days since the data set was last written

The system calculates this number by subtracting the calendar-adjusted last write date from the tape scan date.

Valid values are 0-99999.

 

 

Adjusted Days Since Last Referenced

Filters on the number of days since the data set was referenced

Valid values are 0-99999.

 

 

SMFT31 Member Name

Contains FLST statements to be used in addition to the dialog parameters

For more information, see FLST-filtering-for-views.

 

 

SMS Management Class

Filters on SMS Management Class Name or mask

+

+

SMS Storage Class

Filters on SMS Storage Class Name or mask

+

+

FLST parameters in SVOSPARM member SMFT31xx that can be used to filter data for the Tape management Data Set Details by DSN view (TDSDD)

FLST Parameter

Short Description

DSN | DSNAME

Data set name

DSN1 | HLQ

Node 1 | High-level qualifier

DSN2

Node 2

DSN3

Node 3

DSN4

Node 4

DSN5

Node 5

DSN6

Node 6

DSN7

Node 7

DSN8

Node 8

LLQ

Low-level qualifier

VOL | VOLSER

Volume serial number

BLKSIZE

Block size

SIZE

Allocation size in K

LREF

Last referenced date

REFAGE

Days since last referenced

CALAGE

Calendar adjusted days since last referenced

CREATEDATE

Creation date

CREATEDAGE

Days since creation

CREATEDCAGE

Calendar adjusted days since creation

LREADDATE

Last read date

LREADAGE

Days since last read

LREADCAGE

Calendar adjusted days since last read

LWRITEDATE

Last write date

LWRITEAGE

Days since last write

LWRITECAGE

Calendar adjusted days since last write

NUMBLKS

Block count

CATLGTDS

Cataloged tape data sets

STACKDS

Stacked data sets

MULTIVOL_DS

Multi-volume data sets

IN_ATL_LIB

In ATL Library

IN_VTS_LIB

In VTS Library

ATL_LIBNAME

ATL Library name

VTS_LIBNAME

VTS Library name

TAPELOC

Tape location

EXPTYPE

Expiration type

TAPE_EXPDT

Expiration date (YYYY/MM/DD)

EXPTYPENUM

Expiration type number (nnnnn)

APPL

Application name

SMSGROUP

SMS storage group

MGMTCLAS

Management class



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*