DFlistplates.rpc

DFlistplates.rpc — List all plate numbers used in the study

Synopsis

DFlistplates.rpc [-n] [-p #, #-#] {-s #}

Description

DFlistplates.rpc creates a list of the plate numbers defined for the study and writes that list to the standard output. The list is sorted in increasing numeric order. Each plate number is output with leading zero-padded to three digits and is delimited from the next plate number by a single space character. The complete list of plate numbers is output in one line without a trailing new line, unless -n argument is given.

Both the plate numbers for user-defined plates, and 501 (the plate number reserved for returned Query Reports), are output by DFlistplates.rpc. However, the special plate numbers, 0, which is reserved for new records in DFin.dat, 510, which is reserved for reason for data change records, and 511, which is reserved for records in the query database DFqc.dat, are not included in the list.

With -p #, #-#, the list of known plates for the study is intersected with the argument list to create an output list. If this option is not specified, the program lists all of the defined plate numbers for the study.

Options

-n

append a new line character to the end of the output.

-p #, #-#

include only the specified plates in the range of plates to output.

-s #

the DFdiscover study number (required).

Exit Status

DFlistplates.rpc exits with one of the following statuses:

0

The command was successful.

> 0

The command failed because the database server could not be contacted, or communication with the database server failed.

Examples

Example 3.56. List the plates defined for study 123 to the standard output

% DFlistplates.rpc -s 123
 001 002 003 004 005 006 007 008 009 010 020 501% 

Notice how the prompt has been affected by the lack of a trailing newline.


Example 3.57. List all plate numbers, one per line, for study 254 - Bourne shell method

% for p in `DFlistplates.rpc -s 254`
? do
? echo $p
? done
001
002
003
004
005
006
007
008
009
010
020
501