.\"Man page for condor_transform_ads 
.\"Generated by makeman on Tue May 29 00:38:53 2018
.TH condor_transform_ads  1 "May 2018"
.SH Name
.P
condor_transform_ads Transform \- ClassAds according to specified rules, and output the transformed ClassAds. 
.P

.SH Synopsis
condor_transform_ads [-help [rules]] 
.P
condor_transform_ads-rules rules-file[-in[:<form>] infile] [-out[:<form>[, nosort]] outfile] [<key>=<value>] [-long] [-json] [-xml] [-verbose] [-terse] [-debug] [-unit-test] [-testing] [-convertoldroutes] [infile1 ...infileN] 
.P
Note that exactly one rules file, and at least one input file, must be specified. If no output file is specified, output will be written to  stdout . 
.P
.SH Description
.P
condor_transform_adsreads ClassAds from a set of input files, transforms them according to rules defined in a rules file, and outputs the resulting transformed ClassAds. 
.P
See https://htcondor-wiki.cs.wisc.edu/index.cgi/wiki?p=TjsAdTransformLanguagefor a description of the transform language. 
.P
.SH Options
.P

.B -help [rules]
.IP "" 3
Display usage information and exit. -help rulesdisplays information about the available transformation rules. 
.IP "" 3
.P
.B -rules rules-file
.IP "" 3
Specifies the file containing definitions of the transformation rules. 
.IP "" 3
.P
.B -in[:<form>] infile
.IP "" 3
Specifies an input file containing ClassAd(s) to be transformed. <form>, if specified, is one of: 
.IP "" 6
* long: traditional long form (default) 
.IP "" 6
* xml: XML form 
.IP "" 6
* json: JSON ClassAd form 
.IP "" 6
* new: "new" ClassAd form without newlines 
.IP "" 6
* auto: guess format by reading the input If  - is specified for infile, input is read from  stdin . 
.IP "" 3
.P
.B -out[:<form>[, nosort] outfile
.IP "" 3
Specifies an output file to receive the transformed ClassAd(s). <form>, if specified, is one of: 
.IP "" 6
* long: traditional long form (default) 
.IP "" 6
* xml: XML form 
.IP "" 6
* json: JSON ClassAd form 
.IP "" 6
* new: "new" ClassAd form without newlines 
.IP "" 6
* auto: use the same format as the first input ClassAds are storted by attribute unless nosortis specified. 
.IP "" 3
.P
.B [<key>=<value>]
.IP "" 3
Assign key/value pairs before rules file is parsed; can be used to pass arguments to rules. (More detail needed here.) 
.IP "" 3
.P
.B -long
.IP "" 3
Use long form for both input and output ClassAd(s). (This is the default.) 
.IP "" 3
.P
.B -json
.IP "" 3
Use JSON form for both input and output ClassAd(s). 
.IP "" 3
.P
.B -xml
.IP "" 3
Use XML form for both input and output ClassAd(s). 
.IP "" 3
.P
.B -verbose
.IP "" 3
Verbose mode, echo transform rules as they are executed. 
.IP "" 3
.P
.B -terse
.IP "" 3
Disable the -verboseoption. 
.IP "" 3
.P
.B -debug
.IP "" 3
More information needed here. 
.IP "" 3
.P
.B -unit-test
.IP "" 3
More information needed here. 
.IP "" 3
.P
.B -testing
.IP "" 3
More information needed here. 
.IP "" 3
.P
.B -convertoldroutes
.IP "" 3
More information needed here. 
.IP "" 3
.P

.SH Exit Status
.P
condor_transform_adswill exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. 
.P
.SH Examples
.P
Here's a simple example that transforms the given input ClassAds according to the given rules: 
.P


.br
 # File: my_input
.br
 ResidentSetSize = 500
.br
 DiskUsage = 2500000
.br
 NumCkpts = 0
.br
 TransferrErr = false
.br
 Err = "/dev/null"
.br

.br
 # File: my_rules
.br
 EVALSET MemoryUsage ( ResidentSetSize / 100 )
.br
 EVALMACRO WantDisk = ( DiskUsage * 2 )
.br
 SET RequestDisk ( $(WantDisk) / 1024 )
.br
 RENAME NumCkpts NumCheckPoints
.br
 DELETE /(.+)Err/
.br

.br
 # Command:
.br
 condor_transform_ads  -rules my_rules -in my_input
.br

.br
 # Output:
.br
 DiskUsage = 2500000
.br
 Err = "/dev/null"
.br
 MemoryUsage = 5
.br
 NumCheckPoints = 0
.br
 RequestDisk = ( 5000000 / 1024 )
.br
 ResidentSetSize = 500
.P
.SH Author
Center for High Throughput Computing, University of Wisconsin-Madison 
.SH Copyright
Copyright (C) 1990-2016 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.