The -auto qualifier turns off any prompting of the user. The program will run with the default settings that are defined in the ACD file. If a parameter does not have a default value but a value is required, the program will terminate with an error message.

The first example below shows seqret being run without the -auto qualifier. The program prompts the user for an output filename as the output sequence is a mandatory parameter. It presents the user with a prompt and a default output filename constructed from the name of the first sequence in the input file plus the name of the output format (pdnirsecf.fasta in this example).

In the second example, seqret is run with the -auto qualifier. The user is not queried for the output filename and it will use the default filename (pdnirsecf.fasta) for the output file.

% seqret sequence.seq
output sequence(s) [pdnirsecf.fasta]:

% seqret sequence.seq -auto
%

Turns on logging of debugging messages generated by the application. A debug file is written to the current directory, containing a complete trace of the actions of the program reported by calls to the AJAX function ajDebug(). The file will be called ApplicationName.dbg where ApplicationName is the name of the application.

Consider the following command lines:

In the first command seqret is called using sequence.seq as the first (and only) parameter and -debug instructs the program to turn debugging on. In the second command seqret is run with the same parameter but the -debug qualifier is prefixed with no, thereby instructing the program to turn debugging off. The latter could be useful if debugging was turned on by default in the EMBOSS configuration files or by an environment variable (see Section 2.8, “Maintenance”).

The example below shows the application seqret being run with the -debug and -auto qualifiers. After completion of the program, a file called seqret.dbg is created in the current directory which contains the debug information:

% seqret sequence.seq -debug -auto
% more seqret.dbg
Debug file seqret.dbg buffered:No
ajAcdInitPV pgm 'seqret' package ''
ajFileNewInNameS '/usr/local/share/EMBOSS/acd/seqret.acd'
ajFileNewInNameS '/m2/emboss/emboss/emboss/acd/seqret.acd'
EOF ajReadlinePos file /m2/emboss/emboss/emboss/acd/seqret.acd
closing file '/m2/emboss/emboss/emboss/acd/seqret.acd'
ajFileNewInNameS '/usr/local/share/EMBOSS/acd/codes.english'
ajFileNewInNameS '/m2/emboss/emboss/emboss/acd/codes.english'
EOF ajReadlinePos file /m2/emboss/emboss/emboss/acd/codes.english
closing file '/m2/emboss/emboss/emboss/acd/codes.english'
ajTableNewFunctionLen hint 25 size 251
ajTableNewFunctionLen hint 25 size 251
ajTableNewFunctionLen hint 25 size 251
ajFileNewInNameS '/usr/local/share/EMBOSS/acd/knowntypes.standard'
ajFileNewInNameS '/m2/emboss/emboss/emboss/acd/knowntypes.standard'
EOF ajReadlinePos file /m2/emboss/emboss/emboss/acd/knowntypes.standard
closing file '/m2/emboss/emboss/emboss/acd/knowntypes.standard'
Set acdprotein value '$(sequence.protein)'
ajSeqinClear called
++seqUsaProcess 'ops2.fasta' 0..0(N) '' 0 
USA to test: 'ops2.fasta'

Makes a program behave like a filter, reading its (first) input file from the standard input, and writing its (first) output file to the standard output. The -filter qualifier will also invoke the -auto qualifier, so missing values are never prompted for.

The example below shows seqret being run with the -filter qualifier. The input file is piped into the program using the Unix command cat and the output is piped directly to the Unix program lpr, which will print it on the printer.

% cat sequence.seq | seqret -filter |  lpr

You can get help on how to use a program by specifying the -help qualifier. The help text displayed is taken from information in the ACD file. It will list all the application-specific options and any built-in qualifiers (Section 6.4, “Datatype-specific Command Line Qualifiers”) that are associated with the ACD datatypes. It will show the names of the parameters, their type and a brief informative comment, extracted from the help: ACD attribute (see the EMBOSS Developers Guide).

A second qualifier -verbose may be added alongside the -help qualifier and will give further information. For example, it will list global qualifiers.

Forces the program to prompt for a value for all application options. By default, EMBOSS will prompt for any options that are defined as parameter: or standard: in the ACD file if a value is not given on the command line. -options turns prompting on for options that are defined as additional:; these are not normally prompted for regardless of what's given on the command line.

Consider the following ACD file:

application: seqdemo

sequence: asequence 
[
    parameter: "Y"
]

outseq: outseq 
[
    standard: "Y"
]

integer: outputlength 
[
    additional: "Y"
    default: "20"
    information: "Output length"
]

Possible command lines are as follows:

% seqdemo
Input sequence: sequence.seq
output sequence(s) [pdnirsecf.fasta]: 

% seqdemo -options 
Input sequence: sequence.seq
output sequence(s) [pdnirsecf.fasta]: 
Output length [20]: 10

In the first example seqdemo is run without any parameters and since the asequence is defined as parameter: Y in the ACD file, it queries the user for the input filename. It also queries the user for the output sequence, since that parameter is labelled as being required (standard: Y). It will not ask for a value for the integer variable outputlength, since it is neither labelled as parameter: Y or standard: Y.

In the second example the integer is asked for, since the -options qualifier forces the program to query for those options that are labelled with the additional: attribute.

Changes the default output file to be stdout (normally a terminal on-screen). All the application parameters are still prompted for as normal. This typically includes the output filename, so there is still the option of writing to a file instead.

In the example below the -stdout qualifier changes the default output to be to standard output (the terminal) instead of a file. The output is prompted for, so there is a chance to enter a filename instead. With -auto on the command line, the program would instead write to the terminal without asking:

% seqret -stdout
Input sequence: sequence.seq
output sequence(s) [stdout]: <ENTER>

-stdout makes the first output file default to stdout. Output files include the outfile, outseq, report, align and a few other ACD datatypes (see the EMBOSS Developers Guide).

These qualifiers force the application to generate informative messages, if necessary, to the file stderr (normally the terminal). The messages are of three types: warnings, errors and fatal errors (which are generated when the application must terminate).

In contrast to all other global qualifiers, these qualifiers default to TRUE unless they are unset on the command line or a corresponding environment variable is set to FALSE (see below).

When an environment variable is set, its effect can be cancelled by using the negating action of prefixing no to the corresponding boolean qualifier name Consider the following ACD file:

application: seqdemo
sequence: asequence 
[
    parameter: "Y"
]

outseq: outseq 
[
    parameter: "Y"
]

integer: outputlength 
[
    additional: "Y"
    default: "20"
]

Here are some possible command lines:

% seqdemo
Input sequence: sequence.seq
output sequence(s) [pdnirsecf.fasta]: <ENTER>

% seqdemo -options
Input sequence: sequence.seq
output sequence(s) [pdnirsecf.fasta]: <ENTER>
Output length [20]: 10

% setenv EMBOSS_OPTIONS YES
% seqdemo
Input sequence: sequence.seq
output sequence(s) [pdnirsecf.fasta]: <ENTER>
Output length [20]: 10

% seqdemo -nooptions
Input sequence: sequence.seq
output sequence(s) [pdnirsecf.fasta]: <ENTER>

The first example shows the behaviour without the EMBOSS_OPTIONS environment variable being set. The program seqdemo behaves in the standard way, and only asks for the outputlength parameter when the -options qualifier is used. In the second example the environment variable EMBOSS_OPTIONS is set at the command line and the effect is that it now asks for the outputlength parameter without the -options qualifier being used. The effect of the environment variable is cancelled by using the negating effect of adding the prefix no to the qualifier -options (giving -nooptions).