LISTPD  is a program for listing, either to another file or to an
output device, some or all of the members of a partitioned  file.
Options   are  provided   for selecting a subset of members to be
listed, numbering the lines of each member (with variable  origin
and/or   step)   and  starting each member on a new page.  LISTPD
may also be used on ordinary character files; its effect is  then
similar   to   that  of  the  LINENO program (in other words, the
file is treated as if it were a partitioned file  with  a  single
member).   Before the program is used for the first time, its ob-
ject file must  be inserted  into   a  directory  in  the  user's
search  list.  The easiest way to do this is usually to issue the
command:

INSERT(PUBLIC.LISTPD)

This need only be done once.

     This run lists all members of the partitioned file SRCPD  to
     .OUT,  with line numbers:

     LISTPD(SRCPD,.OUT,YES)

     This   run  lists  all  members of the partitioned file XPD,
     which start with the letter A, to  the  main  line  printer;
     each member is started  on a new page:

     LISTPD(XPD,.LP,,*A,YES)

     This  run  lists  members  ZAPHOD and TRILLIAN of the parti-
     tioned file GOLD to the main printer, without line numbers:

     LISTPD(GOLD,.LP,,ZAPHOD&TRILLIAN)

     This  run  lists the members of the partitioned file  MARVIN
     to  the  main  printer, numbering each member in steps of 10
     starting at line 100:

     LISTPD(MARVIN,.LP,YES,LORIGIN=100,LSTEP=10)


See also note 1 below.

[YES/NO]

See also note 2 below.

[YES/NO]



[YES/NO] This also applies to the values for each parameter.

Output  may  be  directed  to a file (but not a member of a  par-
titioned  file),  or  to any legal device, excluding .TEMP, .NULL
and .IN.

Only members which are EMAS "character" files are listed.  A sub-
set   of  members  may  be  selected  by  giving a non-null value
for the PATTERN parameter.  Selected files must match  this  pat-
tern, with the  character "*"   (asterisk)   matching   any   se-
quence  of  characters;  see  the documentation on the FILES com-
mand for further  details.   The  PATTERN parameter  may  also be
a list of member names (NOT patterns)  separated  by  ampersands;
the  effect of this is that the  named  members,  and  no others,
are listed.  Each  member  is  preceded by a header,  giving  its
name.  A new page is also started if the  PAGE=YES  parameter  is
specified.   Members  are listed in alphabetical order.  All  er-
ror  messages are self explanatory, except for the message "Table
too small"; this indicates that the partitioned file contains too
many members to be processed (currently, more than 1000).  LISTPD
is  based  on  an earlier program of the same name,  provided  by
Roderick Mcleod of Edinburgh Regional Computing Centre.