# DCextra.ctl:E898:Samples User Defined Data
# $Id: DCextra.ctl,v 1.4 2015/01/19 15:29:08 RDA Exp $
# ARCS: $Header: /home/cvs/cvs/RDA_8/src/scripting/lib/collect/SAMPLE/DCextra.ctl,v 1.4 2015/01/19 15:29:08 RDA Exp $
#
# Change History
# 20150119  MSC  Change the factor setting.

=head1 NAME

SAMPLE.DCextra - Samples User Specified Data

=head1 DESCRIPTION

This module performs the extra user-defined samples. Sample files are created
only when the command produces output.

You can add extra commands for collecting data. The report name is specified
as the first argument. It must start with a letter.

  <rda> -XExtra add sample name command ...

The list of extra collection requests can be obtained as follows:

  <rda> -XExtra list

You can remove extra elements selectively from the list as follows:

  <rda> -XExtra delete pos ...

C<pos> represents the position of the element in the list. Alternatively, the
list can be cleared completely by running the following command:

  <rda> -XExtra delete -a

=cut

# Only execute the module in sampling mode
if !${RUN.SAMPLE.N_CURRENT}
 return

# Initialization
var $FACTOR = ${R_FACTOR:1}

# Execute user defined commands
report extra
loop $rec (@{T_SMP})
{var ($ttl,@cmd) = @{$rec}
 report $ttl
 var $cmd = join(' ',map(@cmd,code(quote(determine(last)))))
 call writeCommand($cmd,$FACTOR)
}

=head1 SEE ALSO

L<SAMPLE:DCsample|collect::SAMPLE:DCsample>

=head1 COPYRIGHT NOTICE

Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved.

=head1 TRADEMARK NOTICE

Oracle and Java are registered trademarks of Oracle and/or its
affiliates. Other names may be trademarks of their respective owners.

=cut