- Notes, cautions, and warnings
- About this document
- Introduction to SnapVX
- Getting started with SnapVX
- SnapVX configuration
- TimeFinder SnapVX configuration layers
- Editing the EMCSNAPO macro
- EMCSNAPO site options
- ACTIVATE_SUBTASK#
- ALLOW_FBA_META
- ALLOW_LIGHTNING_DEVICE
- ALLOWZDP
- AUTOACTIVATE
- AUTOCREATE
- AUTOUNLINK
- BACKGRND
- CACHESYM
- CHECKBCV
- CHKONLIN
- CHKSNSZ
- CONDVOL
- CONSIST
- COPYVOL
- DEBUG_ERROR
- DEBUG_SDUMP
- DISPCUU
- EMUL_TYPE
- FREEUNLK
- GROUP_DSNAME
- MESSAGE
- REFVTOC
- REPLACE
- RESTORE_CREATE
- SECURE
- SECURE_QUERY
- SHOWDEF
- SNAPSHOT_LIST
- SNAPSHOT_NAME
- SOFTLINK
- SOFTRESTORE
- SRDFAR1
- SRDFSR1
- SRDFA_RETRY
- SRPPERCT
- SRPMSGLVL
- TERM_ALL
- TIMEOUT
- VARYOFF
- VARYON
- VCLOSE
- UNLNKAFT
- WFDEF
- SnapVX operations
- SnapVX command reference
- SnapVX commands
- SnapVX common parameters
- ACTIVATE_SUBTASK#
- ALLOW_FBA_META
- ALLOW_LIGHTNING_DEVICE
- AUTO_CREATE
- AUTOMATIC_ACTivate
- AUTO_UNLink
- BACKGROUNDCOPY
- CACHE_FULL_SYM
- CcUU
- CHECKBCVHoldstatus
- CHECKONLINEpathstatus
- CHECK_SNAPSHOT_SIZE
- COMPACT_query
- CONDitionVOLume
- CONSISTENT
- COPYVolid
- DEBUG
- DEVice
- DISPLAY_CUU
- EMUL_TYPE
- EXPIration
- FREE
- GROUP
- GROUP_DATaset_name
- LIST
- LOCAL
- MAXRC
- MESsages
- MODE
- MULTI_LINE_query
- NAME
- NEWVOLID
- POSTSNAP
- PRESNAP
- R1_TARGET_POST_WAIT
- R1_TARGET_PRE_WAIT
- READY
- REFVTOC
- RELEASE
- REMOTE
- REPLace
- REStore_create
- REStore_CREate_NAME
- SCFGroup
- SECure
- SECURE_Query
- SHOW_Tracks_to_be_defined
- SNAPSHOT_LIST
- SOFTlink
- SOFTRestore
- SOUrce
- SRDFA_CONSISTENT_RETRY
- SRDFA_R1_target
- SRDFS_R1_target
- SRP_PERCENT
- TaRGet
- TERMinate_ALL
- TIMEOUT
- TYPRUN
- UNLINK_After_copy
- VARY_OFFline
- VARY_ONline
- VCLOSE
- VOLume
- UNIT
- WAIT_FOR_Definition
- ZDP
- ACTIVATE
- CONFIG
- CREATE
- FREE
- GLOBAL
- LINK
- QUERY FREE
- QUERY GLOBAL
- QUERY SNAPSHOT
- RENAME
- TERMINATE
- UNLINK
- SnapVX common parameters
- Grouping commands
- SnapVX commands
- Migration to SnapVX
- Introduction to zDP
- zDP features and concepts
- zDP Definition Utility
- Overview
- Running zDP Definition Utility
- Summary of operations
- Command reference
- Common parameters
- ALLOW_LARGER_TARGET
- ALLOWNonEmpty
- CCUU | SYMDEV | RDFGroup | SCFG
- CONSistent
- COPY_ONCE
- COPY_ONCE({INCLUDE|ONLY})
- CYCLE_OVERFLOW
- CYCLE_TIME
- Date and WTOR
- DEBUG
- DYNAMIC_CHANGE
- EXPiration
- EXPortDEF
- FREE
- LOG_OPT
- MAX_RC
- MAX_RUNTIME_RC
- MAX_SNAPSETS
- MAX_TGT
- MAX_VDG
- MODE
- NORUN
- NOSORT
- PERSISTENT_COPY_LIMIT
- READY
- RDP_CACHE_UTIL%
- RMT
- SAVE
- SAVED_SNAPSETS
- SIMulate_TERMinate
- SMF
- SNAPSET
- SRP_SNAP%
- SRP_TERM%
- SRP_WARN%
- STOP_FREE
- SYMCTL
- TERMinate_POLICY
- TGT
- TIMEOUT
- VDG
- WAIT_FOR_Definition
- WTOR_TERMinate
- DEFINE TGT
- DEFINE VDG
- DELETE TGT
- DELETE VDG
- DELEXP
- EXPORT
- GLOBAL
- IMPORT
- LINK VDG
- LISTEXP
- MODIFY TGT ADD|REMOVE
- MODIFY TGT READY
- MODIFY VDG ADD|REMOVE
- MODIFY VDG OPTIONS
- PERSISTENT
- QUERY FREE
- QUERY GLOBAL
- QUERY TGT
- QUERY VDG
- RESTORE VDG
- SECURE VDG
- STOP_FREE TGT
- TERMINATE VDG
- UNLINK TGT
- UNLINK VDG
- Common parameters
- zDP ISPF interface
- Introduction
- Logging in to zDP
- Logging out of zDP
- Accessing zDP ISPF tools
- Setting session options and GLOBAL parameters
- Accessing zDP ISPF help
- Monitoring and managing VDGs
- Managing VDG members
- Managing exported VDG definitions
- Managing target sets
- Managing target set members
- Managing exported target set definitions
- Managing snapsets
- zDP SMF records
Mainframe Enablers TimeFinder SnapVX and zDP 8.5 Product Guide
Running TimeFinder Scanning Utility
The TimeFinder Scanning Utility is run as a batch job. The program name is ETFSCAN.
Specify input parameters in SYSIN DD directly or using a parameter library.
JCL or REXX datasets that invoke EMCTF and EMCSNAP programs are listed in SYSPRINT DD.
NOTE:Run the TimeFinder Scanning Utility with REGION=0M.
Sample JCL
//SCAN JOB (EMC),'ABCDEF1',NOTIFY=&SYSUID //SCAN EXEC PGM=ETFSCAN,REGION=0M,PARM='VERBOSE' //STEPLIB DD DISP=SHR,DSN=ds-prefix.LINKLIB //ETFDEBUG DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSIN DD * ABCDEF1.JCL.PS1 ABCDEF1.* ABCDEF1.ICDP.** /*
EXEC parameters
DD statements
- ETFDEBUG
- (Optional) If specified, general debugging information is written to ETFDEBUG.
- SYSIN
- (Required) Lists datasets to be scanned by the utility.
- SYSPRINT
- (Required) Provides the utility report, as shown in the sample output examples.
Specifying datasets
You can specify PDS or sequential datasets to be processed using specific dataset names or wildcards in SYSIN DD.
A dataset that is specified should have the Fixed Blocked record format and a record length of 80.
Datasets and dataset masks can be specified in SYSIN DD using the following syntax:
dsname1
dsname2
…
dsnameN
Dataset masking rules
The following rules apply to the special characters in a dataset mask:
- Dataset qualifiers should be separated with periods.
- Each qualifier should be with a maximum length of eight characters. The maximum length for the entire dataset mask is 44 characters.
- A percentage (%) represents a single character position. Thus, ‘%%%’ represents three character positions.
- A single asterisk (*) indicates that at least one qualifier is required to occupy the position.
- An asterisk within a qualifier means that zero or more characters can be present.
- A qualifier can be a single asterisk.
- Double asterisks (**) mean that zero or more qualifiers can be present.
- Double asterisks cannot appear with any other characters within a qualifier.
- Three or more adjacent asterisks are not allowed within a qualifier.
Example 1: Nonverbose
The TimeFinder Scanning Utility JCL is as follows:
//SCAN JOB (EMC),'ABCEFD1',NOTIFY=&SYSUID //CHECK EXEC PGM=ETFSCAN //STEPLIB DD DISP=SHR,DSN=SCLM.STFX.INT.LINKLIB //SYSPRINT DD SYSOUT=* //SYSIN DD * EVENGR1.STFX.#551516.JCLLIB EVENGR1.SSNP.#55*.JCLLIB EVENGR1.REXX.TEST /*
The output is as follows:
ETF0019I Dell EMC TimeFinder Scanning Utility V8.5.0(000) 10/11/19
ETF0017I Start reading list of datasets
EMCP001I ABCEFD1.STFX.#551516.JCLLIB
ETF0022I Found new dataset ABCEFD1.STFX.#551516.JCLLIB
EMCP001I ABCEFD1.SSNP.#55*.JCLLIB
ETF0022I Found new dataset ABCEFD1.SSNP.#550609.JCLLIB
ETF0022I Found new dataset ABCEFD1.SSNP.#551192.JCLLIB
ETF0022I Found new dataset ABCEFD1.SSNP.#552333.JCLLIB
ETF0022I Found new dataset ABCEFD1.SSNP.#554273.JCLLIB
EMCP001I ABCEFD1.REXX.TEST
ETF0022I Found new dataset ABCEFD1.REXX.TEST
ETF0011I Parsing complete
ETF0018I Total number of datasets selected for processing: 6
ETF0030I Analyzing dataset ABCEFD1.STFX.#551516.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCEFD1.SSNP.#550609.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCEFD1.SSNP.#551192.JCLLIB
ETF0034I Dataset includes 2 member(s)
ETF0030I Analyzing dataset ABCEFD1.SSNP.#552333.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCEFD1.SSNP.#554273.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCEFD1.REXX.TEST
ETF0034I Dataset includes 3 member(s)
ETF0061I TF/Mirror JCL invocations found in datasets:
ETF0064I ABCEFD1.STFX.#551516.JCLLIB
ETF0063I Total number of datasets: 1
ETF0068I TF/Snap VDEV JCL invocations not found
ETF0065I TF/Mirror REXX invocations found in datasets:
ETF0064I ABCEFD1.REXX.TEST
ETF0063I Total number of datasets: 1
ETF0066I TF/Snap REXX invocations found in datasets:
ETF0064I ABCEFD1.REXX.TEST
ETF0063I Total number of datasets: 1
ETF0020I Processing completed with RC=0
Example 2: VERBOSE
The TimeFinder Scanning Utility JCL is as follows:
//SCAN JOB (EMC),'ABCDEF1',NOTIFY=&SYSUID //CHECK EXEC PGM=ETFSCAN,PARM='VERBOSE' //STEPLIB DD DISP=SHR,DSN=SCLM.STFX.INT.LINKLIB //SYSPRINT DD SYSOUT=* //SYSIN DD * ABCDEF1.STFX.#551516.JCLLIB ABCDEF1.SSNP.#55*.JCLLIB ABCDEF1.REXX.TEST /*
The output is as follows:
ETF0019I Dell EMC TimeFinder Scanning Utility V8.5.0(000) 10/11/19
ETF0017I Start reading list of datasets
EMCP001I ABCDEF1.STFX.#551516.JCLLIB
ETF0022I Found new dataset ABCDEF1.STFX.#551516.JCLLIB
EMCP001I ABCDEF1.SSNP.#55*.JCLLIB
ETF0022I Found new dataset ABCDEF1.SSNP.#550609.JCLLIB
ETF0022I Found new dataset ABCDEF1.SSNP.#551192.JCLLIB
ETF0022I Found new dataset ABCDEF1.SSNP.#552333.JCLLIB
ETF0022I Found new dataset ABCDEF1.SSNP.#554273.JCLLIB
EMCP001I ABCDEF1.REXX.TEST
ETF0022I Found new dataset ABCDEF1.REXX.TEST
ETF0011I Parsing complete
ETF0018I Total number of datasets selected for processing: 6
ETF0030I Analyzing dataset ABCDEF1.STFX.#551516.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCDEF1.SSNP.#550609.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCDEF1.SSNP.#551192.JCLLIB
ETF0034I Dataset includes 2 member(s)
ETF0030I Analyzing dataset ABCDEF1.SSNP.#552333.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCDEF1.SSNP.#554273.JCLLIB
ETF0034I Dataset includes 3 member(s)
ETF0030I Analyzing dataset ABCDEF1.REXX.TEST
ETF0034I Dataset includes 3 member(s)
ETF0061I TF/Mirror JCL invocations found in datasets:
ETF0064I ABCDEF1.STFX.#551516.JCLLIB
ETF0064I EST#3
ETF0064I SPLIT
ETF0063I Total number of datasets: 1
ETF0068I TF/Snap VDEV JCL invocations not found
ETF0065I TF/Mirror REXX invocations found in datasets:
ETF0064I ABCDEF1.REXX.TEST
ETF0064I EHCXADCY
ETF0064I EIPXOUT
ETF0063I Total number of datasets: 1
ETF0066I TF/Snap REXX invocations found in datasets:
ETF0064I ABCDEF1.REXX.TEST
ETF0064I EIPXOUT
ETF0063I Total number of datasets: 1
ETF0020I Processing completed with RC=0
Example 3: Some datasets skipped
The TimeFinder Scanning Utility JCL is as follows:
//SCAN JOB (EMC),'ABCDEF1',NOTIFY=&SYSUID //CHECK EXEC PGM=ETFSCAN,PARM='VERBOSE' //STEPLIB DD DISP=SHR,DSN=SCLM.STFX.INT.LINKLIB //SYSPRINT DD SYSOUT=* //SYSIN DD * EVENGR1.SSNP.** EVENGR1.R* /*
The output is as follows:
ETF0019I Dell EMC TimeFinder Scanning Utility V8.5.0(000) 10/11/19
ETF0017I Start reading list of datasets
EMCP001I ABCDEF1.SSNP.**
ETF0022I Found new dataset ABCDEF1.SSNP.#XXXXXX.JCLLIB
ETF0022I Found new dataset ABCDEF1.SSNP.#ZDPNEW.JCLLIB
ETF0022I Found new dataset ABCDEF1.SSNP.#511425.JCLLIB
...
ETF0029W Dataset is not supported: ABCDEF1.SSNP.LOOKUP
EMCP001I ABCDEF1.R*
ETF0022I Found new dataset ABCDEF1.REXX
ETF0029W Dataset is not supported: ABCDEF1.REXX
ETF0022I Found new dataset ABCDEF1.R1FAIL
ETF0029W Dataset is not supported: EVENGR1.R1FAIL
ETF0022I Found new dataset ABCDEF1.R2FAIL
ETF0029W Dataset is not supported: ABCDEF1.R2FAIL
ETF0011I Parsing complete
ETF0018I Total number of datasets selected for processing: 30
ETF0030I Analyzing dataset ABCDEF1.SSNP.#XXXXXX.JCLLIB
ETF0034I Dataset includes 4 member(s)
ETF0030I Analyzing dataset ABCDEF1.SSNP.#ZDPNEW.JCLLIB
ETF0034I Dataset includes 17 member(s)
ETF0030I Analyzing dataset ABCDEF1.SSNP.#511425.JCLLIB
ETF0034I Dataset includes 3 member(s)
...
ETF0083I TF/Snap commands specified in separate dataset: GHIJKL1.STFX.O342079.JCL
ETF0007W Could not OPEN command dataset: GHIJKL1.STFX.O342079.JCL
ETF0061I TF/Mirror JCL invocations found in datasets:
ETF0064I ABCDEF1.SSNP.#538110.JCLLIB
ETF0064I CONFIG
ETF0064I ABCDEF1.SSNP.#545905.JCLLIB
ETF0064I MIXED
ETF0064I NOPARM
ETF0064I NOPARM1
ETF0064I RANGE
ETF0064I TF#HOLD
ETF0064I TF#REL
ETF0064I ABCDEF1.SSNP.#546685.JCLLIB
ETF0064I NA#HARDL
ETF0064I ABCDEF1.SSNP.JCLLIB
ETF0064I #SNXFC4
ETF0064I #516422
ETF0064I #525899
ETF0064I #535539
ETF0064I #537846
ETF0064I #537982
ETF0064I #538464
ETF0064I #540949
ETF0063I Total number of datasets: 4
ETF0062I TF/Snap VDEV JCL invocations found in datasets:
ETF0064I ABCDEF1.SSNP.JCLLIB
ETF0064I #511219
ETF0063I Total number of datasets: 1
ETF0069I TF/Mirror REXX invocations not found
ETF0070I TF/Snap REXX invocations not found
ETF0020I Processing completed with RC=4
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please provide ratings (1-5 stars).
Please select whether the article was helpful or not.
Comments cannot contain these special characters: <>()\