MODIFY command: Syslog Daemon

Use the MODIFY command to control the syslog daemon functions from the operator console.

Format


>>-+-MODIFY-+--procname,-+-ARCHIVE---------------------------------+-><
   '-F------'            +-DISPLAY,ARCHIVE-+---------------------+-+   
                         |                 |          .-,MAX=5-. | |   
                         |                 '-,DETAIL--+--------+-' |   
                         |                            +-,MAX=n-+   |   
                         |                            '-,MAX=*-'   |   
                         '-RESTART---------------------------------'

Parameters

procname: The member name of the cataloged procedure that is used to start the syslog daemon.
ARCHIVE: Perform an immediate archive of UNIX file-system files that are defined by syslogd configuration rules. When the rule for the destination file includes the -N parameter and is preceded by the BeginArchiveParms statement, that file is archived. When the rule for the destination file includes the -X parameter, the contents of that file are deleted.
If a previously initiated archive is already in progress, an additional archive does not occur, and message FSUM1256 is issued to the console. The previously initiated archive might have been initiated by an ARCHIVE command, a time-of-day-based archive, or a file-system threshold-based archive.
DISPLAY,ARCHIVE: Display UNIX file-system use data for file systems that have output destination files defined by syslogd configuration rules. Capacity percentages are displayed for each file system. If you specify the DETAIL parameter, the largest files for that file system are displayed. The MAX parameter controls the number of files that are displayed for the detail report. The default value for MAX is 5; the maximum value is 65 535. If you specify an asterisk (*) then all files are displayed.
RESTART: Indicates that the syslogd configuration file should be reread. The result is similar to sending a SIGHUP signal to syslogd. Syslogd attempts to finish writing all pending output to the appropriate destinations before rereading the configuration file. If any output cannot be written within 30 seconds, the appropriate destination is marked as unreachable and any output pending for that destination is discarded.
If a previously initiated restart is already in progress, an additional restart is not performed, and message FSUM1256 is issued to the console. The previously initiated restart might have been initiated by a RESTART command or a SIGHUP signal.

Examples

The following command causes syslogd to reread its configuration file.

F SYSLOGD,RESTART
FSUM1254 SYSLOGD MODIFY COMMAND ACCEPTED 
FSUM1252 SYSLOGD RECONFIGURATION COMPLETE

The following command causes syslogd to archive all UNIX file-system files that are defined by syslogd configuration rules.

F SYSLOGD,ARCHIVE
FSUM1254 SYSLOGD MODIFY COMMAND ACCEPTED 
FSUM1260 SYSLOGD ARCHIVE COMPLETE FOR 2 FILES

The following commands cause syslogd to display UNIX file system utilization data.

F SYSLOGD,DISPLAY,ARCHIVE

FSUM1267 FILE SYSTEM SUMMARY 387                                 
NAME=OMVS.VAR.HFS                                                
PATH=/SYSTEM/var                                                 
512-BLOCKS=    177120 USED=    108592 AVAIL=     68528 USAGE= 61%
NAME=OMVS.VAR.LOGS.HFS                                           
PATH=/SYSTEM/var/logs                                            
512-BLOCKS=     60480 USED=     60096 AVAIL=       384 USAGE= 99%

F procname,DISPLAY,ARCHIVE,DETAIL

FSUM1268 FILE SYSTEM DETAILS 390                                 
NAME=OMVS.VAR.HFS                                                
PATH=/SYSTEM/var                                                 
512-BLOCKS=    177120 USED=    108592 AVAIL=     68528 USAGE= 61%
   FILE SIZE USAGE ARCHIVE PATH                                  
       21214   12% NONE    /var/logu/daemon/daemon.trace         
       20359   11% NONE    /var/logu/daemon/daemon.log           
       13133    7% SEQ     /var/logu/all/all.logseq              
       13133    7% SEQ     /var/temp/tempfull.log                
       12900    7% SEQ     /var/logu/pagent/pagent.logseq        
5 OF 24 RECORDS DISPLAYED                                        
NAME=OMVS.VAR.LOGS.HFS                                           
PATH=/SYSTEM/var/logs                                            
512-BLOCKS=     60480 USED=     60096 AVAIL=       384 USAGE= 99%

F procname,DISPLAY,ARCHIVE,DETAIL,MAX=2

FSUM1268 FILE SYSTEM DETAILS 393                                 
NAME=OMVS.VAR.HFS                                                
PATH=/SYSTEM/var                                                 
512-BLOCKS=    177120 USED=    111664 AVAIL=     65456 USAGE= 63%
   FILE SIZE USAGE ARCHIVE PATH                                  
       21218   12% NONE    /var/logu/daemon/daemon.trace         
       20363   11% NONE    /var/logu/daemon/daemon.log           
2 OF 24 RECORDS DISPLAYED                                        
NAME=OMVS.VAR.LOGS.HFS                                           
PATH=/SYSTEM/var/logs                                            
512-BLOCKS=     60480 USED=     60096 AVAIL=       384 USAGE= 99%