2.2.35 udrview

usage: udrview [ -d <delimiter> ] [ -xml ] [ -z ] [ -f | -first <udr nr> ] [ -l | -last <udr nr> ] <decoder> [file...]

udrview enables you to decode a file of UDRs and generate decoded content such as CSV or XML file.

A CSV file includes a table that consists of a header, where the UDR field names are specified, and rows of fields that comprise the UDRs. When using udrview you retrieve UDRs and UDR fields by specifying a UDR range, column numbers, and by using the Unix cut.

An input file may include different UDR types. In the generated output the first column is always the decoded UDR type. A new table header is generated for every decoded UDR type that is not identical to the preceding UDR type.

Example.

A header example:

1 [UDRType: Folder.UltraConfigName.DecoderName], 2 fieldNameA, 3 fieldNameB, 4 fieldNameC, ...

A decoded file example:

header udrType1, field_A, field_B
udrType1, 2, 3
udrType1, 5, 7
...
header udrType2, field_X, field_Y
udrType2, a, b
udrType2, a, c
...
header udrType1, field_A, field_B
udrType1, 45, 66
OptionDescription
[ -d <delimiter> ]

Enter the character that should serve as a delimiter between the UDR fields. Default is a comma (,).

[ -xml ]

To generate the decoded output in the XML format specify xml in the command. Otherwise, CSV is the default output format.

Note!

For practical reasons, field types such as list and set cannot be included in a CSV file. To include these types in the output, use the <xml> parameter in udrview.

[ -z ]

To decode a GZIP compressed file specify its name.

[ -f | -first <udr nr> ]

Enter the number of the UDR in the input file that is the lowest range boundary of the UDRs that you want to decode. See example below.

[ -l | -last <udr nr> ]

Enter the number of the UDR in the input file that has the highest range boundry of the UDRs that you want to decode.

Example.

Consider the following input file:

1,Header 
2,222222,111111
2,111111,444444
2,444444,222222
2,111111,333333
3,Trailer

This file is comprised of a header, four UDRs with A-Number and B-Number, and a trailer.

To generate selected decoded UDRs 2, 3, 4, and 5, run the following command:

$ mzsh mzadmin/<password> udrview Default.Ultra.fileDec asciifile.ascii -f 2 -l 5

UDRs in file: asciifile.ascii

The output is:

1 [UDRType:Default.Ultra.udr],
2 OriginalData,
3 id,
4 A_number,
5 B_number
[Default.Ultra.udr],0x32 ... 
0x0a,2,222222,111111
[Default.Ultra.udr],0x32 ... 
0x0a,2,111111,444444
[Default.Ultra.udr],0x32 ... 
0x0a,2,444444,222222
[Default.Ultra.udr],0x32 ... 
0x0a,2,111111,333333

To generate only specific fields, run:

$ mzsh mzadmin/<password> udrview Default.Ultra.fileDec asciifile.ascii -f 2 -l 5 | cut -d, -f4,5

UDRs in file: asciifile.ascii

The output is:

4 A_number,5 B_number
222222,111111
111111,444444
444444,222222
111111,333333
[file...]

Ā Either specify a file, or a list of files, as an input, or pipe an input from another command.

Example.

$ cat /tmp/afile | mzsh mzadmin/<password> udrview Format.ultraname.decoder



Return Codes

Listed below are the different return codes for the udrview command:

CodeDescription

0

Will be returned if the command was successful.

1

Will be returned if a command line argument error occurs.

2

Will be returned if the input file is not found.

3

Will be returned if the decoder could not be created.

4

Will be returned if the range specified on command line is invalid.

5

Will be returned if the input file is not a valid Gzip file.

6

Will be returned if a decoding error occurs.