tagclink1(USP)

Name

tagclink1 : Joins together and outputs tag data that exists in the tag master.

              Records that do not match are discarded.

Synopsis

Usage   : tagclink1 [+ng[<fd>]] <mast_key>=<tran_key> <master> <tran>

Version : Fri May 12 13:53:17 JST 2017

Edition : 1

Description

Matches the field specified with <mast_key> in tag-formatted file <master>

with the field specified with <tran_key> in tag-formatted file <tran>,

joins together the matching lines and outputs them to standard output

in tag format.

Non-matching lines are discarded, but if you use the +ng option these

lines are output to standard error in tag format.

Unlike tagketugo1, <tran> does not need to be sorted.

If <master> is specified as "-" then the command reads from standard

input. If <tran> is omitted or specified as "-" then the command reads

from standard input.

If <master> or <tran> is a zero-byte file, an error occurs.

Even if <master> or <tran> is a null file (contains only a tag header),

the command processes normally.

Limitations

1. <master> must both be sorted on the key field with the exception

   of the first row (tag header).

2. <master> must have unique values in the key fields.

Example 1

$ keta master

M.CODE M.NAME M.AGE M.SEX

  0003   SMITH    026  WOM

  0005   JONES    050  MAN

  0007   NEWTON  042 WOM

$ keta tran

T.SEQ T.CODE T.A1 T.A2 T.A3

  001   0005  82 79 16

  001   0003  30 50 71

  001   0004  58 71 20

$ tagcketugo1 M.CODE=T.CODE master tran | keta

M.CODE M.NAME M.AGE M.SEX T.SEQ T.CODE T.A1 T.A2 T.A3

  0005   JONES    050  MAN 001 0005 82 79 16

  0003   SMITH    026  WOM 001 0003 30 50 71

Example 2 +ng option

$ tagcketugo1 +ng M.CODE=T.CODE master tran >ok 2>ng

$ keta ok

M.CODE M.NAME M.AGE M.SEX T.SEQ T.CODE T.A1 T.A2 T.A3

  0005   JONES    050  MAN 001 0005 82 79 16

  0003   SMITH    026  WOM 001 0003 30 50 71

$ keta ng

T.SEQ T.CODE T.A1 T.A2 T.A3

  001   0004  58 71 20

You can use a different output than standard error to avoid mixing data

with error messages.

$ tagcketugo1 +ng3 M.CODE=T.CODE master tran >ok 3>ng

Example 3 Read from standard input

$ cat tran   | tagcketugo1 M.CODE=T.CODE master

$ cat tran   | tagcketugo1 M.CODE=T.CODE master -

$ cat master | tagcketugo1 M.CODE=T.CODE - tran