z/VM: CP Commands and Utilities Reference - z/VM - IBM

CPCACHE
Usage Notes
Responses
Messages
1. To release a minidisk and all cached files on that minidisk, enter a CPRELEASE
command and specify the access mode of the minidisk. For more information,
see “CPRELEASE” on page 92.
2. If you find yourself caching the same files each time, you can avoid issuing the
CPCACHE command by creating a CPCACHE FILES file on the minidisk. The
CPCACHE FILES file lists all the files on that minidisk that you want CP to
cache. You can use generic file names and file types. When you use the
CPACCESS command or the CP_ACCESS statement to identify the minidisk to
CP, CP looks for a CPCACHE FILES file on that minidisk and caches all the
specified files.
Here is an example of what a CPCACHE FILES file might look like:
/*-------------------------------------
Cache often-used logo picture files
-------------------------------------*/
TCPIP LOGO
PVM LOGO
/*-----------------------------
Cache all log message files
-----------------------------*/
* LOGMS*
3. If you want to see which files are being used the most, enter a CPLISTFILE
command with the STAT option. This gives you a list of the files and how many
times they have been opened and closed. For more information on the
CPLISTFILE command, see “CPLISTFILE” on page 88.
Response 1:
If you want to cache all LOGO files on your A-disk that start with the string SYS,
you can enter the following:
cpcache sys* logo a
1 file(s) cached
Ready;
Response 2:
If CP cannot find any files that match the specified file name and file type, you see
the following:
cpcache my logo a
No files cached
Ready;
HCP003E Invalid option - command contains
extra option(s) starting with operand
HCP6704E Missing token at end of line
HCP6706E Invalid file {name|type|mode} - {fn|ft|fm}
HCP6729I No files cached.
84 z/VM: CP Commands and Utilities Reference
HCP6731E Disk fm is being released -- command
rejected