HLASM Toolkit Feature User's Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using the wildcard character to select groups of members

HLASM Toolkit Feature User's Guide
GC26-8710-10

You can use a "*" as a generic indicator as part of the member name or member type (or both) to select a group of members for subsequent input to either the SuperC Comparison or the SuperC Search. The "*" may only be used at the beginning (prefix) or the end (suffix) of the member name or member type.

Examples:

Member Name Member Type Members Selected (Member Name and Type shown only)
MEM1 TYPA MEM1.TYPA (Selection of a single member)
MEM* TYPA All members with a name starting with "MEM" and a type of "TYPA"
MEM* * All members with a name starting with "MEM" regardless of type
*MEM TYP* All members with a name ending with "MEM" and a type starting with "TYP"
MEM *TYP* Invalid use of wildcard character; can only be used as a prefix or a suffix to the same item
* * All members (in the sublibrary of the Librarian library)
Note: When using the NEWDD and OLDDD process statements with wildcard ("*") characters to select a new group of members for comparison with an old group of members, be aware of the way in which individual members (within each group) are "paired" by SuperC for subsequent comparison.
SuperC "pairs" members from each (sorted) group:
  • According to the portion of the member name or member type which was represented by the "*" wildcard character (when SuperC initially selected the members for inclusion in the group), and
  • Ignoring the remainder of the member name or member type
For example, if you specified a member name of ABC1* in the NEWDD process statement (to select all new members with names starting with "ABC1"), and a member name of XYZ* in the OLDDD process statement (to select all old members with names starting with "XYZ"), it could result in:
  • library.sublibrary.ABC11.type
being compared with
  • library.sublibrary.XYZ1.type
which may not be what you wanted.

If you find that members are not being "paired" as you want, use SELECT process statements to specify each individual pair of members that you want compared.

Compare Types: FILE, LINE, WORD, and BYTE. NEWDD is also valid for Search.
Read syntax diagramSkip visual syntax diagram
>>-+-NEWDD-+---------------------------------------------------->
   '-OLDDD-'   

>--+-+-DLBL_name-+--| Attributes |--------------------------+--><
   | '-TLBL_name-'                                          |   
   '-lib--.--sublib--+------------------------------------+-'   
                     |                 .-.--SOURCE------. |     
                     '-.--member_name--+----------------+-'     
                                       '-.--member_type-'       

Attributes

   .-,--BLKSIZE--=--80--,--RECSIZE--=--80--,--RECFORM--=--FU----------------------.   
|--+------------------------------------------------------------------------------+--|
   '-,--BLKSIZE--=--block_size--,--RECSIZE--=--record_size--,--RECFORM--=--+-VU-+-'   
                                                                           +-VB-+     
                                                                           +-FU-+     
                                                                           '-FB-'     

Read syntax diagramSkip visual syntax diagram
>>-UPDDD--DLBL_name--------------------------------------------><

DLBL_name
Your own choice of DLBL name for the new, old, or update file.
TLBL_name
Your own choice of TLBL name for the new or old file.
lib.sublib
Library and sublibrary names. (Librarian members only.)
member_name
Name of the member in the sublibrary.
member_type
Member type of the member in the sublibrary.
block_size
The block size of the new or old file.
record_size
The record size of the new or old file.
Note: For variable-length records, this must be the maximum record length.
RECFORM=
The record format of the new or old file:
VU
Variable, unblocked
VB
Variable, blocked
FU
Fixed, unblocked
FB
Fixed, blocked
Example Description
NEWDD FILE1,BLKSIZE=160,RECSIZE=80,RECFORM=FB Name of new file is FILE1 with a block size of 160, and fixed blocked records of length 80.
OLDDD FILE2,BLKSIZE=120,RECSIZE=120,RECFORM=FU Name of old file is FILE2 with fixed unblocked records of length 120.
UPDDD FILE3 Name of update file is FILE3.
NEWDD FILE4 Name of new file is FILE4 with (default file attributes) fixed unblocked records of length 80.
NEWDD MAINLIB.LIBA.MEMB1.C Selects new member MEMB1 (with a member type of C) in sublibrary LIBA, in library MAINLIB.
OLDDD MAINLIB.LIBA.MEMB*.C Selects all old members with a member name starting with "MEMB" (and with a member type of C) in sublibrary LIBA, in library MAINLIB.
NEWDD MAINLIB.LIBA.*.C Selects all new members with a member type of C in sublibrary LIBA, in library MAINLIB.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014