Applications invoke ICQGCL00 with the following syntax. The parameters
PREFIX and TABLE are required; the others are optional keyword parameters.
ICQGCL00 +
PREFIX(user ID) +
QUAL1(first-level-qualifier) +
QUAL2(second-level-qualifier) +
EXACT(Y|N) +
TABLE(table-name)
- PREFIX(user ID)
- specifies the user ID or prefix to be used as search criteria.
- QUAL1(first-level qualifier)
- specifies the first-level qualifier to be used as search criteria.
An asterisk (*) can be specified to indicate that all data set names
meet the search criteria for the first-level qualifier. Also, an asterisk
can be used as a suffix of the first-level qualifier to indicate that
all data set names that match the prefix characters meet the search
criteria for the first-level qualifier.
- QUAL2(second-level qualifier)
- specifies the second-level qualifier to be used as search criteria.
An asterisk (*) can be specified to indicate that all data set names
meet the search criteria for the second-level qualifier. Also, an
asterisk can be used as a suffix of the second-level qualifier to
indicate that all data set names that match the prefix characters
meet the search criteria for the second-level qualifier.
- EXACT(Y | N)
- specifies whether to return those data set names that match the
specified qualifiers and have exactly that number of qualifiers.
The default is Y, to return only those data set names that have exactly
the number of specified qualifiers.
For example, to search for
all data sets that have a user ID of MYDATA and a first-level qualifier
beginning with ICQ, specify
ICQGCL00 PREFIX(MYDATA) QUAL1(ICQ*) EXACT(N) +
TABLE(table-name)
To search for all data
sets with a user ID of MYDATA that have exactly two levels of qualification
after the prefix, specify:
ICQGCL00 PREFIX(MYDATA) QUAL1(*) QUAL2(*) EXACT(Y) +
TABLE(table-name)
- TABLE(table-name)
- specifies the name of the ISPF table in which ICQGCL00 returns
the names of the data sets that meet the search criteria. If the
specified table does not exist, ICQGCL00 creates a temporary table.
The following section describes the variables that ICQGCL00 creates
in the table.