NAF - Check Spool File - Function 40

You can check the spool file for consistency.

When you invoke this function, the Check Spool File window appears.

Time 11:57:31        *** Natural Spool Administration ***      Date 2022-04-06 
User SAG                            M e n u                    File 19999/1241 
+----- Check  Spool File 19999/1241 -----+                                     
!                                        !      Information                    
!   1     Report Data Area               !                                     
!   2     Cluster                        !      20 Cross-Reference             
!   3     Relationships                  !      21 Statistics                  
!   4     Sync. Flags for Spool Server   !      22 Look at Spool File          
!   5     NAF Parameter Module           !      23 CALLNAT Handling            
!                                        !                                     
!                                        !                                     
!                                        !                                     
!                                        !      Control Functions              
!                                        !                                     
!                                        !      40 Check Spool File            
!                                        !      41 Logging Data                
!   .     Exit                           !      42 Create Test Reports         
!                                        !      43 Delete Reports by Date      
!   Command / _  /                       !                                     
+----------------------------------------+                                     
Enter command, or press a PF-key.                                              
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Menu  Exit  Repor Clust Relat Sync. NAF P                   Canc   

This function can be useful if reports with status INCO are detected. You can select report data areas to be checked for consistency.

The Cluster function can be deactivated.

This document covers the following topics:


Report Data Area - Function 40.1

When you invoke this function, the following checks are performed for each record with status In Use which has a pointer to another group:

  • Whether the group exists to which the record points:

    • If the group does not exist, the Check Spool File function issues a corresponding error message.

    • If the group exists, the check below is performed.

  • Whether the status of the record is equal to In Use:

    • If the status is not equal to In Use, the Check Spool File function issues a corresponding error message.

    • If the status is equal to In Use, the check below is performed.

Time 11:57:31        *** Natural Spool Administration ***      Date 2022-04-06 
User SAG                            M e n u                    File 19999/1241 
+----- Check  Spool File 19999/1241 -----+                                     
!                                        !      Information                    
! +------------------------------------+ !                                     
! I Records 2851 - 3000 completed.     I !      20 Cross-Reference             
! +------------------------------------+ !      21 Statistics                  
! +------------------------------------+ !      22 Look at Spool File          
! I Check completed normally.          I !      23 CALLNAT Handling            
! +------------------------------------+ !                                     
!                                        !                                     
!                                        !                                     
!                                        !      Control Functions              
!                                        !                                     
!                                        !      40 Check Spool File            
!                                        !      41 Logging Data                
!   .     Exit                           !      42 Create Test Reports         
!                                        !      43 Delete Reports by Date      
!   Command / 1  /                       !                                     
+----------------------------------------+                                     
Press ENTER to continue.                                                       
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Menu  Exit  Repor Clust Relat Sync. NAF P                   Canc   

In case of an error, a protocol is written to the spool file. You will then be asked for the name of a logical printer.

Cluster - Function 40.2

When you invoke this function, the integrity of the clusters is checked.

Note:
Usage of clusters can be deactivated with Function 30.5. In this case, Function 40.2 cannot be invoked.

This function reads all objects and checks whether they belong to existing clusters. It also checks whether each object belongs to exactly one cluster.

Time 11:57:31        *** Natural Spool Administration ***      Date 2022-04-06 
User SAG                            M e n u                    File 7/411      
+------- Check  Spool File 7/411 --------+                                     
!                                        !      Information                    
!   1     Report Data Area               !                                     
!   2     Cluster                        !      20 Cross-Reference             
!   3     Relationships                  !      21 Statistics                  
! +------------------------------------+ !      22 Look at Spool File          
! I Check completed normally.          I !      23 CALLNAT Handling            
! +------------------------------------+ !                                     
!                                        !                                     
!                                        !                                     
!                                        !      Control Functions              
!                                        !                                     
!                                        !      40 Check Spool File            
!                                        !      41 Logging Data                
!   .     Exit                           !      42 Create Test Reports         
!                                        !      43 Delete Reports by Date      
!   Command / 2  /                       !                                     
+----------------------------------------+                                     
Press Enter to continue.                                                       
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Menu  Exit  Repor Clust Relat Sync. NAF P Commo Statu       Canc

In case of an error, a protocol is written to the spool file. You will then be asked for the name of a logical printer.

Relationships - Function 40.3

When you invoke this function, the Check/Recover Relationships window appears.

Time 11:57:31        *** Natural Spool Administration ***      Date 2022-04-06 
User SAG                            M e n u                    File 19999/1241 
+---- Check/ Recover  Relationships -----+                                     
!                                        !      Information                    
!   1     Check                          !                                     
!   2     Recover with confirmation      !      20 Cross-Reference             
!   3     Recover without confirmation   !      21 Statistics                  
!                                        !      22 Look at Spool File          
!                                        !      23 CALLNAT Handling            
!                                        !                                     
!                                        !                                     
!                                        !                                     
!   .     Exit                           !      Control Functions              
!                                        !                                     
!                                        !      40 Check Spool File            
!                                        !      41 Logging Data                
!                                        !      42 Create Test Reports         
!                                        !      43 Delete Reports by Date      
!   Command / _  /                       !                                     
+----------------------------------------+                                     
Enter command, or press a PF-key.                                              
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Menu  Exit  Check Recov Recov                               Canc   

You can choose whether you want to check the relationships (Option 1) or whether you want to recover them with or without confirmation (Options 2 and 3).

The following checks are performed for all three options:

  • First, a bottom-to-top check is performed. The check starts with physical printers. Next, all allocations, logical printers and user profiles are checked. However, you can specify that the check is to start with a specific object type. For example, when you specify logical printer as start object, only the relation between logical printers and user profiles is checked. For each object, a check is made whether it is referenced in one of the corresponding object types. If this is not the case, this object may be deleted.

  • Next, a top-to-bottom check is performed. The check starts with user profiles. A check is made whether the objects referenced in this object exist on the spool file. If not, this is either logged (see Option 1) or the object is modified (see Option 2 and Option 3).

Since this function causes a large number of Adabas calls, it should only be started when an error occurs (for example, unexplainable printouts on wrong devices). It is recommended that you first use Option 1 (check).

Check Relationships - Option 1

When you select this option, you can choose a start value for the bottom-to-top check in a window: printer(s), allocation table or logical printer(s).

Time 11:57:31        *** Natural Spool Administration ***      Date 2022-04-06 
User SAG                            M e n u                    File 19999/1241 
+---- Check/ Recover  Relationships -----+                                     
! Select type for start bottom-top check !      Information                    
!                                        !                                     
!   1      Printer                       !      20 Cross-Reference             
!   2      Allocation Table              !      21 Statistics                  
!   3      Logical Printer               !      22 Look at Spool File          
!                                        !      23 CALLNAT Handling            
!                                        !                                     
!                                        !                                     
!                                        !                                     
!                                        !      Control Functions              
!   .     Exit                           !                                     
!                                        !      40 Check Spool File            
!                                        !      41 Logging Data                
!                                        !      42 Create Test Reports         
!                                        !      43 Delete Reports by Date      
!   Type    / _ /                        !                                     
+----------------------------------------+                                     
Enter command, or press a PF-key.                                              
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Menu  Exit   Prin  Allo  Logi                               Canc   

The result of the check is printed. You are asked for the name of a logical printer.

Recover Relationships with Confirmation - Option 2

When you select this option, you can choose a start value for the bottom-to-top check in a window: printer(s), allocation table or logical printer(s).

The relationship is checked. Objects that are not related to another object are deleted. Objects that refer to non-existing objects are modified. You have to confirm the deletion/modification for each object.

Recover Relationships without Confirmation - Option 3

When you select this option, you can choose a start value for the bottom-to-top check in a window: printer(s), allocation table or logical printer(s).

The relationship is checked. Objects that are not related to another object are automatically deleted. Objects that refer to non-existing objects are automatically modified. You are not asked to confirm the deletion/modification for each object.

Synchronize Flags for Spool Server - Function 40.4

The spool server options you specify (see Function 30.5) result in a synchronization of the spool file. To prevent different spool servers that are currently working on the spool file from executing the same function, the spool server records the date and time when a function was executed. Before a spool server executes the same function once more, it checks whether the defined time interval has passed.

When you invoke Function 40.4, the Server Synchronization screen appears:

Time 12:04:11        *** Natural Spool Administration ***      Date 2022-04-06 
User SAG                    Server Synchronization             File 19999/1241 
                                                                               
Cmd Server               current      Time  Last check executed    Next check  
    Option               Status       Int.  at NAT-/CPU-Time       for object  
--- -------------------  ------------ ----- -------------------    ----------- 
    Delete reports                           2012-10-18 07:54:23               
 _  by Retention period  deactived    0      2012-10-18 05:54:23   unused      
                                                                               
    Start reports in                         2017-03-03 15:01:09               
 _  status WAIT          activated    10     2017-03-03 13:01:09   unused      
                                                                               
                                                             
 _                       unused       __     --         --              
                                                                               
                                                                                   
 _                       unused       __     --         --               
                                                                               
 _                       unused       __     --         --     

    
Enter a command, or press a PF-key.                                            
Command ===>                                                                   
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help  Menu  Exit                                                  Canc   

For each spool server option listed, you can delete the date and time of the last check, assign the current date and time, or delete the start value for the next object check.

The following line commands are available:

R    Reset the values in the Last Check fields to the current date and time.
D Delete the time and date values in the Last Check fields.
O Delete the value in the Next Check field.