SMF Accounting

Control‑D produces several types of SMF records that provide comprehensive accounting and chargeback information.

• An SMF record for each printed report is produced during deferred printing. The record number is specified in parameter SMF=nnn in member CTDPARM in the IOA PARM library. The record can be disabled by setting SMF to NO in member CTDPARM. The structure of the record is described in macro CTDSMF in the IOA MAC library. Control‑D Exit CTDX006 receives each record before it is written to SMF files. The exit can change or add fields to the record.
• An SMF record can be produced for each printed report during immediate printing. This is triggered by Optional Wish WD0892 in member IOADFLT in the IOAENV library or IOADFLTL in the PARM library. The record number and structure are identical to those provided for deferred printing.
• An SMF record describing activity of an online user is written during logoff operation performed under the IOA online monitor. The record contains CPU/EXCP consumed by the current user and also the number of performed operations (view, print, restore and delete requests). The structure of the record is described in macro CTDSFO in the IOA MAC library. The SMF ID of the record is defined by the SMFONL parameter in the IOAPARM parameter member. The parameter value can be changed using the following steps in the IOA Customization facility of ICE:
  • Major Step: 1 IOA Post-Installation
  • Minor Step: 1 Update IOA Parameters
  • Minor Step: 4 Parameter Verification
  • Minor Step: 5 Save Parameters into Product Libraries

  The record can be changed or discarded by IOA Exit IOAX006 before it is written to SMF under SMF function.

• An SMF record created during a decollation process contains the number of pages and lines processed by a decollation mission, the CPU utilized by it, the number of report entries built, and so on. The structure of the record is described in macro CTDSF2 in the IOA MAC library. The record can be changed or discarded by the Control-D Exit CTDX022D before it is written to SMF. The SMF ID of the record is defined by the SMFDEC parameter in the CTDPARM parameter member. The parameter value can be changed using the following steps in the Control-D Customization facility of ICE:
  • Major Step: 1 CTDPARM Post-Installation
  • Minor Step: 1 CONTROL-D Operational Parameters
  • Minor Step: 8 Parameter Verification
  • Minor Step: 9 Save Parameters into Product Libraries
• An SMF record is produced when each request from the IOASMON CDAM Archive Server completes execution. The SMF record number is specified in parameter SMF=nnn in the IOASPRM member in the IOA PARM library. Generation of this SMF record can be disabled by setting SMF=NO in the IOASPRM member. The structure of this SMF record is described in macro CTVSMF in the IOA MAC library. Control‑V Exit CTVX002 receives each record before it is written to the SMF file. The exit can add or change fields in the record and can prevent the record from being written.
• An SMF record describing activity of Control-D/WebAccess user is written by Control-D Application Server. The record contains CPU consumed by the current user and also the number of operations performed (view, print and restore requests). The structure of the record is described in macro CTDPSMF in the IOA MAC library. The SMF ID of the record is defined by the SMFWA parameter in the CTDPARM parameter member. The parameter value can be changed using the following steps in the CTD Customization facility of ICE:
  • Major Step: 1 CTDPARM Post-Installation
  • Minor Step: 1 CONTROL-D Operational Parameters
  • Minor Step: 8 Parameter Verification
  • Minor Step: 9 Save Parameters into Product Libraries.

  The record can be changed or discarded by IOA Exit CTDX024 before it is written to SMF under SMF function.

• All SMF recording options are shown in the following table:

  Table 178b SMF recording options

  Process	SMF parameter	IOA PARM Member	Address space	IOA MAC Macro	User Exit before SMF is written	SMF Modify command
  Deferred Printing	SMF	CTDPARM	CTDPRINT Control-D Print Monitor	CTDSMF	CTDX006	No
  Immediate Printing	SMF WD0892	CTDPARM IOADFLTL	IOAOMON IOA Online Monitor, TSO session
  Decollation Mission	SMFDEC	CTDPARM	CTDTROLD Control-D Monitor	CTDSF2	CTDX022	Yes
  Online User Activity	SMFONL	IOAPARM	IOA Online Monitor, TSO session	CTDSMFO	IOAX006	Yes
  CTD/WA User Activity	SMFWA	CTDPARM	IOAAS Control-D Application Server	CTDSMFW	CTDX024	Yes
  Archive Activity	SMFV	IOASPRM	IOASMON CDAM Archive Server	CTVSMF	CTVX002	No

The SMF modify command allows the Control-D Decollation Monitor, IOA Online Monitor and Control-D Application Server to re-activate the SMF recording after error. This way SMF recording can be activated again without requiring the corresponding address spaces to be restarted.

The SMF modify operator command syntax for Control-D Decollation Monitor and IOA Online Monitor is as follows:

F asname,SMF

where asname is the address space name.

The SMF modify operator command syntax for Control-D Application Server is as follows:

F IOAGATE,MODASID=nn MODAPPL D SMF

where nn is the decimal sequential ASID number of the Control-D Application Server address space to which the modify command is submitted. The modify command is broadcast to all active Application Server address spaces if the ASID number ‘=nn’ is omitted.