tamadd (Add a TAM table)

Format

tamadd [-r loading-timing] [-a access-mode] [-i] [-j]
      TAM-table-name TAM-file-name

Function

The tamadd command adds a specified TAM table and catalogs it into the online system.

The added and cataloged TAM table is placed on logical shutdown status.

Options

-r loading-timing~<alphabetic> <<start>>

Specifies the TAM table loading timing:

start
Load the TAM table during execution of the tamadd command
cmd
Load the TAM table during execution of the tamload command
lib
Load the TAM table when dc_tam_open function is issued

-a access-mode~<alphabetic> <<read>>

Specifies the TAM table's access mode:

read
Reference type
rewrite
Update type that cannot be added or deleted
write
Update type that can be added or deleted
reclck
Update type that does not secure table locks. reclck allows addition and deletion.

-i

Assumes the specified TAM table as an I/O failure continuation table. This promises an advantage: if an I/O error occurs when a TAM file is updated, the appropriate TAM table is not placed on error shutdown status in the same online system. In other words, the TAM file can be accessed even after the I/O error has occurred. One thing to consider is to prevent mismatch in TAM file status when online operation restarts. To this end, the affected TAM table (I/O failure continuation table) is removed from the online system when it restarts. The user must recover the TAM file, and add and catalog to the online system again.

If the -i option is omitted, the TAM file is placed on error shutdown status when an I/O error occurs during updating of the TAM file.

-j

When a TAM record is updated, collects the differential journal. The differential journal is collected by comparing the record before updating and that after updating. The records are compared from the beginning in 32 bytes. Where a difference is encountered first from the beginning becomes the journal collection starting position. Then, the records are compared from the end in 32 bytes. Where a difference is encountered first from the end becomes the journal collection ending position.

When there is more than one difference in one record, a larger journal is collected than the amount of difference.

Command arguments

TAM-table-name~<character string, identifier, 1-32 characters>

Specifies the name of the TAM table to be added and cataloged.

TAM-file-name~<path name>

Specifies the name of the TAM file corresponding to the TAM table, expressed as the full path name.

Output messages

Message IDDescriptionOutput destination
KFCA01700-ESpecified file is not a TAM file.Standard error output
KFCA01701-EMemory is inadequate.Standard error output
KFCA01703-EAddress information of TAM service cannot be retrieved.Standard error output
KFCA01704-ETAM service has not been started.Standard error output
KFCA01706-ELength of TAM file name exceeds 63 characters.Standard error output
KFCA01709-EUser does not have access right to TAM file.Standard error output
KFCA01710-EUser does not have access right to a special file.Standard error output
KFCA01712-ENumber of arguments specified in command is invalid.Standard error output
KFCA01713-ESpecified file was not found.Standard error output
KFCA01715-ESpecified TAM file name is not a special file name.Standard error output
KFCA01716-ESpecified file is being used by another process.Standard error output
KFCA01749-ICataloging of TAM table has been completed.Message log file
KFCA01753-EOvertime occurred.Standard error output
KFCA01757-ETAM table name exceeds 32 characters.Standard error output
KFCA01758-ESpecified TAM table name has already been cataloged.Standard error output
KFCA01760-ESpecified TAM file name has already been cataloged.Standard error output
KFCA01761-EI/O error occurred.Standard error output
KFCA01762-ERecord damage occurred.Standard error output
KFCA01764-EV/R of TAM table is invalid.Standard error output
KFCA01765-EV/R of TAM server is invalid.Standard error output
KFCA01767-ENetwork error occurred in RPC.Standard error output
KFCA01770-ETAM service is terminating.Standard error output
KFCA01772-ESpecified special file name has not been initialized for the OpenTP1 file system.Standard error output
KFCA01773-ESystem version used for file system creation does not match system version used to execute operation command.Standard error output
KFCA01775-EError occurred during definition analysis.Standard error output
KFCA02856-IHelp messageStandard output
KFCA02857-EThere is no free space for cataloging the specified TAM table.Standard error output
KFCA02858-EThere are too many open OpenTP1 files.Standard error output
KFCA02866-ERecord length of the specified TAM file exceeds the maximum record length.Standard error output
KFCA02868-ELoading timing argument is invalid.Standard error output
KFCA02870-EAccess mode argument is invalid.Standard error output
KFCA02886-EThe specified TAM table cannot be cataloged since the value of a table attribute is different from its previous value.Standard error output

Notes