User's Guide

DIR2CD

Create a CD containing the specified data directory.

Function:

Create a CD containing the specified data directory. A label for the CD case will be created and an optional label can be printed on the CD media.

Parameters:

Subcommand -LIB:
Create a CD with a Library Archive case label.

COMMENT
Description of CD. A text string sent to the operator's terminal describing the CD to be mounted. This will allow the operator to mount the correct CD.

INDIR
Input directory. Complete path to the data directory. The directory where the data that is to be placed on the CD is contained.

WDIR
Working directory. Complete path to the working directory. This directory is used to create the necessary temporary files needed to create a CD.

CDID
CD Identification number. This is the 6-digit number assigned to the CD for library reference.

DATASET
This is a data set description.

FORMAT
Data format. A text field describing the format of the data.

CDLABEL(--)
CD label. The label to be printed on the CD-R media

NAME
Requesters initials. The initials assigned to the user for the EROS archive.

CODE
Code for the requesters group. The code assigned to the user's group for the EROS archive. For example, Software Development is assigned code 091.

PROJECT
Project abbreviation. The name of the project associated with the CD.

DESCRPT
Description of the CD set. Short description of the contents of the CD set.

NMONTHS(0)
Number of months to retain CD. The number of months from the current date before the CDs should be purged from the library. If a zero is entered, permanent storage is indicated.
Subcommand -FREE:
Create a CD with a Free Form case label.

COMMENT
Description of CD. A text string sent to the operator's terminal describing the CD to be mounted. This will allow the operator to mount the correct CD.

INDIR
Input directory. Complete path to the data directory. The directory where the data that is to be placed on the CD is contained.

WDIR
Working directory. Complete path to the working directory. This directory is used to create the necessary temporary files needed to create a CD.

CDID
CD Identification number. This is the 6-digit number assigned to the CD for library reference.

DATASET
This is a data set description.

FORMAT
Data format. A text field describing the format of the data.

TEXT
Text to print on the case label. This text will appear on the case label exactly as the user enters it.

CDLABEL(--)
CD label. The label to be printed on the CD-R media

Examples:

  1. LAS>dir2cd-lib comment="cd-r for tims/ames browse images" indir="[path.datadir]" wdir="[path.workdir]" cdid="000234" cdlabel="tims 24bit hdf 02/19/97 000234" name="dms" code="172" project="tims/ns-001" descrpt="ames/stennis browse images" nmonths=0

    A CD will be created containing the data found at [path.datadir] with a media label of "TIMS 24bit HDF 02/19/97 000234". A standard library archive label will be generated and the label will indicate a permanent archive date.

  2. LAS>dir2cd-free comment="cd-r for avhrr browse images" indir="[path.datadir]" wdir="[path.workdir]" cdid="000234" text=("line1","line2","line3") cdlabel="avhrr browse images xx/xx/xx"

    A CD will be created containing the data found at [path.datadir] with a media label of "AVHRR browse images xx/xx/xx". A free format case label will be generated which contains "line1", "line2", and "line3".

Description/Algorithm:

The directory parameter values are entered using LAS syntax, and converted to host syntax for the call to CDCD. Depending on the subcommand, a CD label will be generated using either the structured library format or a free format using input text

Non Fatal Error Messages:

    None.

Fatal Error Messages:

    None.

User Note:

  1. No error checking is done to determine if the data contained in the data directory exceeds the limitations of the CD-R. One CD currently holds 650 Megabytes.
  2. A related routine is MAKECD.