TL (Transfer Log)

The TL (Transfer Log) command releases the current system log file and starts a new one. The space allocation factors for the new file (the number of rows and the number of records per row) can be changed if so desired. The space allocation factors for the current system log can also be displayed.

Syntax

Explanation

TL

Releases the current SUMLOG and SECURITYLOG files, and starts new ones with the same space allocation factors as the released files. The current files reside on the DL LOG family. The space allocation factors are the AREAS and AREASIZE file attributes, as described in the File Attributes Programming Reference Manual.

When a TL command results in new log files, the previous log files are named as follows: 

SUMLOG/<system number>/<mmddyy>/<number>
SECURITYLOG/<system number>/<mmddyy>/<number>

In these file names, <number> is a log serial number from 000001 through 065535. A cold-start resets the log serial number back to 000001. To relate the two log files as unambiguously as possible, the number used for the current SUMLOG is also used for the current SECURITYLOG. The number is not computed independently for the two files.

The security-related file attributes of the old files are automatically transferred to the corresponding new files.

TL *

Displays the values of the space allocation factors of the current SUMLOG and SECURITYLOG. The display includes:

  • The number of rows (which corresponds to the AREAS file attribute)

  • The number of physical records per row (which corresponds to the AREASIZE file attribute). A physical record contains 30 words.

  • The maximum recommended size for a logical log record

  • The maximum supported size for a logical log record

TL ROWS <number>

TL RECORDS <number>

TL ROWS <number> RECORDS <number>

Releases the current SUMLOG and SECURITYLOG files and starts new ones with the specified space allocation factors, where

  • The ROWS parameter corresponds to the AREAS file attribute, and can range from 25 to 1023.

  • The RECORDS parameter corresponds to the AREASIZE file attribute and specifies the number of physical records per area. A physical record contains 30 words. The RECORDS parameter can range from 4000 to 64000, in multiples of 1000.

The new SUMLOG and SECURITYLOG files receive a title and security-related attributes as previously described for the simple TL form of the command.

Examples

Example 1

This example releases the current SUMLOG and SECURITYLOG files and creates new ones: 

TL
  10207 10:51 PK353 *SYSTEM/SUMLOG CHANGED TO
        *SUMLOG/227/030204/000011 ON DISK
  10207 10:51 PK353 *SYSTEM/SECURITYLOG CHANGED TO
        *SECURITYLOG/227/030204/000011 ON DISK

Example 2

This example displays the values space allocation factors of the current SUMLOG and SECURITYLOG files: 

TL *
   SUMLOG and SECURITYLOG Factors are as follows:
   Rows                               :        140
   Physical log records per row       :      2,000
   Maximum recommended log entry size :      58,001 words
   Maximum supported log entry size   :   1,048,554 words

Example 3

This example releases the current SUMLOG and SECURITYLOG files and creates new ones with 650 rows and 7000 records per row: 

TL ROWS 650 RECORDS 7000
   SUMLOG and SECURITYLOG Factors are as follows: 
   Rows                               :       650
   Physical log records per row       :     7,000
   Maximum recommended log entry size :   203,001 words
   Maximum supported log entry size   : 1,048,554 words
  
  10252 10:55 PK353 *SYSTEM/SUMLOG CHANGED TO 
     *SUMLOG/227/030204/000012 ON DISK
  10252 10:55 PK353 *SYSTEM/SECURITYLOG CHANGED TO 
     *SECURITYLOG/227/030204/000012 ON DISK
Prev  Up  Next
TI (Times)  Home  TR (Time Reset)