osf_test
This utility can be used to search an OPUS OSF blackboard for OSFs that
match some search criteria. The qualifying OSFs can be printed in
their entirety, or sub-fields of the OSF can be printed by using special
command line print options.
NOTE: When running on a case sensitive operating system (e.g. UNIX),
you must supply values that match the case of the OSF blackboard (typically
lowercase).
Usage: osf_test -p pathfile
[-f filename] [-t data_id] [-n dcf_number]
[-c column -s status_character]
[-s status_field]
[-m command] [-x time]
[-pr time status dataset data_id dcf_num command COLUMN_NAMES]
The pathfile argument is required. All others are optional. Any OSF
selection options omitted are replaced with default search characters
that will match all OSFs. If the print options (-pr) are omitted, the
entire OSF is printed.
Context
Inputs
Outputs
OSFs or OSF fields written to the standard output (terminal).
Exit Status
Returned status value is: '0' on success, '1' on general failure,
or '2' on failure due to a persistent file lock.
Constraints
OSF fields are printed in the order that the user specifies the
print option keywords, with one
exception: OSF column name selections will always follow OSF field
name selections, even if the user requests the columns first.
If the column selection option is used, the status option must also
be supplied. More than one -c/-s pair may be specified. For example, find
OSFs with column GC = status value 'e'
would be implemented by
Qualifiers
-p
Name of the pipeline path file. Used to find the OSF blackboard.
-f
OSF dataset name. (E.g. u2440101t) Partial dataset names including
wildcard characters are NOT permitted.
-t
-n
-c
OSF column name. If this option is used, the -s option MUST also be used.
E.g. -c GC -s e
-s
OSF status field. Can either specify a status value for a single OSF
column, when used in conjunction with the -c option, or can supply the
entire status value, e.g. -s ccccccw
-m
OSF command field. E.g. halt
-x
OSF time stamp (in hex format). E.g. 354f2a90
-pr
Print field selections. If none provided, the entire OSF is printed.
To print only certain OSF fields, include values from this list of
keywords:
time status dataset data_id dcf_num command COLUMN_NAMES
where COLUMN_NAMES are two-character OSF stage names like DP, SS, or GC.
Examples
% osf_test -p otfcal -f u2440101t
Finds OSF under otfcal blackboard matching dataset name "u2440101t".
Prints the entire OSF to the screen.
% osf_test -p otfcal -c CA -s e -pr dataset data_id
Finds OSFs under otfcal blackboard with value 'e' in the CA column.
Prints the dataset and data_id fields of these OSFs, separated by a space,
to the screen.
% osf_test -p otfcal -f u2440101t -pr CA
Finds the OSFs under otfcal blackboard matching dataset name "u2440101t"
and prints the value of the CA status column to the screen. To catch
this value in a UNIX Bourne shell script variable, you could use:
calstatus=`osf_test -p otfcal -f u2440101t -pr CA`