MEMLIST—member list dialog service

The MEMLIST service enables you to access the Library Utility member list from within a dialog.

When you invoke the MEMLIST service, a member list is displayed with either a 1-character or 9-character line command area. You can perform any of the Library Utility functions, such as Edit, Browse, View, Print, Delete, and Rename, from within the member list. If the line command field is 9 characters, you can also invoke TSO commands against the selected member.

The MEMLIST service is given a data-id that has been associated with a partitioned data set or concatenation of partitioned data sets by the LMINIT service. The data-id must be freed by the LMFREE service.

Command invocation format


>>-ISPEXEC--MEMLIST--DATAID(data-id)--+-----------------+------->
                                      '-MEMBER(pattern)-'   

>--+--------------------+--+-------------------+---------------->
   |          .-YES-.   |  '-PANEL(panel-name)-'   
   '-CONFIRM(-+-NO--+-)-'                          

>--+----------------+--+-----------------------+---------------><
   |        .-9-.   |  |          .-S------.   |   
   '-FIELD(-+-1-+-)-'  '-DEFAULT(-+-action-+-)-'

Call invocation format


>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><


>>-CALL--ISPLINK--('MEMLISTb'--,--data-id,--,-+-pattern-+------->
                                              '-'b'-----'   

     .-'YES'-.                      .-'S'------.      
>--,-+-'b'---+--,-+-panel-name-+--,-+-'b'------+-);------------><
     '-'NO'--'    '-'b'--------'    '-'action'-'

Parameters

data-id

Specifies the variable in which the data ID that uniquely identifies the partitioned data set is stored.

pattern

A character string that is used to specify which members are to be displayed. If no pattern is specified, the entire list is displayed.

YES|NO

Specifies whether the Confirm Delete panel appears when you try to delete a member from the data set you specified. YES is the default.

If YES is specified, ISPF displays the Confirm Delete panel.

If NO is specified, ISPF does not display the Confirm Delete panel. The member is deleted with no additional action on your part.

panel-name

The name of the panel to use for displaying the member list. This can be a customized panel that you provide. See z/OS ISPF Planning and Customizing for more information about developing a customized panel. If this parameter is omitted, the default panel is ISRUDMM if FIELD is set to 1, and ISRUDSM if FIELD is set to 9.

1|9

Indicates the length of the line command field on the member list display. The default is 9.

buf-len

Specifies a fullword fixed binary integer containing the length of "buffer".

buffer

Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

action

A single letter action to replace the "S" line command, such as E (edit) or B (browse). If not specified, then the system attempts to invoke an external command called "S".

Return codes

These return codes are possible:

0

Normal completion.

8

The requested data set was empty or no members matched the specified pattern.

10

No data set is associated with the given data ID. LMINIT has not been completed.

12

Indicates one of these:

Data set not partitioned.
Parameter value not valid.
Invocation syntax not valid.

16

A truncation or translation error occurred in accessing dialog variables.

20

Severe error.

Example

This example shows an invocation of MEMLIST that displays the member list of a partitioned data set with the Delete Data Set Confirmation panel. The variable ID contains a data-id generated by the LMINIT service.

Here is the command invocation:

ISPEXEC MEMLIST DATAID(&ID) CONFIRM(YES)

Here is the call invocation:

CALL ISPLINK ('MEMLIST ',ID,'YES     ');

Alternatively, you could:

Set the program variable BUFFER to contain

BUFFER='MEMLIST DATAID(&ID) CONFIRM(YES)';

Set program variable BUFLEN to the length of the variable BUFFER.
Issue the command
```
CALL ISPEXEC (BUFLEN, BUFFER);
```