tamadd (Add a TAM table)

-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.

Message ID	Description	Output destination
KFCA01700-E	Specified file is not a TAM file.	Standard error output
KFCA01701-E	Memory is inadequate.	Standard error output
KFCA01703-E	Address information of TAM service cannot be retrieved.	Standard error output
KFCA01704-E	TAM service has not been started.	Standard error output
KFCA01706-E	Length of TAM file name exceeds 63 characters.	Standard error output
KFCA01709-E	User does not have access right to TAM file.	Standard error output
KFCA01710-E	User does not have access right to a special file.	Standard error output
KFCA01712-E	Number of arguments specified in command is invalid.	Standard error output
KFCA01713-E	Specified file was not found.	Standard error output
KFCA01715-E	Specified TAM file name is not a special file name.	Standard error output
KFCA01716-E	Specified file is being used by another process.	Standard error output
KFCA01749-I	Cataloging of TAM table has been completed.	Message log file
KFCA01753-E	Overtime occurred.	Standard error output
KFCA01757-E	TAM table name exceeds 32 characters.	Standard error output
KFCA01758-E	Specified TAM table name has already been cataloged.	Standard error output
KFCA01760-E	Specified TAM file name has already been cataloged.	Standard error output
KFCA01761-E	I/O error occurred.	Standard error output
KFCA01762-E	Record damage occurred.	Standard error output
KFCA01764-E	V/R of TAM table is invalid.	Standard error output
KFCA01765-E	V/R of TAM server is invalid.	Standard error output
KFCA01767-E	Network error occurred in RPC.	Standard error output
KFCA01770-E	TAM service is terminating.	Standard error output
KFCA01772-E	Specified special file name has not been initialized for the OpenTP1 file system.	Standard error output
KFCA01773-E	System version used for file system creation does not match system version used to execute operation command.	Standard error output
KFCA01775-E	Error occurred during definition analysis.	Standard error output
KFCA02856-I	Help message	Standard output
KFCA02857-E	There is no free space for cataloging the specified TAM table.	Standard error output
KFCA02858-E	There are too many open OpenTP1 files.	Standard error output
KFCA02866-E	Record length of the specified TAM file exceeds the maximum record length.	Standard error output
KFCA02868-E	Loading timing argument is invalid.	Standard error output
KFCA02870-E	Access mode argument is invalid.	Standard error output
KFCA02886-E	The specified TAM table cannot be cataloged since the value of a table attribute is different from its previous value.	Standard error output

When start is specified for the loading timing, the corresponding TAM table will be loaded the next time the TAM service is started.
When the user is adding and cataloging a TAM table once removed from the online system, OpenTP1 checks for the following items. If different file attributes are found, a tamadd command error occurs.
- Record length
- Key length
- Key startup location
- Maximum number of records
- Index type
- Number of hash entries
- Presence/absence of the key area in records
The user may have removed a TAM table from the online system with the table opened by a UAP and then added the table to the system again. In this case, the status of whether the -u option was specified or not when the table was opened is inherited until it is re-opened with the appropriate UAP. If the user again adds the table and opens it, the status for specification of the -u option at this time becomes valid. Thus, it is recommended that the user remove the TAM table for which the -u option was specified when added to the online system after the UAP that opened the table, or specify the same option as used when the table was added previously when the table is added online again.
When you add and catalog a TAM table again that was once removed from the online system, you cannot change the option of the TAM table from -a reclck (if it is specified) to a different option or from an option other than -a reclck to -a reclck. If you change the option, the tamadd command will output the KFCA02886-E message.