CDL -- Channel Descriptor Listing

Prints various types of descriptor information about selected image database channels to the report device.

See Also: ASL, SHL

PARAMETERS

CDL is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
DBCL     Database Channel List                   0-1024    Int
DTYP     Description type:  SHORT/FULL           1-5       Char
REPORT   Report Mode: TERM/OFF/filename          1-64      Char

FILE

Specifies the name of the PCIDSK file for which channel descriptor information is desired. 

 EASI>FILE="filespec"

DBCL

Specifies the image channels for which descriptors will be listed. 

 EASI>DBCL=i,j,...,p
 EASI>DBCL=             | list descriptors for all channels

DTYP

Specifies the listing type. The following modes are supported: 

 EASI>DTYP="SHORT"      | SHORT listing
 EASI>DTYP="FULL"       | FULL listing
 EASI>DTYP=             | defaults to SHORT

REPORT

Specifies the file to which to append the generated report. 

 EASI>REPORT="filename"
 EASI>REPORT=           | defaults to terminal output
The following names have special meaning: 

 EASI>REPORT="TERM"     | generates reports on your terminal
 EASI>REPORT="DISK"     | generates reports on file "IMPRPT.LST"
 EASI>REPORT="OFF"      | usually cancels reports generation, but
                        | CDL forces REPORT to terminal output

DETAILS

Channel descriptors are saved on the database whenever a task writes image data on a database output channel. The channel descriptor is usually automatically generated by the task. If a task is aborted while writing to a database image channel, the message "*** Operation Aborted Before Completion ***" appears in the channel descriptor.

CDL lists up to 1024 channel descriptors (DBCL) for a specified PCIDSK file (FILE). Two types of reports can be listed: SHORT and FULL (DTYP). By default, CDL produces a SHORT listing of of all image channel descriptors.

A report device (REPORT) must be selected. When the report is directed to the terminal, the report will be sent to the terminal one page at a time. If the report consists of more than one page, the user is prompted to either view the next page (<cr>), scroll the remaining pages ([G]o) or exit to the command level (e[X]it).

The first line of the channel descriptor report has the form: 

 filespec                 [S nnnnPIC nnnnnnP nnnnnnL] dd-mmm-yy
where: 

 filespec        is the PCIDSK file containing image channels.
 S               is an indicator of segment capability.
 nnnnPIC         is the number of pixel interleaved channels.
 nnnnnnP         is the pixel dimension of the image.
 nnnnnnL         is the line dimension of the image.
 dd-mmm-yy       is the date when the report was created.

SHORT LISTING

When the SHORT listing option is selected, each channel descriptor is listed with the following information: 

 nnnnnL[typ] program DESCRIPTIVE MESSAGE...             dd-mmm-yy
where: 

 nnnnn      channel number
 L          if present means channel is write locked
 [typ]      data type of channel:
            [ 8U] means  8-bit unsigned integer
            [16S] means 16-bit   signed integer
            [16U] means 16-bit unsigned integer
            [32R] means 32-bit real
            [DEL] means deleted
 program    name of program that last wrote to channel
 dd-mmm-yy  date when channel was last written to

SHORT EXAMPLE

Example of a SHORT CDL listing: 

 EASI>FILE="irvine.pix"
 EASI>DBCL=
 EASI>DTYP=
 EASI>REPORT=
 EASI>RUN CDL

 CDL  Channel Descriptor Listing    EASI/PACE V5.0  08:55 18-JAN-91

 irvine.pix                   [S   10PIC    512P    512L] 14-Aug-90

  1L[ 8U] MCD  0.45 - 0.52 micrometres: Blue-Green         1-OCT-90
  2L[ 8U] MCD  0.52 - 0.60 micrometres: Green              1-OCT-90
  3L[ 8U] MCD  0.63 - 0.69 micrometres: Red                1-OCT-90
  4L[ 8U] MCD  0.76 - 0.90 micrometres: Near I.R.          1-OCT-90
  5L[ 8U] MCD  2.08 - 2.35 micrometres: Middle I.R.        1-OCT-90
  6L[ 8U] MCD  USGS Land Use/Land Cover                    1-OCT-90
  7 [ 8U] MCD  Supervised Classification Results           1-OCT-90
  8 [ 8U] MCD  Working Channel                             1-OCT-90
  9 [ 8U] MCD  Working Channel                             1-OCT-90
 10L[16S] MCD  USGS Elevation Data                         1-OCT-90

FULL LISTING

When the FULL listing option is selected, each image channel is listed with the following information: 

 Channel: nnnnn                 Type:  xxxxx
     Creation: hh:mm dd-mmm-yy  Last Update:  hh:mm  dd-mmm-yy
     Contents: xxxxxxx
     Locking : xxxxxxx
     File Name: xxxxxxx

 History:
 (history line 1)
 (history line 2)
       . . .
 (history line 8)
where: 

 Channel         is the channel being reported on.
 Type            is the type of image data on the channel.
 Creation        is the time and date that the channel was created.
 Last Update     is the time and date that the channel was updated.
 Contents        is user specified descriptor for channel (See MCD).
 Locking         is write lock status (see LOCK and UNLOCK)
 File Name       is file name for image data (see CIM and PCIADD2).
 History         is the last eight channel descriptors for channel.
Note: File Name is listed only if the channel image data is stored 

      in an external file.

FULL EXAMPLE

Example of a FULL CDL listing: 

 EASI>FILE="irvine.pix"
 EASI>DBCL=10
 EASI>DTYP="FULL"
 EASI>REPORT=
 EASI>RUN CDL

 CDL  Channel Descriptor Listing   EASI/PACE V5.0  08:56 18-JAN-91

 irvine.pix                  [S   10PIC    512P    512L] 14-Aug-90

 Channel:   10              Type: 16 bit  signed integer
 Creation: 11:19 14-Aug-90            Last Update: 13:57  1-OCT-90
 Contents: USGS Elevation Data
 Locking : Write Locked.  Read only access.

 History:
 MCD    :USGS Elevation Data                          13:57  1-OCT-90
 C8TO16 :8-bit to 16-bit Image Conversion:DBIC=10,11  11:24 14-Aug-90
 CIM    :Empty                                        11:19 14-Aug-90
About PCI Help Gateway