tagclink1x(USP)

Name

tagclink1x : Joins together tag data that exists in the tag master.

               Records that do not match are discarded.

Synopsis

Usage   : tagclink1x [+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 the matching rows in tag format and outputs them to standard output.

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

lines are output to standard error in tag format.

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

Unlike tagcketugo1 the key field of <master> does not need to have

unique values.

Records are joined together where the key field of <master> and <tran>

are the same.

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).

Example 1

$ keta master

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

  0003   SMITH    026  WOM

  0005   JONES    050  MAN

  0005   JONES    048  WOM

  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

$ tagcketugo1x 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

  0005   JONES    048  WOM 001 0005 82 79 16

  0003   SMITH    026  WOM 001 0003 30 50 71

Example 2 +ng option

$ tagcketugo1x +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

  0005   JONES    048  WOM 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.

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

Example 3 Read from standard input

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

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

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