OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

tamhsls (Display the synonym information about a hash-format TAM file and TAM table)

Format

tamhsls {-m TAM-table-name|TAM-file-name}

Function

The tamhsls command displays the information about the synonyms in the specified hash-format TAM table and TAM file.

Options

-m

Displays the information about the synonyms in the loaded TAM table while OpenTP1 is online. When you specify this option, specify in the command argument the name of the TAM table that is already loaded.

Command arguments

TAM-table-name~<identifier of 1 to 32 characters>

Specify the name of a hash-format TAM table that is already loaded for which you want to display the information about synonyms. When you specify a tree-format TAM table, the information will not be displayed.

TAM-file-name~<path name>

Specify the name of a hash-format TAM file for which you want to display the information about synonyms using a full path name. When you specify a tree-format TAM table, the information will not be displayed.

Output format

HASH FUNCTION NO = a
     RECNO  EFFECT  SYN_COUNT  KEY
     bb..bb   cc...cc   dd...dd      ee...ee

a
Hash function number used
0: Old hash number
1: New hash number

bb...bb
Record number in the TAM table

cc...cc
Validity
0: Not used.
1: Being used.

dd...dd
Number of records in the synonym area corresponding to the applicable record (hash area). When a UAP accesses a record in a TAM table, the UAP uses the hash function to convert a key value into a hash value and uses it as a record number. Next, the UAP compares key value ee...ee indicating the record number and the key value the UAP specifies. If ee...ee does not match the key value specified by the UAP, the UAP performs a sequential search for dd...dd records in the synonym area.

ee...ee
Key value (hexadecimal) in the applicable record (hash area)

Output messages

Message ID Description Output destination
KFCA01700-E The specified file is not a TAM file. Standard error output
KFCA01704-E The TAM service is not started. Standard error output
KFCA01707-E The TAM table name is incorrect. Standard error output
KFCA01709-E You do not have the access permission for the TAM file. Standard error output
KFCA01710-E You do not have the access permission for the special file. Standard error output
KFCA01711-E The disk partition is not initialized as an OpenTP1 file system. Standard error output
KFCA01715-E The specified TAM file is not a special file. Standard error output
KFCA01716-E The specified file is being used by another process. Standard error output
KFCA01773-E The version is invalid. Standard error output
KFCA02811-E The memory for the process-specific area became insufficient while the command was executed. Standard error output
KFCA02812-E An I/O error occurred. Standard error output
KFCA02818-E Input from the TAM file is impossible. Standard error output
KFCA02835-E The record is damaged. Standard error output
KFCA26205-E The TAM command is used incorrectly. Standard error output
KFCA26206-E Help message Standard output
KFCA26207-E An error occurred when you attempted to acquire TAM synonym information. Standard error output