The name of the accounting file may be determined either by means of the parameter service at system initialization or during the session.
System initialization
The accounting system can be activated during system initialization if the necessary statements are issued via the parameter service. Activation of the accounting system in connection with the parameter service is described in section "Starting the accounting system (ACCOUNT)".
BS2000 session
Systems support can activate the accounting routine during a BS2000 session by means of the START-ACCOUNTING command. This may be useful, for example, if the accounting system was temporarily deactivated for testing purposes. If the current accounting file is to be analyzed, the CHANGE-ACCOUNTING-FILE command is issued to close the current accounting file and open a new one.
Automatic file name generation
Accounting file names may be automatically generated by the system. The file name consists of the prefix $TSOS.SYS.ACCOUNT. and the suffix yy.mm.dd.xxx.nn or yyyy-mm-dd.xxx.nn (these being valid for all logging procedures, see the name of the logging file CONSLOG and the SERSLOG file)
where:
yyyy-mm-dd | is the date on which the accounting file is created |
xxx | is the number of the current session |
nn | is the serial number of accounting file |
Systems support can change the $TSOS.SYS.ACCOUNT prefix setting if specific data center naming conventions have to be observed.
If a partially qualified file name is specified, the following applies:
The suffix described above is automatically appended to any partially qualified file name. Taking into account the suffix length, a partially qualified file name (without user ID) must not exceed 26 characters; if a catalog ID has more than one character, this maximum length is reduced by the additional number of characters in the catalog ID.
If the user ID is omitted, $TSOS. is automatically prefixed to the file name.
If a partially qualified file name includes just the user ID, it is extended to $userid.SYS.ACCOUNT.<date>.xxx.nn (<date>= yy.mm.dd or yyyy-mm-dd).
Possible errors on activation of the accounting system
If syntax errors occur in the parameter records during system initialization, an error routine of the parameter service issues a console message requesting the operator to either correct or ignore the error.
The accounting system issues a FILE macro for the file to be opened. If this results in an error, an accounting file with the default name
$TSOS.SYS.ACCOUNT.<date>.xxx.nn and appropriate default attributes is created.This also applies if the file to be opened already exists and has been cataloged with the protection attribute ACCESS=READ. This is important when converting earlier operating system versions, as older accounting files were always cataloged with ACCESS=READ.
After a maximum of three unsuccessful attempts to open the file with the default name, a message appears on the console (no response required) and BS2000 is loaded without the accounting system. Systems support can then activate the accounting system during the session by issuing an appropriate command.