Target and Process Command Line

Previous Next  Print this Topic

Run TgtProcCI to execute single, interactive backup or move jobs to ingest data into the Information Repository.

To run single backup or move jobs to ingest data into the Information Repository, ensure that the Phoenix VCM installation folder is in your command path, open a command prompt, and run TgtProcCl at the command line. Depending on what you want to do, append tokens as listed below (under Token/Value Pairs) to the execution path. See Target and Process and Command Line Arguments.

Access TgtProcCI from your suite of application products.

Default Target & Process List Log

To see job run results and diagnostic information, you can take a look at the Phoenix VCM list log for any given job. Unless you change the settings and path, Phoenix VCM employs the following: %R/Logs/%P.log. You can change this value when running TgtProcCl or in the Target & Process configuration file.

Default Target & Process Error Log

To see if a job had any errors, you can take a look at the Phoenix VCM error log for any given job. Unless you change the settings and path, Phoenix VCM employs the following: %R/Logs/%P.err. You can change this value when running TgtProcCl or in the Target & Process configuration file.

Pathname Variables for Logs

Pathname variables are expressions to define what information is included in your logs.

Variable

Description

%P or %Pn

%H or %Hn

%D

%Dy

%Dm

%Dd

%T

%Th

%Tm

%Ts

%R or %Rn

Policy Name

Host Name

Date (yyyy:mm:dd)

Year

Month

Day

Time (hh:mm)

Hour

Minute

Second

Root Pathname. Valid only at the beginning of a string.

Command Line Options

When you run TgtProcCI, the command line can contain a command line option or token/value pairs. As needed, append tokens as listed below (under Job Token/Value Pairs) to the execution path. The command line is formed as follows:

TgtProcCl <option>

Or,

TgtProcCl <token>=<value> <token>=<value> . . .

To retrieve usage and version information, use the appropriate option below:

-usage - List all valid parameters.
-version - Display the current version information.

Job Token/Value Pairs

Use the following token/value pairs to specify policy information for the job that is going to be run.

Token/Value

Description

act_log_enabled = <boolean>

Enable the creation of activity logs.

Valid values: true | false

Default = false

act_log_pn = "<pathname>"

Define the path for the activity log. Supports token substitution.

Default path = "%R/Logs/%P.act"

absolute_start = <yyyy>/<mm>
/<dd>-<hh>:<mm>:<ss>

The exact start time and date that the job is to run. Multiple absolute start tokens may be entered.1, 2

active = <boolean>

Define if the policy is active or inactive.2

Valid values = true | false

Default = true

admin_pn = "<pathname>"

The directory that contains the log, retry, and history files. Supports token substitution.

Default path = "<install-dir>/JobHistory/"

any_user_retrieve = <boolean>

Allows any user to retrieve a file in the job, regardless of the initial read access.

Valid values = true | false

Default = false

backup_data

Internal use only.

backup_stub

Internal use only.

complete = <boolean>

Print all summary information plus the path names of the files ingested to the file indicated by the list_pn option.

Valid values = true | false

Default = false

compress

Internal use only.

create_job_history = <boolean>

Create job history files for each job.

Valid values = true | false

Default = false

data_paths = <number>

The maximum number of concurrent files that can be sent.

Default = 1

description = "<character string>"

A description of the policy.2

Default = blank

diag = <boolean>

Print diagnostic information to the file indicated by the list_pn option.

Valid values = true | false

Default = false

dir_spec = "<pathname>"

Directories to include. Multiple dir_spec options can be specified. The dir_spec check is made for every directory found. This includes the directories contained in the path name list that the job  traverses.

Default = "*" (any)

display_only = <boolean>

Cause job to search for but not store targeted files. List the files that would have been ingested.

Valid values = true | false

Default = false

dst_local_only = <boolean>

Cause job to use only a Vault local to the computer from where service is running.

Valid values = true | false

Default = false

dst_media_name = "<character string>"

The destination media to be used. If not specified, the first available unit of media is used.

Default = "*" (any)

dst_media_speed = "<character string>"

The destination media to be used according to media speed.

Valid values =

S0 - S10
Unspecified

Default = Unspecified

dst_media_type = "<character string>"

The media type to be used for a job.

Valid values =

Hdisk – Hard disk
8mm – Eight-millimeter tape
Dds – Digital data storage
Dlt – Digital linear tape
Ait – Advanced intelligent tape
SuperAit
Vxa - Exabyte Vxa tape
Travan - Travan tape
Lto – Linear tape open
MagOptical – Read/write optical
NullDevice
Unspecified

Default = Unspecified

dst_storage_pool = "<alpha>"

The name of the destination storage pool. Use ''" for no storage pool name.

Default = "*" (any)

dst_vault_name = "<character string>"

The destination Vault name. If not specified, the first available Vault is used.

Default = "*" (any)

dst_volume_format

Internal use only.

dst_volume_name

Internal use only.

dst_volume_pack

Internal use only.

dtu_type = <alpha><yyyy>/<mm>
/<dd>-<hh>:<mm>:<ss>

or

dtu_type = L<level>

Ingest files based on time and date or job level.

Valid values =

AO (Absolute Old) – Select files with a dtu (date_time_use) equal to or before the specified date. Enter the year as a 4-digit number.
AN (Absolute New) – Select files with a dtu equal to or after the specified date. Enter the year as a 4-digit number.
RO (Relative Old) – Select files with a dtu equal to or before the relative specified date.
RN (Relative New) – Select files with a dtu equal to or after the relative specified date.
L0 – Ingest all files.
L1 – Ingest all data changed since the last L0 job.
L2 – Ingest all data changed since the last L1 job.
L3 – Ingest all data changed since the last L2 job.
L4 – Ingest all data changed since the last L3 job.

Default = L0

error_log = "<pathname>"

The path for the error log file. If you specify "/dev/tty", error messages display on the default output device. Supports token substitution.

Default path for the configuration file = "R/Logs/%P.err"

exclude_dir_spec = "<pathname>"

Omit directories. Accept multiple instances.

Default = "" (no directories excluded)

exclude_file_spec = "<pathname>"

Omit files. Accept multiple instances.

Default = "" (no files excluded)

ext_metadata = "<command>"

Extended metadata in a token/value pairs. Token/values can be found in the MetadataExtensions.cfg.

Format:

token="<command>"token="<command>"...

Default = ""

ext_metadata_plugin = "<character string>"

Enable the collection of extended metadata.

Default = "EmdProcessNone"

file_grouping_plugin = "<character string>"

Enable file grouping.

Default = "FgProcessNone"

file_spec = "< pathname>"

Files to be ingested. This token/value pair can be specified multiple times to include multiple file filters.

Default = "*" (any)

follow_links

Internal use only.

host_Id = "<character string>"

Where the Target and Process Service runs.2

Default = blank

include_offline

Internal use only.

job_type = <alpha>

Specify the job type.

Valid values =

backup
move

Default = backup

list_pn = "<pathname>"

The filename where all report information is written. Supports token substitution.

Default path for the configuration file is "%R/Logs/%P.log"

local_only = <boolean>

Specify that the ingested file is to reside on the local computer.

Valid values = true | false

Default = true

localize = <boolean>

All subsequent files in the same job are sent to the same unit of media until it is full.

Valid values = true | false

Default = true

lock_vault

Internal use only.

obj_type = "<character string>"

The policy source.

Valid values =

native_fs
mse_pst
mse_msg

Default = native_fs

out_of_band = <boolean>

Enable the application to constantly monitor its processes and select the network transmission protocol that best suits the files being processed.

Valid values = true | false

Default = true

pathname = "<pathname>"

The path name that is searched for files matching the options. Files, directories, and wildcard expressions are valid. This token/value pair can be specified multiple times to include multiple paths.

No default

pict_gen_preview_image = <boolean>

Generate preview image thumbnails at capture/ingest.

Valid values = true | false

Default = true

pict_preview_image_quality = <boolean>

Determine the quality of the preview image.

Valid values = High | Medium | Low

Default = Medium

pict_process_components = <boolean>

Capture/ingest picture files so that they are readable by search applications.

Valid values = true | false

Default = false

pict_save_preview_image = <boolean>

Save a preview image at the path entered in pict_save_preview_image_dir_pn.

Valid values = true | false

Default = false

pict_save_preview_image_dir_pn = "<pathname>"

The path where the copy of the preview image is saved.

Default path = ""

policy_name = "<policy name>"

The job identifier.

No default

post_proc_cmd = "<command>"

A post-process command that runs immediately after the job is finished. Supports token substitution.

Default = ””

pre_proc_cmd = "<command>"

A pre-process command that runs immediately before the job starts. Supports token substitution.

Default = ””

process_directories = <boolean>

Preserve the state of directories.

Valid values = true | false

Default = true

ref_id = "<character string>"

Internal use only.

repeat_interval = <hh:mm:ss>

The amount of time that elapses before a job is repeated.1, 2

Default = 24:00:00

retry_time = <alpha><yyyy>/<mm>
/<dd>-<hh>:<mm>:<ss>

The date and time to retry the list of files not ingested. These files match all job criteria but were not sent to the Vault. You must precede the date/time value with an A to specify an absolute date and time or an R to specify a date and time relative to the end of the job. Enter the absolute year as a four-digit number (for example, 2001, 2002, etc.).

Valid values =

A – Absolute date and time.
R – Relative date and time.

Default = R0000/00/00-00:00:00 (retry files immediately after the job finishes)

start_days = <mtwtfss>

The days the job runs. Use - to indicate days the job should not run.

For example, if the job is to run on Thursday, you would enter ---t---.1, 2

Default = mtwtfss

start_time = <hh:mm:ss>

The time the job should start for each defined start day in start_days.1, 2

Default = 00:00:00 (midnight)

stop_time = R<yyyy>/<mm>
/<dd>-<hh>:<mm>:<ss>

The date and time the job is to stop. The date and time entered is relative to the start of the job.

R = relative to the start of the job.

Default = R0000/00/00-00:00:00 (no stop time)

summary = <boolean>

Print the start and finish times of the job and the final statistics to the file indicated by the list_pn option.

Valid values = true | false

Default = true

system_info = <boolean>

Ingest system info and other system states.

Valid values = true | false

Default = false

throttle = <setting>

The throttle controls the amount of bandwidth used by jobs (and, the speed files are sent to Vaults). Throttle values are relative to Information Repository capacity and range from 1% to 100%. A lower setting reduces the amount of available bandwidth that is used.

Default = 100

timestamp = <alpha>

Specify the timestamp of the file that is to be examined when determining if the file meets the dtu_type criteria.

atime - access time
mtime - modified time

Default = mtime

type = <alpha>

The policy type of the policy file.2

Default = tap

update_run_record = <boolean>

Update the job run record (<install-dir>/JobHistory/run_record.trr) whenever a "level” job runs.

Valid values = true | false

Default = true

vcs = <alpha><max num files>

The number of files (F) or number of bytes (S) to ingest per single Vault connection.

Valid values =

F – files
S – bytes
1 -

Default = F500

version = <number>

The version number of the policy. The current version is 1.0.2

vid_extract_closed_caption = <boolean>

Extract closed captioning data from a video at ingest.

Valid values = true | false

Default = true

vid_gen_low_res_proxy = <boolean>

Generate low resolution proxy videos at capture/ingest.

Valid values = true | false

Default = true

vid_gen_preview_image = <boolean>

Generate preview image thumbnails at capture/ingest.

Valid values = true | false

Default = true

vid_low_res_proxy_quality = <setting>

Determine the quality of the low resolution proxy video.

Valid values = High | Medium | Low

Default = Medium

vid_preview_image_quality=<setting>

Determine the quality of the preview image.

Valid values = High | Medium | Low

Default = Medium

vid_process_components = <boolean>

Capture/ingest video files so they are readable by Phoenix VCM search applications.

Valid values = true | false

Default = false

vid_save_closed_caption = <boolean>

Save a copy of the closed captioning data in a location specified by vid_save_closed_caption_dir_pn.

Valid values = true | false

Default = false

vid_save_closed_caption_dir_pn = "<pathname>"

The path where the closed captioning file is saved.

Default path = ""

vid_save_low_res_proxy = <boolean>

Save a copy of the low resolution proxy video at the location entered in vid_save_low_res_proxy_dir_pn.

Valid values = true | false

Default = false

vid_save_low_res_proxy_dir_pn = "<pathname>"

The path where the copy of the low resolution proxy video is saved.

Default path = ""

vid_save_preview_image = <boolean>

Save a preview image at the path entered in vid_save_preview_image_dir_pn.

Valid values = true | false

Default = false

vid_save_preview_image_dir_pn = "<pathname>"

The path where the copy of the preview image is saved.

Default path = ""

1Note: Timing tokens are mutually exclusive. Only one timing token may be set. Set either absolute start, or repeat_interval, or start_days and start_time.