Masking characters
The DSN mask can include the following characters in the nodes:
Character | Description |
|---|---|
* | Copy the DSN node to the corresponding node in the output DSN. The single asterisk can appear only once in the same node of a DSN mask. If a single asterisk (*) appears as a node in the mask (for example, TEST.DATA.*), the corresponding source DSN node is copied to the corresponding location in the output DSN. |
** | Copy enough source DSN nodes to build an output DSN with the same number of nodes as the source DSN. The double asterisk can appear only once in a mask, must start a new node of the mask, and must be followed by a period or a space. If double asterisks appear in the mask, the mask is converted internally to include enough single asterisk nodes so the mask has at least the same number of nodes as the source DSN. For example, if the source DSN has 5 nodes, the mask TEST.DATA.** is converted to TEST.DATA.*.*.*. If the mask has more nodes than the source DSN, the double asterisks are ignored. |
? or % | Copy single characters from a source DSN node to the corresponding locations in the output DSN. If the end of the source DSN node has been reached, any remaining ? or % characters in the mask node are skipped. |
xxxxxxxx | Replace the corresponding node of the source DSN with string (1 through 8 characters) that must conform to normal DSN conventions for nodes. |