Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

MAREN service accounting

&pagelevel(3)&pagelevel

The MAREN system provides a means of charging for certain volume archiving services. It can produce accounting records for:

  • reserved computer center tapes (service type 430);

  • archived foreign tapes (service type 430);

  • exporting volumes (service type 432).

By specifying an accounting period in the MARENADM statement WRITE-ACCOUNTING-RECORDS (using the FROM-DATE and TO-DATE operands), it is possible to evaluate the current MAREN catalog and if necessary an additional logging file (specified in the LOGGING-FILE operand). The resulting accounting records are written to a SAM file (OUTPUT-FILE operand).

MAREN generates accounting records as follows:

  • The current MAREN catalog is first evaluated. Thus accounting records are generated for service types 430 and 431. In addition to the user ID and account number, these records include information on the reservation period (beginning, end, and number of days). If the reservation period lies outside the accounting period, the start and end date are specified.

  • If a logging file is specified, accounting records are then generated for magnetic tapes and disks which were reserved during the accounting period but which have since been released or reallocated. The information in the logging file is also used to produce accounting records for service type 432 if a computer center volume has been exported using the EXPORT-VOLUME statement or a private volume has been returned. The start and end date are taken from the EXPORT-DATE, and the number of days is set to “1”.

Format of the accounting records

Field no.OffsetLength (bytes)FormatMeaning
hex.dec.
10004BRecord length field (X'00734040')
20442ARecord type (C'H4')
30668ASystem (C'41AR'BLANK''BLANK''BLANK''BLANK'')
40E148AUser ID from the catalog entry
516228AAccount number from the catalog entry
61E308AUser configuration (blanks)
726388AReserved (blanks)
82E468AJob name (blanks)
936541AAccounting type (blanks)
1037558AStart date in the format ddmmyyyy
113F634AStart time in the format hhmmss
1243678AEnd date in the format ddmmyyyy
1348754AEnd time in the format hhmmss
144F793APerformance type (C'430', C'431' or C'432')
1552828ANumber of days in the accounting period in the format C''BLANK''BLANK''BLANK''BLANK''BLANK''BLANK'nn'
165A904ATSN (blanks)
175E947AFill characters (blanks)
186510114AComment in the format C'aaaaaa/mm.yyyy'
aaaaaa: rchive number (VSN)
mm.yyyy: month and year of expiration date

Corresponding fields in the COBOL structure of RAV V5.0

Field no.MeaningField name in the COBOL structure
1Record length field (X'00734040')
2Satzart (C'H4')HA-KA
3System (C'41AR'BLANK''BLANK''BLANK''BLANK'')HA-CPUID/ HA-KF-KEY
4User ID from the catalog entryUSERID
5Account number from the catalog entryHA-ACCNR
6User configuration (blanks)HA-BRKF
7Reserved (blanks)HA-ACCID
8Job name (blanks)HA-JOB-NAME
9Accounting type (blanks)HA-VERR-ART
10Start date in the format ddmmyyyyHA-VON-DATUM/HA-START-DATUM
11Start time in the format hhmmssHA-VON-ZEIT/HA-START-ZEIT
12End date in the format ddmmyyyyHA-BIS-DATUM/HA-ENDE-DATUM
13End time in the format hhmmssHA-BIS-ZEIT/HA-ENDE-ZEIT
14 Activity (C'430', C'431' oder C'432')HA-LEIST-ART
15Number of days in the accounting period in the format C''BLANK''BLANK''BLANK''BLANK''BLANK''BLANK'nn'HA-MENGE
16TSN (blanks)HA-FILLER
17Fill characters (blanks)TSN
18Comment in the format C'aaaaaa/mm.yyyy'
aaaaaa: archive number (VSN)
mm.yyyy: month and year of expiration date
HA-BEMERKUNG