car_tar_Z [-i executable-file-name] [-f] [-s|-S] [core-file-name] > output-file-name

This command gathers a core file and its related libraries and outputs them to a single archive file. The car_tar_Z command compresses the file and the related libraries by using the compress command. This command is for UNIX only.

-i executable-file-name

Specifies the name of an executable file.

-f

Collects library and other files, along with their path names.

-s

Reports the size (in bytes) of the archive file that would be output (but without outputting the archive file).

-S

Outputs a shell script for creating the archive file.

When you specify this option, specify a shell script name for output-file-name.

To output the archive file, you must execute the output shell script.

core-file-name

Specifies the name of a core file. If omitted, core is assumed.

output-file-name

Specifies a file name for the archive file or shell script.

Create an archive file:

car_tar_Z -f core.8326 > corefile.tar.Z

Check the size of an archive file:

car_tar_Z -s core.8326

Create an archive file from a shell script:

1. Create a shell script.
   car_tar_Z -S core.8326 > collect_cores.csh
   
2. Assign execution rights to the shell script.
   chmod +x ./collect_cores.csh
   
3. Execute the shell script and create an archive file.
   ./collect_cores.csh > corefile.tar.Z
   

0:

The command terminated normally.

1:

The command terminated abnormally.

If any of the messages described below is issued, a normal archive file was not output.

Table 10-3 Error messages output by the car_tar_Z command

No.	Error message	Explanation
1	usage: car_tar_Z [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ]	A command argument is invalid.
2	car_tar_Z: inner error!	An internal error occurred in the car_tar_Z command.
3	car_tar_Z: cannot create temporary name	A temporary file cannot be created. Either delete or move the file car_exec?? (where ?? is an integer in the range 00 to 99) located in the current directory.
4	car_tar_Z: (omitted): file not found	File was not found. Check the core file and the executable file specified by the -i option.
5	car_tar_Z: (omitted): not supported platform	The OS is not supported.

• You must have write permission to write data into the current directory.
• You cannot execute the car_tar_Z and car_tar_gz commands concurrently under the same directory for the same core file or for core files that have the same creation time.
• The tar command and the compress command must both be installed in the system.
• If the car_tar_Z command is terminated forcibly, temporary files and directories created by it remain in the current directory.
  Temporary files: car_exec?? (where ?? is an integer in the range 00 to 99)
  Temporary directory: carYYMMDDhhmm/ (where YYMMDDhhmm is the date and time the core file was created)