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 IDDescriptionOutput destination
KFCA01700-EThe specified file is not a TAM file.Standard error output
KFCA01704-EThe TAM service is not started.Standard error output
KFCA01707-EThe TAM table name is incorrect.Standard error output
KFCA01709-EYou do not have the access permission for the TAM file.Standard error output
KFCA01710-EYou do not have the access permission for the special file.Standard error output
KFCA01711-EThe disk partition is not initialized as an OpenTP1 file system.Standard error output
KFCA01715-EThe specified TAM file is not a special file.Standard error output
KFCA01716-EThe specified file is being used by another process.Standard error output
KFCA01773-EThe version is invalid.Standard error output
KFCA02811-EThe memory for the process-specific area became insufficient while the command was executed.Standard error output
KFCA02812-EAn I/O error occurred.Standard error output
KFCA02818-EInput from the TAM file is impossible.Standard error output
KFCA02835-EThe record is damaged.Standard error output
KFCA26205-EThe TAM command is used incorrectly.Standard error output
KFCA26206-EHelp messageStandard output
KFCA26207-EAn error occurred when you attempted to acquire TAM synonym information.Standard error output