Creating a Spooled File List

With a single spooled file list, you can add multiple output queues that you want to save by selecting multiple sequence numbers. When you add the output queues, you can select the type of spooled file names, job names, or user names that you want to save.

To create a spooled file list for an existing control group, take the following steps from the Work with Backup Control Groups display:

  1. Place a 2 (Edit entries) next to the control group to which you want to add the list.
  2. At the Edit Control Group Entries display, type a sequence number at the top of the Opt column and press F23. This takes you to the Work with Backup lists display.
  3. At the Work with Backup Lists display, type in the name of the list you want to create, in this case, a spooled file list called SAVESPOOL.
  4. Type a 1 (Add) in the Opt column.
  5. Type the name of the spooled file you want to create in the List name field.
  6. Type *BKU in the Use column.
  7. Name the list type, *SPL, in the Type column.
  8. Then press Enter. This takes you to the Add Spooled File List display. 
                                  Add Spooled File List                  RCHAS400   
                                                                                
 Use . . . . . . . . . :  *BKU                                                  
 List name . . . . . . .  SAVESPOOL                                             
 Text  . . . . . . . . .  Sample to save spooled files                          
                                                                                
 Type choices, press Enter.                                                     
                                                                         *INC/  
   Seq Library    Outq       File       Job        User       User data  *EXC   
                                                                                
    10 QGPL       QPRINT*    *ALL       *ALL       *ALL       *ALL       *INC   
    20 QUSRSYS    *ALL       *ALL       *ALL       *ALL       *ALL       *INC   
    30 QUSRSYS    QEZDEBUG   *ALL       *ALL       *ALL       *ALL       *EXC   
    40 *ALL       BILLINGS   *ALL       *ALL       *ALL       *ALL       *INC   
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
                                                                                
 F3=Exit    F5=Refresh    F11=Expiration view    F12=Cancel
  9. Review and change the additional parameters on this display as needed.
  10. Press Enter twice to save and to return to the Work with Backup Lists display. You can now see the name of your list in the list of backup items.
  11. Press Enter again to return to the Edit Backup Control Group Entries display. Type the name of the list in the Backup items field, the name of the list type in the List type column and press Enter. BRMS saves the new list in the control group you specified, in this case, the SAMPLE control group.
  12. Press Enter to return to the Work with Control Groups display.

When saving to target release V5R4M0 or later, BRMS saves and restores spooled files using the native operating system support. The list items will be saved starting from the lowest sequence to the highest sequence. List items will be grouped for the save by the following rules to minimize the number of save operations performed:

In spooled file list SAVESPOOL above, two saves will be performed. The first save will include sequences 10, 20 and 30. Sequence 40 will be the last save.

BRMS does not support the incremental saves of spooled files. If you specify an incremental save of spooled files, BRMS saves all of the spooled files.

BRMS does not clear output queues after the save. You must manage the expiration and deletion of spooled files from your output queues. See Expiring Saved Spooled Files for more information.

IBM recommends that you obtain a hardcopy of your output queue immediately after the save has completed for audit purposes. To print the output queue, use the Work with Output Queue (WRKOUTQ) command with the OUTPUT(*PRINT) option specified.

Note:
When saving to target release prior to V5R4M0, BRMS saves the spooled files as a single folder, with multiple documents within that folder. During the restore, it reads the tape label for the folder and restores all of the documents. If your spooled file save spans multiple volumes, BRMS prompts you to read the label information before restoring the documents on subsequent tapes. To avoid possible confusion, you can save your spooled files on a separate tape by using the *LOAD exit in the control group or you can split your spooled file saves so that you use only one tape at a time. Either approach can make the recovery easier for you.
Note:
When saving spooled files to target releases prior to V5R4M0, BRMS first retrieves the names of the spooled files using a system API which stores the spooled file names in a user space. User spaces are restricted to a limited size. If you have a lot of spooled files, the returned names may exceed the size of the user space. In this case, the backup of the spooled files will fail with a CPF34C4 exception. You can correct the problem by breaking up the current spooled file list entries into more granular entries.

BRMS provides a spooled file list named QALLSPLF which you can use to save all spooled files on your system. If you want to save spooled files using this list, simply add the list to your current backup control group.

                           Display Spooled File List                 RCHAS400   
                                                                                
 Use . . . . . . . . . :  *BKU                                                  
 List name . . . . . . :  QALLSPLF                                              
 Text  . . . . . . . . :  All printed output                                    
                                                                                
                                                                         *INC/  
   Seq Library    Outq       File       Job        User       User data  *EXC   
    10 *ALL       *ALL       *ALL       *ALL       *ALL       *ALL       *INC   
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
 Press Enter to continue.                                                       
                                                                                
 F3=Exit    F11=Expiration view    F12=Cancel

[ Top of Page | Previous Page | Next Page | Contents | Index ]