ASL -- Database Segment Listing

Prints a summary of database segments, stored on a database file, to the report device.

See Also: CDL, SHL

PARAMETERS

ASL is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
LTYP     List Type: BRIEF/SHORT/FULL             1-5       Char
ASLT     Segment Type                            0-1       Int
ASSN     Segment: Segment Name                   0-8       Char
REPORT   Report Mode: TERM/OFF/filename          0-64      Char

The following parameter receives output:

IMSTAT   Image Statistics                        1-16      Int

FILE

Specifies the name of the PCIDSK file containing the segments. 

 EASI> FILE="filename"

LTYP

Specifies the listing type. 

 EASI>LTYP="BRIEF"      | BRIEF listing
 EASI>LTYP="SHORT"      | SHORT listing is the default
 EASI>LTYP="FULL"       | FULL listing
 EASI>LTYP=             | defaults to "SHORT"

ASLT

Optionally specifies the desired segment type codes. See the SHORT LIST section for a list of available codes. 

 EASI>ASLT=             | default, lists all segment types
 EASI>ASLT=j            | lists only type j segments
For example, setting ASLT=101 would list all bitmap segments.

ASSN

Optionally specifies the desired segment names. If ASSN is set to the segment name, only segments whose name matches ASSN are listed. 

 EASI>ASSN="string"     | lists only segments with name "string*"
 EASI>ASSN=             | default, lists all segments
For example, setting ASSN="SEA" would match all segments whose segment name begins with "SEA", such as "SEASIDE". "Seashore" would not be matched, since matching is case sensitive.

REPORT

Specifies the file to which to append the generated report. 

 EASI>REPORT="filename"
 EASI>REPORT=           | defaults to terminal output
Note: 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 report generation, but
                        | ASL forces REPORT to terminal output

IMSTAT

Upon completion, ASL writes to the IMSTAT parameter those segment numbers for the first 16 (or fewer) segments listed which match conditions set by ASLT and ASSN. If there are no segments listed, then IMSTAT(1) is set to zero, indicating that no segments were found.

DETAILS

ASL lists information on selected segments stored on the database (FILE). Three types of reports can be listed: BRIEF, SHORT, and FULL (LTYP). By default, ASL produces a SHORT listing of all segments on the database file. Subsets of segments can be listed by specifying appropriate values for ASLT and ASSN (Note: ASSN is case sensitive).

A report device (REPORT) must be selected. If the report parameter is set to OFF, it defaults to terminal output. When the report is directed to the terminal, the report will be sent to the terminal a 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).

ASL only prints a summary of information for each segment on file. To print the actual contents of these segments, run the following programs: 

 BIT:     prints report on bitmap segment         (type 101)
 VECREP:  prints report on vector segment         (type 116)
 CSR:     prints report on signature segment      (type 121)
 TXTREP:  prints report on text segment           (type 140)
 GEOREP:  prints report on georeferencing segment (type 150)
 ORBITWR: prints report on orbit segment          (type 160)
 LUTREP:  prints report on lookup tables          (type 170)
 PCTREP:  prints report on pseudo-colour table    (type 171) 
 ARRWRIT: prints text file of array data          (type 181)
 GCPREP:  prints report on ground control points  (type 213 or 214 or 215)
Also, ASL saves, in IMSTAT output parameter, the segment numbers for the first 16 (or fewer) segments found which match conditions set by ASLT and ASSN.

BRIEF LIST

When the BRIEf listing option is selected, each segment is listed with the following information: 

 Num:[Typ] Seg-Name
where: 

 Num is the `segment number'
 Typ is a 3-letter code with the following meanings:

    Bit: Bitmap                   PCT: Pseudo-Colour Table
    Del: Deleted segment          Sig: Signature
    GCP: Ground Control Points    Tex: Text
    Geo: Georeferencing           Vec: Vector/Polygon Set
    LUT: Lookup Table             Unk: Unknown

 Seg-Name is the segment name.

BRIEF EXAMPLE

Example of a brief ASL listing of all segments on a file: 

 EASI>FILE="irvine.pix"
 EASI>LTYP="BRIEF"
 EASI>ASLT=
 EASI>ASSN=
 EASI>REPORT="TERM"
 EASI>R ASL

 ASL   Database Segment Listing      EASI/PACE V4.3  10:17 04-JUN-90

 irvine.pix                        [S 11PIC   512P   512L] 02-FEB-90

  1:[Geo]GEOref    2:[LUT]LUTTM1    3:[LUT]LUTTM2    4:[LUT]LUTTM3  
  5:[LUT]LUTTM4    6:[LUT]LUTTM7    7:[Sig]WATER1    8:[Sig]WATER2  
  9:[Sig]URBAN    10:[Sig]RANGE    11:[Sig]AGRICULT 12:[Sig]BARREN  
 13:[Sig]WETLAND  14:[Sig]FOREST   15:[PCT]lulc     16:[Vec]DLGTRANS
 17:[Vec]DLGHYDRO 18:[GCP]GCPIRV   19:[Tex]ATTRIB

SHORT LIST

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

 num:segname   Type:ttt[aaa...aaa]   Last update: hh:mm dd-mmm-yy
     Contents: xxxxxxxx
where 

 num             is the segment number
 segname         is the segment's 8-character mnemonic name
 hh:mm dd-mmm-yy is the time/date of the last write to the segment
 xxx...xxx       is a description of the segment contents
 ttt             is the 3-digit segment type number
 aaa...aaa       is the description of the segment type
The following segment type numbers and description are possible: 

 xxx:[Deleted              ]         101:[Bitmap               ]
 116:[Vector/Polygon       ]         121:[Signature            ]
 140:[Text                 ]         150:[Georeferencing       ]
 160:[Orbit                ]         170:[Lookup Table         ]
 171:[Pseudo-Colour Table  ]         180:[Binary               ]
 181:[Array of Numbers     ]         214:[Ground Control Points]
 ???:[Unknown Type         ]

SHORT EXAMPLE

Example of a short ASL listing for lookup table segments only (type 170): 

 EASI>FILE="irvine.pix"
 EASI>LTYP="SHORT"
 EASI>ASLT=170
 EASI>ASSN=
 EASI>R ASL

 ASL   Database Segment Listing      EASI/PACE V4.3  10:17 04-JUN-90

 irvine.pix                        [S 11PIC   512P   512L] 02-FEB-90
 
 2:LUTTM1    Type:170 [Lookup Table]   Last Update: 12:12 11-APR-89
 Contents: Lookup Table for Channel 1

 3:LUTTM2    Type:170 [Lookup Table]   Last Update: 11:58 11-APR-89
 Contents: Lookup Table for Channel 2

 4:LUTTM3    Type:170 [Lookup Table]   Last Update: 11:57 11-APR-89
 Contents: Lookup Table for Channel 3

 5:LUTTM4    Type:170 [Lookup Table]   Last Update: 12:47 11-APR-89
 Contents: Lookup Table for Channel 4

 6:LUTTM7    Type:170 [Lookup Table]   Last Update: 12:46 11-APR-89
 Contents: Lookup Table for Channel 5

FULL LIST

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

 Number:xxxx  Name:aaaaaaaa         Type:xxx [description]
        Creation: hh-mm dd-mmm-yy   Update:hh-mm dd-mmm-yy
        Contents: xxxxxx
        [segment type dependent information]

 History:

 (first  line of history)
 (second line of history)
        . . .
 (eighth line of history)
FULL listings also include segment type dependent information: 

 Bitmap (type 101)     Data Length, Bitmap Size, and Bit Count.
 Vector (type 116)     Data Length, Units, Structures, and Bounds.
 GCP (type 213 or 214) Input Units, Output Units, and Number of GCPs.
Signature, Lookup Table, and Pseudocolour FULL listings do not contain segment type dependent information.

FULL EXAMPLE

Example of a full ASL listing of vector segment DLGTRANS: 

 EASI>FILE="irvine.pix"
 EASI>LTYP="FULL"
 EASI>ASLT=
 EASI>ASSN="DLGTRANS"
 EASI>R ASL

 ASL   Database Segment Listing      EASI/PACE V5.1  10:17 04-JUN-90

 irvine.pix                        [S 11PIC   512P   512L] 02-FEB-90
 
 Number:  16   Name:DLGTRANS           Type:116 [Vectors/Polygons  ]
    Creation: 11:52 01-FEB-90           Last Update: 15:07 13-MAR-90 
    Contents: VED transportation from ELTORO DLG
    Length  :     75.0 Kbytes  Units:UTM          Structures:   1500
    Bounds  :(  430435.12X, 3720560.38Y to  442111.91X, 3734495.32Y)

 History:
 MAS :VED transportation from ELTORO DLG             10:13 23-Mar-90
 VED :Vector Segment Created/Modified by VED.        15:07 13-MAR-90
 IIA :Transferred from:IM:[PROUD]JUNK.PIX;1          10:45 27-FEB-90
 IIA :Transferred from:IM:[PROUD]IRVINE.PIX;2        10:37 27-FEB-90
 IIA :Transferred from:E:\BRENT\ORAN512.PIX          07:24 02-FEB-90
 VED :Vector Segment Created/Modified by VED.        11:52 01-FEB-90
About PCI Help Gateway