Display Save File (DSPSAVF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Save File (DSPSAVF) command displays the save information in a save file. This includes summary information about the save operation and a description of each object saved to the save file.
The QSYS2.SAVE_FILE_INFO and QSYS2.SAVE_FILE_OBJECTS views and the QSYS2.SAVE_FILE_OBJECTS table function return similar information.
Restrictions:
- You must have use (*USE) authority for the save file and read (*READ) authority for the specified library.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FILE | Save file | Qualified object name | Required, Positional 1 |
| Qualifier 1: Save file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTPUT | Output | Optional, Positional 2 |
| Top |
Save file (FILE)
Specifies the save file to be displayed.
This is a required parameter.
Qualifier 1: Save file
- name
- Specify the name of the save file.
Qualifier 2: Library
- *LIBL
- All libraries in the library list for the current thread are searched until the first match is found.
- *CURLIB
- The current library for the thread is used to locate the save file. If no current library entry exists in the library list, the QGPL library is used.
- name
- Specify the name of the library where the save file is located.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
- *
- The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
- The output is printed with the job's spooled output.
| Top |
Examples
DSPSAVF FILE(ONLINE) OUTPUT(*PRINT)
This command shows the objects saved to save file ONLINE. The output is printed with the job's spooled output.
| Top |
Error messages
*ESCAPE Messages
- CPD375A
- Media error on save media.
- CPF3704
- Request ended; data management error occurred.
- CPF3743
- File cannot be restored, displayed, or listed.
- CPF3782
- File &1 in &2 not a save file.
- CPF3782
- File &1 in &2 not a save file.
- CPF3792
- Information not displayed. Error occurred.
- CPF3793
- Machine or ASP storage limit reached.
- CPF3812
- Save file &1 in &2 in use.
- CPF9806
- Cannot perform function for object &2 in library &3.
- CPF9809
- Library &1 cannot be accessed.
- CPF9812
- File &1 in library &2 not found.
- CPF9820
- Not authorized to use library &1.
- CPF9822
- Not authorized to file &1 in library &2.
- CPF9850
- Override of printer file &1 not allowed.
- CPF9851
- Overflow value for file &1 in &2 too small.
| Top |