Basic System DMS PROC › FIND Command › Syntax

Syntax

The syntax of the FIND command is as follows:

FIND DSNAME=,CATALOG=,PASSWORD=,TABLE=

DSNAME=

This parameter, REQUIRED only when the TABLE= parameter is not specified, is used to specify one explicit data set name or CA Disk pattern. This parameter is mutually exclusive with the TABLE= parameter. All standard CA Disk pattern matching capabilities are available (/, ?, * and !).

If a pattern is specified, the first node of the data set name must be specified without pattern characters. This is a requirement of catalog management, since the high-level node will be used to determine what catalog to search. For example, AB/ is not the same as AB./, even if AB is a complete node. The former will require much more memory because the end of the node is not indicated, which limits the catalog locate function.

Note: Specifying the first node of the data set name without pattern characters extends to multiple nodes as well, assuming MLA is in use. For example, in a nodes=2 MLA environment, the following is a valid command:

FIND DSN=node1.node2./

However, in the previous example, specifying the second dsn value as node2/ will result in messages 2461 and 3262 being issued.

Users wanting to locate data sets with only a partial HLQ must use the SELECT TABLE= command on either a SCAN REALVOLS, or SCAN CATALOG.

CATALOG=

Use this OPTIONAL parameter to specify a catalog that catalog management should search to find the specified data set name or pattern. This parameter is required only if the data set name does not have an alias connector in the master catalog, or if the data set is in a catalog other than the one to which the alias points.

PASSWORD=

Use this OPTIONAL parameter when processing password-protected VSAM clusters to supply CA Disk with the proper level password it will need to carry out its requested functions. You can supply any of the following passwords:

Catalog master password

Cluster master password

CA Disk master password

See PASSWORD Command (For VSAM Only) to determine the level of password required for each function (such as REPORT and ARCHIVE). Note that this parameter must be specified even if the PASSWORD command is specified separately — the PASSWORD command is not used by the FIND command.

TABLE=

This parameter, REQUIRED only when the DSNAME= parameter is not specified, is used to specify the name of a member in the parmlib data set containing the list (table) of fully qualified data set names or patterns. If a pattern is specified, the first node of the data set name must be specified without pattern characters. Finally, this parameter is mutually exclusive with the DSNAME= parameter.

Note: Since SELECT and/or EXCLUDE commands can be combined with FIND TABLE=, data sets are not just automatically selected because they appear in this list. In the following example, the data set must both be listed in the parmlib member named IMSDSNS and must have been backed up within the last five days:

FIND TABLE=IMSDSNS

SELECT CRITERIA=(ARCDT,GE,TODAY-5)

Values specified in the TABLE= member have the same limitations as those for the DSNAME= parameter, described in DSNAME=.

There is not an exact limit to the number of entries that can be entered into a TABLE= member. It all depends on the environment. The information for the table is compiled and stored in a Variable Length table in memory above the 16M line. So, the maximum number of table entries is directly related to the amount of memory available to DSCL.

The format of the TABLE= member can be found under the topic Selection Lists —Generalized in the Systems Guide.

Note: By default, these tables are stored in PARMLIB. However, you can store them in an alternative data set if you desire. For details, see Alternate DDname for User Tables in the Systems Guide.