tkey(1)                        DG/UX R4.11MU05                       tkey(1)


NAME
       tkey - set label and data translation parameters

SYNOPSIS
       tkey [ -d ] [ -f filename ] [ -p pseudo ] [ key = val ... ]

DESCRIPTION
       Tkey modifies file labels and record translation parameters.  If
       write label parameters are modified, they will be remain in effect
       only until the next tposn or twrite command (tposn and twrite reset
       write label parameters to their default values).  If you would like
       the write label values to remain in effect for multiple twrite
       operations, use the -d option.

   Options
       -d          "Default." Resets the default write labels according to
                   the keyword assignments provided.  If this option is
                   specified, changes to the write labels will remain
                   effective for any succeeding commands in the access
                   session.  If -d is not specified, the changes to the
                   write labels will affect only the command which
                   immediately follows tkey.

       -f filename "Keywords." The file filename contains the keyword
                   assignments.  See reelexchange_intro(1) for more
                   information on the format of this file.

       -p pseudo   "Tapesetname." Tapeset pseudo name as specified by the
                   preceding taccess command which initiated access to the
                   tapeset.

       key = val   "Keywords." Set keyword key to value val.  For additional
                   information about keywords and values, see
                   reelexchange_intro(1).  The keys that are available are:

                              Key     Field Name
                              ---     ----------
                              acc     Volume Accessibility
                              blen    Block Length
                              bat     Block Attribute
                              cre     Creation Date
                              cc      Control Character
                              cpid    Checkpoint Data Set ID
                              conv    Conversion Type
                              devid   Device ID
                              exp     Expiration Date
                              fid     File Identifier
                              fmt     Record Format
                              facc    File Accessibility
                              gen     Generation Number
                              genv    Version Number
                              job     Job Step Identification
                              own     Owner Name and Address Code
                              pchar   Pad Character
                              rlen    Record Length
                              rfmt    Record Format
                              sys     System Code
                              tchar   Terminating Character
                              usr     User Data

NOTE
       When using twrite on UNIX files containing fixed length records, the
       keyword tchar should be set to "none" if the records are not
       separated by a terminating character.

EXAMPLE
       tkey blen = 8192

       sets the block length to 8192 bytes (possible range = 1 to 32760).

FILES
       /var/reelexchange/d_ibm       IBM label defaults.
       /var/reelexchange/d_ansi      ANSI label defaults.

SEE ALSO
       reelexchange_intro(1), taccess(1), tdisplay(1), tlabel(1), tposn(1),
       tread(1), trelease(1), tsniff(1), twrite(1).


Licensed material--property of copyright holder(s)