User's Guide

CMHOST

Convert a LAS file name to a host file name.

Function:

Convert a LAS file name to a host file name.

Parameters:

INFILE
Input file. LAS file name to be converted to a host file name.

OUTFILE
Output file. INFILE is translated to a host file name and returned in the specified TAE string variable.

CASEFLAG("NO")
Case sensitivity. Should CMHOST be case sensitive.


  = YES: Output host filename
         will be case sensitive
  = NO:  Output host filename
         will be all lowercase

Examples:

  1. LAS> cmhost infile=[adaps.images]new.york;img outfile=outhost

    The LAS file name [ADAPS.IMAGES]NEW.YORK;IMG is translated to the host file name /adaps/images/new_york.img.

  2. LAS> cmhost infile=[adaps.images]new.york;img outfile=outhost caseflag=yes

    The LAS file name [ADAPS.IMAGES]NEW.YORK;IMG is translated to the host file name /ADAPS/IMAGES/NEW_YORK.IMG.

Description/Algorithm:

The specified host file name is converted to a LAS file name.

Nonfatal error messages:

    None.

Fatal Error Messages:

  1. [cmhost-fatal] Fatal error encountered

    The error message displayed immediately preceding this message is the specific error encountered. Processing is terminated.

  2. [cmhost-qstring] Error writing host name to vblock

    CMHOST was unable to write the host file name to the variable block. If the error persists contact the system administrator.

  3. [cmhost-vblock] Error returning host file name

    CMHOST was unable to send the variable block to TAE. If the error persists contact the system administrator.

User Notes:

    None.