General
Application area: | Accounting (system administration macro); see "Accounting" and 172 | |
Macro type: | Definition macro; see "Types of macro" |
Macro description
The macro ARDS generates a dummy section (DSECT) that serves to describe the structure of those accounting records which are created and written to the accounting file by the BS2000 accounting system. The accounting records are referred to by their record identifiers (e.g. UDAT, UACC, DSPC) and are described in the “Accounting records” manual [13 (Related publications)].
A user wishing to obtain the structure of an accounting record that was created by a decoupled subsystem can request the structure of this record, depending on the current subsystem version.
The user can specify whether the macro describes the structure of all the accounting records, or a selection of them, or just a single record.
Macro format and description of operands
[name] ARDS |
ALL / id / (id,id,...) ,DRV=OLD / NEW ,DSSM=OLD / NEW ,FT=OLD / NEW ,SPOOL=OLD / NEW ,UTM=OLD / NEW ,VM=OLD / NEW ,HSMS=OLD / NEW |
name
Name of the generated DSECT. Default setting: name = ARDSECT.
ALL
The macro refers to all the accounting records.
id
Record identifier of the accounting record to be described.
(id,id,...)
List of record identifiers of the required accounting records.
The list must be specified in parentheses.
DRV=
Specifies the version-dependent structure of an accounting record that was created via the DRV subsystem (Dual Recording by Volume).
OLD
The structure is determined by the subsystem version that was known to the accounting system when the accounting record was transferred.
If no other version of the subsystem was transferred and loaded in the meantime, this structure is the same as the current one.
NEW
The structure is determined by the subsystem version that is currently loaded and is therefore always current.
If another subsystem version was transferred and loaded after transfer of the accounting records, the structure of the accounting records corresponds to the version that was unloaded (the “old” version) and not the “new” subsystem version that was loaded when ARDS was called. If NEW is specified, therefore, the caller must ensure that the current subsystem macro library ( .GCLIB.UR ) is known to the assembler (SET-TASKLIB command - see “Commands” manual [19 (Related publications)], or COMPILE MACRO-LIBRARY=... statement in the compiler program - see “ASSEMBH” manual [2 (Related publications)]).
DSSM=
Specifies the version-dependent structure of an accounting record that was created via the DSSM subsystem (Dynamic Subsystem Management).
OLD
Operand description as for DRV operand above.
NEW
Operand description as for DRV operand above.
FT=
Specifies the version-dependent structure of an accounting record that was created via the FT subsystem (File Transfer).
OLD
Operand description as for DRV operand above.
NEW
Operand description as for DRV operand above.
HSMS=
Specifies the version-dependent structure of an accounting record which was created via the HSMS subsystem (Hierarchical Storage Management System).
OLD
Operand description as for DRV operand above.
NEW
Operand description as for DRV operand above.
SPOOL=
Specifies the version-dependent structure of an accounting record that was created via the SPOOL subsystem (Simultaneous Peripheral Operation Online).
OLD
Operand description as for DRV operand above.
NEW
Operand description as for DRV operand above.
UTM=
Specifies the version-dependent structure of an accounting record that was created via the UTM subsystem (Universal Transaction Monitor).
OLD
Operand description as for DRV operand above.
NEW
Operand description as for DRV operand above.
VM=
Specifies the version-dependent structure of an accounting record that was created via the VM subsystem (Virtual Memory).
OLD
Operand description as for DRV operand above.
NEW
Operand description as for DRV operand above.
Notes on the macro call
FT=NEW:may only be specified for an FT subsystem >= V5.0.
UTM=NEW:may only be specified for a UTM subsystem >= V3.3.
HSMS=NEW: The value NEW must be specified in order to obtain the DSECT for HSMS.
The structure of an accounting record can be created only once for each assembler module, otherwise name conflicts occur.