Usage: pdm_search [options] name

	This script creates a PDM trailfile which creates a report of all
	objects for the specified criteria and databases. 
	Then it will start Pro/PDM with it after a confirmation. With the -g
	option you can also fetch the object.
	If no name is given on the commandline it will search for all names (*).
	By default it will list all LATEST objects from ALL DATABASES.
 
	options:	-h 		=> this help screen 
			-d DBASE	=> Search in database DBASE
					   WORKING_DIR = Working directory
			-e DBASE	=> Exlude DBASE from selection
					   You can use both options above
					   multiple times.
			-r RELLVL	=> Search at RELEASE LEVEL
			-v XXX		=> Search objects revisions,
					   with xxx = ALL or LATEST (default).
			-s XXX		=> Search objects with status,
					   with xxx =
					   	ANY
					   	APPROVED
					   	PENDING
					   	REJECTED
					   	ARCHIVED
					   	VIRTUAL
					   	REFERENCE
					   LOCK
			-a DATE		=> Search objects after DATE
			-b DATE		=> Search objects before DATE
					   DATE =  mm/dd/yy
					   Or use the aliases:
					   	TODAY
					   	OFFSET x (TODAY minus x days)
			-g		=> Fetch first object
			-j		=> Fetch all items found
			-c		=> Conf.Fetch As Stored Configuration
			-x		=> Conf.Fetch dependencies = None
			-q		=> Conf.Fetch dependencies = Required
					   (default = All; -x and -q overrule
					    each other)
			-w		=> where used - as stored
			-l		=> where used - latest
					   with the where_used options a file
					   called where_used.txt will be created
			-i xxx		=> Additional options with xxx =
					   no_print => do not create the search_
					   	       result file.
					   bom => make BOM file: bom.txt.
					   	  (deepest level = 15)
					   level x => change deepest level to x
					   stardotstar => search *.name.* 
					   dotstar => search name.* 
					   star => search name* 
					   starstar => search *name* 
					   stardot => search *.name
					   list => Force creating dbase listing
					   instance => Show instances
					   history = get revision history
					   fetch_info = get fetch info
					   silent => run more silent
					   pdmlinks => fetch as pdmlinks
					   command x => set pdm command to x
					   no_conflict => disable conflict OK
					   		  entry when fetching
					   bom_warning => add OK for warning 
					   		  after selecting bom
							  report.
			-f		=> Force start of Pro/PDM
			-p xxx		=> If object is a psb file do xxx =
					   description = print description
					   approve = approve it
			-o FILE		=> output filename
			-m xxx yyy	=> more options with xxx =
					   promote yyy = promote to level yyy
					   demote yyy = demote to level yyy
					   submit yyy = submit to database yyy
					   		DEFAULT = use default
							database.
							Searching in WORKING_DIR
					   folder yyy = when submit, submit
					   	        to folder yyy
					   level yyy = when submit, submit
					   	        to level yyy
					   descr yyy = when submit, use this 
					   	       description (no spaces
						       allowed).
					   formfold yyy = when submit, put
					   		form in yyy.
							yyy = NO_FOLDER to make
							the name empty.
					   mod_rev yyy = set revision to yyy
					   	       as an alternative you can
						       also add the rev to your
						       model name delimited
						       with an =. 
						       e.g. part1.prt=3.1

	NOTE 1:
	When fetching an object it will also add an OK for possible conflicts
	in the fetch list. If there are no conflicts in the fetchlist Pro/PDM
	will crash, but only AFTER the fetch has been done. You can disable 
	the conflict check OK entry with the -i no_conflict

	NOTE 2:
	To get correct BOM's you need to create a srch_rpt.pdm file for the
	search report window. Set the order to Name, Rev, Rel level, status
	in order to avoid external references appearing at the top of the list.

	Uses: date_calc (c-source available) when -i date_offset option is given

Author: Olaf Corten, the Netherlands
E-Mail: olafc@molding.fico.nl or ocorten@knoware.nl

################################################################################
# History:
#
# 000405 Added date alias OFFSET x.
# 991022 Added -m level option.
# 990607 Added srch_rpt.pdm help
# 990517 Added -i bom_warning options.
# 990512 Multiple commandline names possible.
# 990505 Added -m promote/demote options. Added WORKING_DIR. Added -i no_conflict.
#	 Added -m history and fetch_info option.
# 990429 Added -i command option.
# 981103 Added -i pdmlinks option.
# 980925 Put fetch at the end.
# 980902 pdm_path_listing now written to $HOME
# 980818 Fixed always fetching highest release level
# 980810 Added starstar and stardotstar options.
#	 Added -p description and -p approve option.
#	 Added -i instance option.
# 980803 Added dotstar and star options. Checking pdm_pathfile.
# 980720 Added SCRIPTS_DIR.
# 980710 Using check_dbasenr, -p option deleted.
# 980612 Added -i bom option.
# 980528 Only listing directory names in PDM_PATH.
# first version	april 1997
#
################################################################################