What is IBM CALS?

Transfer unit declaration file provides all information necessary to uniquely identify the unit and contains the count of each transfer unit data file type contained in the transfer unit.  The file name used for each transfer unit declaration file shall be four characters long; the first shall be “D”; the last three characters shall begin at “001” and shall be incremented for each transfer unit. The last available transfer unit file name shall be “DZZZ”.

The transfer unit declaration file shall be written in fixed length records of 128 bytes each. Each record has a dedicated use, and each record is required. All the data shall be ASCII character format. When no data is placed and a record exists, the ASCII character string “EMPTY” shall be used. When the data required by a record is not applicable to the transfer unit, the ASCII character string “NA” shall be used. When data to be placed in a record does not exist, the ASCII character string “NONE” shall be used.

Table I. Transfer unit declaration file record.

RECORD ID

RECORD NAME

DESCRIPTION

version:

Version

A character string containing the military standard, revision level, change level, and effective date of the revision of the standard under which the transfer unit is transmitted. Under this standard, the character string shall be: version: MIL-STD-1849Bm 9m 19922103

srcsys:

Source system

A character string containing the name, address, and other information as specified by contract or other form of agreement needed to identify the system from which the transfer unit originated.

srcdocid:

Source system document identifier

The character string used by the source system to uniquely identify a document.

srcrelid:

Source system related document identifier

A character string used by the source system to identify another document to which document closely related.

chglvl:

Change/revision level and data of the document or product data

A character string indicating the revision, change level, and data of change to the document or product data in the following format.

chglvl: CHG TYPE, REV LEVEL, CHG_LEVEL, DATE

The date format shall be YYYYMMDD/HHHH:SS

dteisu:

Date of issue of the document

This shall be the date end time of issue of the original document or the latest revision to the document. Date /time format shall be

           YYYYMMDD/HHHH:SS

dstsys:

Destination system

A character string containing the name, address, and other information as specified by contract or other form of agreement needed to identify the destination system to which the transfer unit is going.

dstdocid:

Destination system document identifier

A character string used by the destination system to uniquely identify this document. This shall be the service or agency document number if one exists.

dstrelid:

Destination system related document identifier.

A character string used by the destination system to identify another document to which this document is closely related.

dtetm:

Date of transfer

The date the transfer unit was transferred by the source system to the transmission media. Date format shall be

           YYYYMMDD/HHHH:SS

dlvacc:

Delivery accounting

Free form record giving delivery information specified by contract or other form agreement, such as contract number.

filecnt:

File count

A character string count of the number of each type of data file in the transfer unit. Precede each file count with the letter from table III, used in the "data file name" to identify the type of file. Follow each number with comma, except for the last. Spaces may be used as additional separators after each comma. For example, a record containing  the string "T8, Q4, C1, R1" would indicate the transfer unit includes eight text files, four IGES files, one GCM file, and one raster illustration file. If there are no files of a particular type in the transfer unit, then the letter and file count are omitted.

ttlcls:

Title security label

A character string stating the highest security/sensitivity level or other restriction on the title of the document.

doccls:

Document security label

A character string stating the highest/sensitivity level or other restrictions on any file in the transfer unit.

doctyp:

Document type

A character string used by the source system to uniquely identify a document or engineering drawing type.

docttl:

Document title

A character string identifies the document.

transacttyp:

Transfer unit type.

A character string specifying the transfer type unit type. Allowable transfer unit types shall be one of the following:

PAGE IMAGE, PDL, SGML, PRODUCT DATA, MISCELLANEOUS

 

Table II. Change level (chglvl:) header record entries.

CHG TYPE

MEANING

REV LEVEL

CHG LEVEL

ORIGINAL

The document or product is the original.

0

0

ORIGINAL W/CHG

The document or product data is the original with changes incorporated.

0

Highest level changes included

REVISION

The document or product data is a complete revision to a document or product data.

Indicates current revision level

0

REVISION W/CHG

The document or product data is a complete revision of a document or product data with changes incorporated.

Indicates current revision level

Highest level changes included

CHANGE

The document or product data is change material to an original, revision, or supplement.

Indicates current revision level

0

OTHER

 

Used when none of above change types apply.

0

0

 

Transfer unit data files may be of the types shown in the table III. The file name for transfer unit data files shall be eight characters long, with the first four characters being the same as the transfer unit declaration file name. The fifth character shall be a code from Table III, identifying the type of  data file. The last three characters shall begin at “001” and shall be incremented for each transfer unit data file.

Table III :Data file name code letters and file format.

Code letter

Data file type

Fixed record length

Block length

A

Contract defined data file.

As specified by contract

As specified by contract

C

CGM file

80

800

E

EDIF file

As specified by contract

As specified by contract

G

Document type declaration file with no contained text data

256

2048

H

FOSI file

256

2048

I

IPC file

As specified by contract

As specified by contract

N

IPC file

As specified by contract

As specified by contract

P

PDL file

As specified by contract

As specified by contract

Q

IGES file

80

800

R

Raster file

128

2048

T

SGML coded text file

As specified by contract

As specified by contract

V

VHDL file

80

1920

X

Special word file

As specified by contract

As specified by contract

Z

Gray scale/color file

As specified by contract

As specified by contract

 


Table IV.: Transfer set data file header records

RECORD ID

RECORD NAME

DESCRIPTION

specversion:

Specification version

A character string identifying the document number, revision level, and date of the specification data file it’s in accordance with. The date format shall be YYYYMMDD

srcdocid:

Source system document number

A character string used by the system to uniquely identify the document to which this file belongs.

dstdocid:

Destination system document identifier

This character string is the same as the dstdocid identifier of the transfer unit declaration file. The parenthetical words “(Multiple Document)” should be appended to the identifier if the entry is intended for use in more than one transfer unit.

datfilid:

Data file identifier

This record shall contain the contract-specified description, identifying the contents and processing this file.

moduleid:

Module identifier

Used for SGML document file.

dtype:

Data type

In this record is an ASCII character string containing an integer that indicates the type of data contained in the file. For raster file, this value can be 1 (Type 1 Raster) or 2 (Type 2 Raster).

rorient:

Raster image orientation

Two right-justified, three character strings separated by a comma specifying respectively the direction of  the progression of successive pels along a line relative to the horizontal and the direction of the progression of successive lines relative to the pel path. If more than one value is applicable to the data file, the ASCII character string “MIXED” shall be used.

rpelcnt:

Raster image pel count

Two right-justified, six character strings separated by a comma specifying the image count of pels in the pel path direction, and lines in the line progression direction. If more than one value is applicable to the data file, the ASCII character string “MIXED” shall be used.

rdensty:

Raster image density

One right justified, four-character string representing the numerical value of the raster image density. If more than one value is applicable to the data file, the ASCII character string “MIXED” shall be used.

didid:

Data item description identifier

This record shall contain the applicable Data Item Description identification number.

doccls:

Data file security label

Character string stating the security/sensitivity level or other restrictions on the data file.

fosipubid:

PUBLIC identifier of an associated FOSI

For the document type declaration or text source file containing the document type declaration of the document being transferred.

notes:

Notes

Notes shall consist of free form text consistent with the number of characters permitted for records in this file.