LMMDISP provides a flexible and efficient way of performing many
of the tedious tasks associated with processing member lists. A member
list is a list of members from a single ISPF library, or concatenation
of ISPF libraries or MVS™ partitioned
data sets associated with a data ID.
The dialog invoking LMMDISP must first issue a successful call
to both LMINIT and LMOPEN.
The LMMDISP service performs six member list functions for a dialog
according to the value specified in the OPTION parameter. The six
values that can be specified are:
- Display
- This option creates and displays a member list for the specified
data ID. A user can select members for processing from this member
list by entering a valid line command next to the member name or by
using the SELECT primary command. A
member that does not exist on the member list can also be selected
by using the SELECT primary command. The first member selected from
this display is returned in ISPF dialog variables.
A nonexistent
member can only be selected if LMMDISP was invoked with the ALLOWNEW
parameter.
- Get
- This option is used to return the second, and remaining selected
members from the most recent member list display. The GET option must
be invoked for each selected member that is to be returned. The GET
option can only return one selected member at a time.
- Put
- This option saves information in the Line Command field, and the
User Data field of the member list.
- Add
- This option adds a member to a member list.
- Delete
- This option deletes a member from a member list.
- Free
- This option frees the storage associated with a member list.
The description of each option, including format, parameters, return
codes, and examples, follows a discussion on dialog variables.
Note: Member lists generated by LMMLIST cannot be displayed by LMMDISP
and member lists generated by LMMDISP cannot be used with LMMLIST.
Member lists should be freed when switching between LMMLIST and LMMDISP
with the same data ID by using OPTION(FREE).