OpenTP1 Version 7 Operation
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:
-a access-mode~<alphabetic> <<read>>
Specifies the TAM table's access mode:
-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 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 |
Notes
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.