'\" t
.\"     Title: hbcixml3
.\"    Author: Micha Lenk <micha@debian.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2012-03-29
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "HBCIXML3" "1" "2012\-03\-29" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
hbcixml3 \- Command line tool to work on data in a HBCI XML file\&.
.SH "SYNOPSIS"
.sp
\fIhbcixml3\fR <command> [options]
.SH "DESCRIPTION"
.sp
The aqhbci\-tool3(1) command can be used to inspect and work on data in HBCI XML files\&. See section FILES for an example file used by AqBanking\&.
.SH "COMMANDS"
.sp
COMMAND may be one of these:
.PP
show
.RS 4
shows the variables used by a given Job (the job name must be given by "\-j")\&.
.RE
.PP
list
.RS 4
lists all available jobs
.RE
.PP
analyze
.RS 4
analyze a log file\&. You can use this to anonymize the log file before sending it as a bug report\&.
.RE
.SH "OPTIONS"
.SS "General Options"
.PP
\-f FILE
.RS 4
the HBCI description file to load (xml\-file) repeat this option for each file to load If this option is omitted the default XML files are loaded
.RE
.PP
\-t TYPE
.RS 4
the type of node inside the XML file use "job" to inspect jobs, "seg" to inspect segments
.RE
.PP
\-hv VER
.RS 4
HBCI version to use (defaults to 210) This effects which XML files will be loaded upons startup (only if no \-f option is given)
.RE
.PP
\-m MODE
.RS 4
security mode to use with "show":
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
DDV (chipcard mode with DDV cards)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
RDH (keyfile mode)
.RE
.RE
.SS "Special Options for "show""
.PP
\-j JOB
.RS 4
name of the job/segment you are interested in
.RE
.PP
\-p
.RS 4
shows even those variables which are automatically preset by the message engine\&. \-P \- shows even those variables which are marked as being hidden
.RE
.PP
\-mv VER
.RS 4
message/job/segment version to show (0 uses the first available)
.RE
.SS "Special Options for "analyze""
.PP
\-\-trustlevel L
.RS 4
the higher this level the more you trust the recipient of the output logfile\&.
.RE
.PP
\-\-analyze F
.RS 4
name of the file to analyze
.RE
.PP
\-ol F
.RS 4
name of anonymized output logfile
.RE
.PP
\-od F
.RS 4
name of anonymized parsed logfile
.RE
.PP
\-os F
.RS 4
name of SWIFT MT940/942 file to export
.RE
.PP
\-\-logfile FILE
.RS 4
use given FILE as log file
.RE
.PP
\-\-logtype TYPE
.RS 4
use given TYPE as log type These are the valid types: stderr (log to standard error channel) file (log to the file given by \-\-logfile) Default is stderr
.RE
.PP
\-\-loglevel LEVEL
.RS 4
set the loglevel Valid levels are: emergency, alert, critical, error, warning, notice, info and debug Default is "warning"\&.
.RE
.SH "EXAMPLES"
.sp
The simplest usage of this program is:
.sp
.if n \{\
.RS 4
.\}
.nf
hbcixml2 show \-j JobDialogInit
.fi
.if n \{\
.RE
.\}
.sp
This shows the properties used by the job "JobInit"\&.
.sp
Other example:
.sp
.if n \{\
.RS 4
.\}
.nf
hbcixml2 show \-t seg \-j Balance
.fi
.if n \{\
.RE
.\}
.sp
shows the response segment of a JobGetBalance\&.
.SH "FILES"
.PP
/usr/share/aqbanking/backends/aqhbci/hbci\&.xml
.RS 4
This file is used by AqBanking to construct HBCI messages\&.
.RE
.SH "BUGS"
.sp
Probably lots, please post them to the mailing list (see Resources below) when you find them\&.
.SH "RESOURCES"
.sp
On the \m[blue]\fBAqBanking mailing lists\fR\m[]\&\s-2\u[1]\d\s+2 you can give kudos to the developers or get answered your questions\&.
.SH "COPYING"
.sp
Copyright (C) Martin Preu\(ss\&. Free use of this software is granted under the terms of the GNU General Public License (GPL)\&.
.sp
The manpage was composed by Micha Lenk and converted by the nifty tool AsciiDoc into a manpage\&.
.SH "AUTHOR"
.PP
\fBMicha Lenk\fR <\&micha@debian\&.org\&>
.RS 4
Author.
.RE
.SH "NOTES"
.IP " 1." 4
AqBanking mailing lists
.RS 4
\%http://lists.aqbanking.de/cgi-bin/mailman/listinfo/aqbanking-user
.RE