How do I specify pattern characters for data set names on my CA PDSMAN $ACCESS and $UPDATE Initialization Control Statements?

Document ID : KB000011242
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

How do I specify pattern characters for data set names on my CA PDSMAN $ACCESS and $UPDATE Initialization Control Statements in PDSMINIT?

Answer:

This document provides information about using pattern characters when specifying data set names on the LIB= parameter on the PDSMAN $ACCESS and $UPDATE Initialization Control Statements.

The minus sign '-' pattern character is used to match multiple index levels (qualifiers) or characters in a data set name. There are a number of considerations when using this pattern character:

  1. When specified as the only character in the first or last qualifier of the DSN, the '-' sign matches one or more qualifiers. For example:

    -.C.D matches
    A.C.D (one additional qualifier)
    A.B.C.D (multiple qualifiers)
    but not C.D (no additional qualifiers)

    C.D.- matches
    C.D.E (one additional qualifier)
    C.D.E.F (multiple qualifiers)
    but not C.D (no additional qualifiers)

  2. When specified as the last character in the pattern, but not as a standalone qualifier, the '-' sign matches zero or more characters or qualifiers. For example:

    G.H- matches
    G.H (no additional characters)
    G.H1 (additional characters)
    G.H.I (additional qualifier)
    G.H.I.J (multiple additional qualifiers)
    G.H1.I1 (both characters and qualifiers)

  3. When specified as a stand alone qualifier within a pattern, the '-' sign matches one or more characters in one qualifier only. For example:

    J.-.L matches
    J.K.L (one qualifier)
    J.K1.L (one qualifier, multi characters)
    but not J.L (missing qualifier)
    J.K.Z.L (multiple qualifiers)

  4. When specified with other characters in a qualifier within a pattern, the '-' sign matches zero or more characters. For example:

    M.PQ-TU.Z matches
    M.PQTU.Z (no characters)
    M.PQRTU.Z (one character)
    M.PQRSTU.Z (multiple characters)

    M.-TU.Z matches
    M.TU.Z (no characters)
    M.STU.Z (one character)
    M.PQRSTU.Z (multiple characters)

    M.PQ-.Z matches
    M.PQ.Z (no characters)
    M.PQR.Z (one character)
    M.PQRSTU.Z (multiple characters)

  5. You may specify more than one '-' sign in a pattern, but NOT more than one in a qualifier. For example:

    A.-.-.D is valid (Multiple '-' in pattern)
    A.-X-.D is not valid (Multiple '-' in one qualifier)

The plus sign '+' pattern character is used to match a single character in a data set name. In some patterns it also matches a null character. You can specify multiple '+' characters in the pattern.

  1. When specified as trailing characters in a node, the '+' sign matches a single or null character. For example:

    A++.DEF matches
    A.DEF (two null characters present)
    AB.DEF (one null character present)
    ABC.DEF (no null characters present)

  2. When specified as leading or embedded characters in a node, the '+' sign matches a single character only, not a null character. For example:

    A.+DE matches
    A.CDE (leading character present)
    but not A.DE (null character not matched)

    A.C+E matches
    A.CDE (embedded character present)
    but not A.CE (null character not matched)

PDSMAN provides a utility program, PDSM34, to report the PDSMAN $ACCESS and $UPDATE initialization control statements in effect for a given library. You can use this utility to verify that you have correctly specified your LIB= patterns and that the expected control statement is being matched for a library. The following sample JCL can be used to execute PDSM34:

//PDSM34 EXEC PGM-PDSM34,PARM='datasetname'
//PDSMRPT DD SYSOUT-*

Where 'datasetname' is the name of the library to be checked against the PDSMAN initialization control statements.

The PDSM34 utility can also be executed online by choosing the Rule Scanning Facility option on the PDSMAN ISPF Master Menu.

 

Additional Information:

See the "Customizing PDSMAN" chapter of the CA PDSMAN Administrator Guide. Additional information on the PDSM34 Rule Scanning Facility is also provided in that chapter.