Business objects EDJOB 7.70C User Manual

Edjob

User’s Guide

Edjob 7.70c

July 2006

Notices

Contact information Contact us on the Web at http://www.firstlogic.com/customer

If you find any problem with this documentation, please report it to Business Objects
in writing at

Copyright Copyright © 2006 Business Objects. All rights reserved.

Patents Business Objects owns the following U.S. patents, which may cover products that are

offered and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2,
6,490,593 and 6,289,352.

Trademarks Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise

are trademarks or registered trademarks of Business Objects SA or its affiliated
companies in the United States and other countries. All other names mentioned herein
may be trademarks of their respective owners.

Third-party contributors Business Objects products in this release may contain redistributions of software

licensed from third-party contributors. Some of these individual components may
also be available under alternative licenses. A partial listing of third-party
contributors that have requested or permitted acknowledgments, as well as required
notices, can be found at: http://www.businessobjects.com/thirdparty

[e-mail]

.

2

Edjob User’s Guide

Introduction

When our programs are updated, changes in software often require that new
parameters or blocks be added or removed from job files. The Edjob utility is a
convenient way to bring your job files up to date when new software is released.
Edjob is free with your purchase of any program that uses job files.

There is no special, separate procedure for installing Edjob. When you install a
software release, we place the latest version of Edjob in your adm subdirectory,
and we place an update script in the appropriate software subdirectory (see
diagram).

postware

or pw

adm dtr_iq

Your one an only copy of the
Edjob program file belongs
here in adm.

pwace

or ace

merge

or mpg

The update script file belongs in the software directory.
Note: Only a portion of our product line is shown here.
Other products are installed similarly.

presort

or pst

pf

Please use the Edjob program and scripts exactly as they are installed. If you
move or copy these files, we can’t keep them up to date. There’s a chance that an
obsolete Edjob or script might be left in your system. And that could cause you
trouble at the next release.

3

Details about Edjob

Update scripts Edjob follows a script that we provide. Each time we release new software—

except minor revisions—we include a new script file. This script tells Edjob what
changes to make. There are separate scripts for each product. The names of the
script files are listed below.

Usually, Edjob should be able to find the update script by itself, and you don’t
need to include the file in your command line.

Sometimes we publish a special, temporary, or patch, script. When you are
instructed to use a script name different from those listed below, you need to
include its full path and file name in your command line.

Version number in the job file

Before editing a job file, Edjob checks the General block to determine the job-file
type (product) and version number. If necessary, Edjob can bring a file up to date
from earlier versions. If the job file already has been updated, Edjob will send
you a message, but it will not edit the file. In this way, you are protected from
double updating.

File-name extensions When you name job files, be sure to use the file name extensions listed below. If

you use other extensions, Edjob will not be able to update your jobs. By default,
Edjob backs up each job file before updating it. The backup has the same name as
the job file, but with a different extension as listed below.

Program Update script

file

ACE

ACE Canada

ACE Interna­tional

DataRightIQ

Label Studio

Match/Consoli­date

pwacejob.upd .ace .aed

pwcacjob.upd .cac .ced

pwiacjob.upd .iac .red

pwdiqjob.upd .diq .did

pwlsjob.upd .lsj .lid

pwmpgjob.upd .mpg .med

Job-file extension Backup extension

Presort

PrintForm

4

Edjob User’s Guide

pwpstjob.upd .pst .ped

.pdb .pdd

pwpfjob.upd .pf .eed

.job .fed

.ins .oed

.pcc .ved

.dcc .wed

.map .xed

.pfp .yed

Program Update script

file

Job-file extension Backup extension

ZipCount

pwzctjob.upd .zct .zed

5

How to run Edjob

Edjob is a simple utility. It does not present any menus or displays. You control
the program by adding options to your Edjob command line.

For your convenience, these command-line options are also listed in our Quick
Reference.

DOS or Windows edjob [/cnsbx] [/v | /V | /vv] [/e:error_file] [script.upd] jobfile

UNIX edjob [-cnsbx] [-v | -V | -vv] [-e:error_file] [script.upd] jobfile

Elements of the command line

edjob

bx

c

e

s

n

script

.upd

v | V | vv

If the ADM directory is in your PATH setup, your operating system should be able to find the Edjob pro­gram. Otherwise, you may need to type out the full path to the executable program file (

edjob.exe

)

edjob

or

Remove excess blank lines so that the maximum number of contiguous blank lines (between blocks) will
be

x

(1-9).

Suppress the prompt for confirmation that normally appears before each job file is edited.

When using a list file or wildcard, include the c switch in your command line.

Log errors in the log file. Normal progress messages still go to the screen (standard out). This option is
handy for overnight processing, because Edjob does not stop on errors. The log file contains one line per
jobfile found. Even if there is no error, the file name is logged; so the log is a handy way to verify that a
particular job was updated.

Recursively search for job files in all subdirectories.

No backup. Normally, Edjob backs up each job file before updating it (for example,
up to

jobfile.aed

). If you don’t feel that this backup is necessary or you can’t spare the disk space, add the

jobfile.ace

is backed

n option to suppress the backup.

We recommend allowing Edjob to create this backup file.

Update script. Usually, Edjob can find the update script by itself, and you don’t need to include the file in
your command line. Sometimes we publish a special patch script, and then you need to include a full path.

Produce verbose progress messages, or Very Verbose messages. You may use a double “vv ” instead of the
capital “V”.

jobfile

6

There are three ways to tell Edjob which job files you want updated:



Type the full name (with path, if necessary) of one job file.



Type a wildcard (for example, *
shell from expanding the wildcard. Edjob prefers to do this on its own. See the following page for exam­ples.



Use your text editor to create a simple text file that contains a list of job files or wildcards. Instruct
Edjob to work from that list by typing the @ symbol on your Edjob command line (see examples on
next page).

Edjob User’s Guide

.ace

.) On UNIX, enclose the wildcard in quotes (“

.ace

”) to prevent the

Sample command lines

DOS or Windows command prompt

The following command reads job-file names from a list (dtr_iq_jobs.txt), and
logs errors in a file (update.log). Edjob makes a backup copy (with the extension
.ded) just before updating each DataRight IQ job file. Edjob suppresses the
prompt for confirmation.

C:\pw\adm\edjob /c /e:update.log @D:\projects\dtr_iq_jobs.txt ↵

Below, Edjob begins working in the directory C:\ADA\JOBS. Edjob searches this
directory, and all subdirectories, for PrintForm job files. Edjob prompts for
confirmation before editing each job file that it finds, and it produces normal
messages. Edjob makes a backup copy (with the extension .fed) just before
updating each job file.

C:\pw\adm\edjob /s C:\ada\jobs\*.job ↵

Here’s a similar example for ACE jobs. This time, however, the prompt for
confirmation is suppressed, and no backup copies are made.

C:\pw\adm\edjob /cns D:\ina\jobs\*.ace ↵

Note: For the previous command line examples, you may omit C:\pw\

if you have already defined the path.

adm\

UNIX The following command suppresses the normal confirmation and backup. Edjob

starts in Barbara’s user directory and looks for Label Studio jobs in all
subdirectories below it. Notice the wildcard is enclosed in quotes.

/usr/postware/adm/edjob -cns "/usr/barb/label_studio_jobs/*.dlb" ↵

The command below updates job files following the list in the file joblist. Edjob
does not prompt for confirmation, but does produce verbose messages. Where
excess blank lines are found, they are trimmed to two lines.

/usr/postware/adm/edjob -cvb2 @joblist ↵

Note: For the previous command line examples, you may omit /usr/

postware/adm/ if you have already defined the path.

7

8

Edjob User’s Guide