sidloc 
 
 This tool performs the following functions for files that were updated for 
 an APAR: 
 
 - add SID codes to the updated file 
 - count lines of added, deleted, and changed code in the updated file. 
 
 The syntax for invoking this tool is as follows: 
 
                                              .-.-------. 
 >>--SIDLOC--.-----------------.--apar--path--+---------+------------->< 
             | (1)             |              '-workdir-' 
             '-----| options |-' 
 
 
 Options: 
 
    <-- ---------------------------< 
   (2) 
 |-----(hyphen)--.-------------.------------------------------------------| 
                 |  <-------<  | 
                 |----.-l-.----| 
                 |    '-s-'    | 
                 |             | 
                 '-d DIR-------' 
                 |             | 
                 '-t num-------' 
 
 
 Notes: 
 
 1)  The default behavior is as follows: 
     - SID codes will be added to the updated file 
     - added, changed, and deleted lines will be counted 
     - tab characters will be converted to blanks prior to adding SID 
       codes. 
 2)  A '-' character is to be specified.  For example, 
 
        SIDLOC -s PJ12345 . 
 
 
 Operands: 
 
 apar 
    is the APAR number for which the changes were made.  This APAR number 
    is used as follows: 
 
    - It is used to form the SID code that is placed on added or changed 
      lines. 
    - It is used to form the name of the file in which the line-of-code 
      counts are placed.  The name of this file is '<apar>.loc'.  For 
      example, line-of-code counts for APAR PJ12345 are placed in a file 
      named PJ12345.loc. 
    - Note that the name of the project can be used instead of Apar number 
      when -l option is specified explicitly. 
 
 path 
    is the name of a file or directory.  If a file is specified then the 
    requested processing is performed for that file.  If a directory is 
    specified then the requested processing is performed for every file in 
    that directory. 
 
 workdir 
    is the name of a working directory.  Work files are created in this 
    directory, which are erased prior to completion of processing.  If SID 
    code processing is performed then the updated files are placed in this 
    directory.  If this operand is omitted then it defaults to the current 
    directory. 
 
 
 Options: 
 
 -d DIR 
    is used, when the user wants to specify a directory that has the original 
    files to be compared with the ones in user directory.(input directory) 
    The default value for DIR is '/u/tpf41/currentmaint' 
 
 -l indicates that only line-of-code counts are to be generated.  SID code 
    processing is not to be performed. 
 
 -s indicates that only SID code processing is to be performed.  Line-of- 
    code counts are not to be generated. 
 
 -t indicates the number of columns between tabstops.  This value is 
    specified as follows: 
 
    num is the number of columns between tabstops.  For example, if -t 3 is 
        specified then tabstops will be located at columns 4, 7, 10, etc. 
 
 
 Usage Notes: 
 
 1)  If both -l and -s are specified, the last one entered will be in 
     effect. 
 
 2)  If the directory specified by path (or the directory containing the 
     file specified by path) and the workdir directory are identical, the 
     files used as input are replaced by the corresponding files generated 
     by SID code processing.  This practice is not recommended, since a 
     failure in the middle of SID code processing could cause the original 
     file to be lost.