FF: This field must contain a binary
value indicating the total number of entries in the list.
LL: This field must contain a binary
value indicating the length, in bytes, of each entry in the list.
If the exact length of the entry is known, specify the exact length.
Otherwise, specify at least 62 bytes (decimal)
if an entry in the list is to be used with an ATTACH, LINK, LOAD,
or XCTL macro. The minimum length for a list is 12 bytes.
NAME: This field must contain the member
name or alias to be located. The name must start in the first byte
of the name field and be padded to the right with blanks (if necessary)
to fill the 8-byte field.
When the BLDL macro is executed, 5 fields of the directory entry
list are filled in by the system. The specified length (LL) must be
at least 14 bytes to fill in the Z and C fields. If the LL field is
12 bytes, only the NAME, TT, R, and K fields are returned. The 5 fields
are:
TT: Indicates the two-byte relative track
number where the beginning of the member is located.
R: Indicates the one-byte relative block
(record) number on the track indicated by TT.
For a PDSE or a UNIX directory, TTR is
a token that does not represent the physical location of the member
in the data set.
K: Indicates the concatenation number
of the data set. For the first or only data set, this value is zero.
Z: Indicates where the system found the
directory entry:
- Code
- Meaning
- 0
- Private library
- 1
- Link library
- 2
- Job, task, or step library
- 3-16
- Job, task, or step library of parent task n, where n = Z-2
C: Indicates the type of name (primary
or alias) for the number of note list fields (TTRNs), and the length
of the user data field (indicated in halfwords). The following describes
the meaning of the 8 bits:
- Bit
- Meaning
- 0=0
- Indicates a member name.
- 0=1
- Indicates an alias.
- 1-2
- Indicates the number of TTRN fields (maximum of 3) in the user
data field.
- 3-7
- Indicates the total number of halfwords in the user data field.
USER DATA: The user data field contains
the user data from the directory entry. If the length of the user
data field in the BLDL list is equal to or greater than the user data
field of the directory entry, the entire user data field is entered
in the list. Otherwise, the list contains only the user data for which
there is space.