Basic System DMS PROC › Data Storage Command Language › SCAN and FIND Rules › SCAN and FIND Rule #1

SCAN and FIND Rule #1

DSCL processes the specified requests in terms of logical blocks termed SCAN/FIND groups. A SCAN/FIND group begins with a SCAN or FIND command and ends when the next non-consecutive SCAN or FIND command is encountered, or at the end of the input command stream.

At least one ACTION command must be specified in every SCAN/FIND group, with the one exception that SCAN CATALOGS=, BACKUP does not require an action command.

In its simplest form, a valid SCAN/FIND group looks like:

SCAN REALVOLS

SELECT VOL=/,DSN=/
REPORT ALLOC

This would cause CA Disk to scan all online volumes and produce a volume allocation summary report.

Another simple SCAN/FIND group:

FIND DSNAMES=LABS.TJP./

REPORT MVDICT

would report on all data sets and clusters beginning with the prefix LABS.TJP.

While DSCL does not care about spacing, the indentation shown can help us in the examples that follow.