CPLISTFILE

Specifications

Authorization

Privilege Class: A

Purpose

Use CPLISTFILE to list information on the files on a minidisk that you identified to CP by using either a CPACCESS command or a CP_ACCESS statement.

For more information on the CPACCESS command, see CPACCESS.

For more information on the CP_ACCESS Statement, see z/VM®: CP Planning and Administration.

Operands

fn

*

is the file name of the file on which you want information. If you omit fn or specify an asterisk (*), CP lists all file names. You can use generic file names to request a specific subset of files. A generic file name is a 1- to 8-character string with asterisks (*) in place of 1 or more characters and percent signs (%) in place of exactly 1 character. For example:

cplistfile hc%p* * *

lists all files that start with HC and have P as their fourth character.

ft

*

is the file type of the file on which you want information. If you omit ft or specify an asterisk (*), CP lists all file types. You can use generic file types to request a specific subset of files. A generic file type is a 1- to 8-character string with asterisks (*) in place of 1 or more arbitrary characters and percent signs (%) in place of exactly 1 arbitrary character. For example:

cplistfile * con%%g *

caches all files whose file types start with CON and have G as their sixth (and last) character.

fm

*

is the file mode letter of the minidisk containing the files on which you want information. If you omit fm, CP lists the files on the minidisk that is accessed as file mode A (the default). If you specify an asterisk (*), CP lists the files on all accessed disks.

Information

tells CP to list the following information on each file in the list:

File ID (file name, file type, and file mode)
Format (fixed or variable)
Logical record length
Number of records in the file
Date and time when the file was created or last updated
Whether CP cached the file.

INFORMATION is the default.

Statistics

tells CP to list the following information about each file:

File ID (file name, file type, and file mode)
Number of times the file has been opened and closed since you identified the minidisk to CP using the CPACCESS command (see CPACCESS).
Note: If CP cached the file, the number of times the file has been opened is one more than the number of times the file has been closed. For example, see the PVM and TCPIP LOGO files in the two responses that follow.

MEMber member

tells CP that the files you are displaying are members of a CMS partitioned data set. The variable member is the name of the member within the CMS partitioned data set that you want displayed, and must be a 1- to 8-character alphanumeric string.

If you omit the MEMBER operand, CP does not display any of the members of the CMS partitioned data set. CP only displays the name of the CMS partitioned data set.

You can use generic member names to request a specific subset of members. A generic member name is a 1- to 8-character string with asterisks (*) in place of 1 or more characters and percent signs (%) in place of exactly 1 character. For example:

cplistfile * * a information member qu%r*

lists all members that start with QU and have R as their fourth character.

SHOrtdate

Specifies that dates in the response to this command will be displayed in mm/dd/yy format, where mm is the month, dd is the day of the month, and yy is the 2-digit year.

FULldate

Specifies that dates in the response to this command will be displayed in mm/dd/yyyy, where mm is the month, dd is the day of the month, and yyyy is the 4-digit year.

ISOdate

Specifies that dates in the response to this command will be displayed in yyyy-mm-dd format, where yyyy is the 4-digit year, mm is the month, and dd is the day of the month.

Usage Notes

To see a list of the minidisks that CP has access to, use the QUERY CPDISK command. For more information, see QUERY CPDISKS.
If no date operand is specified, the user's default date format setting will be used.

Responses

Response 1:

If you want to see a list of all the LOGO files on CP's A-disk, enter the following:

cplistfile * logo a information fulldate
Filename Filetype FM Fmt LRecL    Records    Date      Time   Cache
DAVID    LOGO     A  F      78         15 09/05/1992 06:43:26 No
DEFAULT  LOGO     A  F      80         15 11/29/1992 06:42:14 No
EMILY    LOGO     A  F      80         15 02/14/1992 06:42:23 No
LDEV     LOGO     A  F      80         15 07/28/1992 06:41:48 No
LOCAL    LOGO     A  F      80         15 10/03/1992 06:41:40 No
MOD5     LOGO     A  F     132         15 10/03/1992 06:41:15 No
PVM      LOGO     A  F      78         15 11/29/1992 06:42:01 Yes
SNA      LOGO     A  F      78         15 09/05/1992 06:41:34 No
SVCDIR   LOGO     A  F      80         15 12/18/1992 22:06:27 No
SYSTEM   LOGO     A  F      80         15 11/29/1992 06:41:28 No
TCPIP    LOGO     A  F      78         15 10/03/1992 06:42:07 Yes
08E4     LOGO     A  F      80         15 12/18/1992 06:41:21 No
08E6     LOGO     A  F      80         23 12/18/1992 06:41:54 No
Ready;

Response 2:

If you want to see a list of all the LOGO files on CP's A-disk and you want to know how many times each file has been opened and closed, enter the following:

cplistfile * logo a statistics
Filename Filetype FM      Opens     Closes
DAVID    LOGO     A           0          0
DEFAULT  LOGO     A           1          1
EMILY    LOGO     A           0          0
LDEV     LOGO     A           0          0
LOCAL    LOGO     A           1          1
MOD5     LOGO     A           2          2
PVM      LOGO     A          19         18
SNA      LOGO     A           1          1
SVCDIR   LOGO     A           1          1
SYSTEM   LOGO     A           0          0
TCPIP    LOGO     A          21         20
08E4     LOGO     A           0          0
08E6     LOGO     A           0          0
Ready;

Response 3:

If you want to see a list of all the TXTLIB files on CP's A-disk that contain CMS partitioned data set members starting with the prefix IEA, enter the following:

cplistfile * txtlib a information member iea* shortdate
Filename Filetype FM Fmt LRecL    Records   Date     Time   Cache
CMSLIB   TXTLIB   B  F      80        131 12/20/96 13:12:29 No
   Member IEAXPSIM  starts at record 2
   Member IEAXPALL  starts at record 8
   Alias  IEAXKALL  starts at record 8
   Member IEAXPDXR  starts at record 102
   Alias  IEAXKDXR  starts at record 102
Ready;

This response tells you that CP has one TXTLIB on its A-disk and that TXTLIB contains:

3 members whose names start with IEA at records 2, 8, and 102
2 aliases whose names starts with IEA for the two members at records 8 and 102.

Response 4:

If you want to see the above response with the date in mm/dd/yyyy format, enter the following:

cplistfile * txtlib a information member iea* fulldate
Filename Filetype FM Fmt LRecL    Records    Date      Time   Cache
CMSLIB   TXTLIB   B  F      80        131 12/20/1996 13:12:29 No
   Member IEAXPSIM  starts at record 2
   Member IEAXPALL  starts at record 8
   Alias  IEAXKALL  starts at record 8
   Member IEAXPDXR  starts at record 102
   Alias  IEAXKDXR  starts at record 102
Ready;

Response 5:

If you want to see the above response with the date in yyyy-mm-dd format, enter the following:

cplistfile * txtlib a information member iea* isodate
Filename Filetype FM Fmt LRecL    Records    Date      Time   Cache
CMSLIB   TXTLIB   B  F      80        131 1996-12-20 13:12:29 No
   Member IEAXPSIM  starts at record 2
   Member IEAXPALL  starts at record 8
   Alias  IEAXKALL  starts at record 8
   Member IEAXPDXR  starts at record 102
   Alias  IEAXKDXR  starts at record 102
Ready;

Messages

HCP002E Invalid operand - operand
HCP003E Invalid option - command contains extra option(s) starting with operand
HCP013E Conflicting option - option
HCP6704E Missing token at end of line
HCP6706E Invalid file {name|type|mode|member name} - {fn | ft | fm | member}
HCP6728E {File|Member} not found.