NAME

       condor_transform_ads - HTCondor Manual

       Transform ClassAds according to specified rules, and output the transformed ClassAds.

SYNOPSIS

       condor_transform_ads [-help [rules] ]

       condor_transform_ads  [-rules rules-file] [-jobtransforms name-list] [-jobroute route-name] [-in[:<form>]
       ** *infile*] [-out[:<form>[, nosort]]  ** outfile] [<key>=<value> ] [-long ] [-json ] [-xml ] [-verbose ]
       [-terse ] [-debug ] [-unit-test ] [-testing ] [-convertoldroutes ] [infile1 ...infileN ]

       Note that one or more transforms must be specified in the form of a rules file  or  a  JOB_TRANSFORM_  or
       JOB_ROUTER_ROUTE_  name  and at least one input file must be specified. Transforms will be applied in the
       order they are given on the command line.  If a rules file has a TRANSFORM statement  with  arguments  it
       must be the last rules file.  If no output file is specified, output will be written to stdout.

DESCRIPTION

       condor_transform_ads reads ClassAds from a set of input files, transforms them according to rules defined
       in a rules files or read from configuration, and outputs the resulting transformed ClassAds.

       See the classads/transforms:Classad Transforms section for a description of the transform language.

OPTIONS

          -help [rules | convert]
                 Display  usage  information  and  exit.  -help  rules  displays information about the available
                 transformation rules. -help convert displays information about the -convertoldroutes option.

          -rules rules-file
                 Specifies the file containing definitions of the transformation rules,  or  configuration  that
                 declares  a  JOB_TRANSFORM_<name>  or  JOB_ROUTER_ROUTE_<name> variable for use in a subsequent
                 -jobtransforms <name> or -jobroute <name> argument.

          -jobtransforms name-list
                 A comma-separated list of more transform names.  The  transform  rules  will  be  read  from  a
                 previous rules file or the configured JOB_TRANSFORM_<name> values

          -jobroute name
                 A  job  route.   The  transform rules will be read from a previous rules file or the configured
                 JOB_ROUTER_ROUTE_<name> values

          -in[:<form>] infile
                 Specifies an input file containing ClassAd(s) to be transformed.  <form>, if specified, is  one
                 of:

                 • long: traditional long form (default)

                 • xml: XML form

                 • json: JSON ClassAd form

                 • new: "new" ClassAd form without newlines

                 • auto: guess format by reading the input
                 If - is specified for infile, input is read from stdin.

          -out[:<form>[, nosort] outfile
                 Specifies  an  output file to receive the transformed ClassAd(s).  <form>, if specified, is one
                 of:

                 • long: traditional long form (default)

                 • xml: XML form

                 • json: JSON ClassAd form

                 • new: "new" ClassAd form without newlines

                 • auto: use the same format as the first input
                 ClassAds are storted by attribute unless nosort is specified.

          [<key>=<value> ]
                 Assign key/value pairs before rules file is parsed; can be used to  pass  arguments  to  rules.
                 (More detail needed here.)

          -long  Use long form for both input and output ClassAd(s). (This is the default.)

          -json  Use JSON form for both input and output ClassAd(s).

          -xml   Use XML form for both input and output ClassAd(s).

          -verbose
                 Verbose  mode,  echo to stderr the transform names as they are applied and individual transform
                 rules as they are executed.

          -terse Disable the -verbose option.

          -debug Causes debugging information to be sent to stderr, based on  the  value  of  the  configuration
                 variable TOOL_DEBUG.

EXIT STATUS

       condor_transform_ads  will  exit  with a status value of 0 (zero) upon success, and it will exit with the
       value 1 (one) upon failure.

EXAMPLES

       Here's a simple example that transforms the given input ClassAds according to the given rules:

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

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

          # Command:
          condor_transform_ads -rules my_rules -in my_input

          # Output:
          DiskUsage = 2500000
          Err = "/dev/null"
          MemoryUsage = 5
          NumCheckPoints = 0
          RequestDisk = ( 5000000 / 1024 )
          ResidentSetSize = 500

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024, Center for High Throughput Computing, Computer Sciences Department, University  of  Wisconsin-
       Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                                  Aug 25, 2024                           CONDOR_TRANSFORM_ADS(1)