2.2.35 udrview
- Jenni Wallin
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
| Option | Description |
|---|---|
| [ -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 |
| [ -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: 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: 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.
|
Return Codes
Listed below are the different return codes for the udrview command:
| Code | Description |
|---|---|
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. |