Parameters

Specify the output directory for the information that is to be collected by the DLMgetras utility for collecting HDLM error information. The collected information is compiled into the three files shown in Function and output in the specified directory.

Use this parameter when you want to specify certain directories or files to be collected. In this parameter, specify the file that defines information to be collected, which defines the files and directories you want to collect.

Use an absolute path to specify the file that defines information to be collected.

The following is an example of the coding in the file that defines the information to be collected. In this example, the information specified to be collected is as follows: the OS files that are not collected by the DLMgetras utility by default, and the PostgreSQL files when PostgreSQL is an upper-level application program.

Figure. Coding example of a file that defines the information to be collected

Rules for coding a file that defines the information to be collected

• Use an absolute path to specify a directory or file whose information is to be collected. If you use a relative path to specify a directory or file, that directory or file will be searched for only within the directory in which the DLMgetras utility was executed, and the files found will be collected.

• Do not specify a directory that contains the directory to which the collected information is output. If you specify this directory, the DLMgetras utility will run indefinitely.

• Lines beginning with the hash mark (#) are handled as comment lines.

• If the hash mark (#) is encountered anywhere other than at the beginning of a line, it is assumed to be part of a path name.

• Only one file or directory can be specified per line.

• The root directory (/) cannot be specified.

• When a directory is specified, the DLMgetras utility collects all the files in that directory, including files contained in the directory's subdirectories. If no files are found in a specified directory, the utility does not perform file collection for that directory and does not create a directory for it in the destination directory.

• Set up the specified file or directory so that it can be read by users with root permissions. The DLMgetras utility can only obtain information for a file or directory that can be read.

Displays the format of the DLMgetras utility.

• Because the DLMgetras utility first stores error information in the specified output directory before compressing, ensure that the allocated information collection areas are of adequate size.

• If the specified directory to which collected information is output already exists, an overwrite confirmation message is displayed. Responding by entering y instructs the DLMgetras utility to overwrite the existing files; entering n (or anything other than y) instructs the utility to terminate without executing.

  In the latter case, you can either rename the existing directory before re-executing the utility, or you can execute the utility with a different directory name specified.

• If you execute the DLMgetras utility, an error message (KAPL10034-E) might be output to the getras.log file when copying a file in the /proc directory or /sys directory. However, HDLM operations are not affected.