IBM Tivoli Web Access for Information Management

Chapter 9. Using shadow s-words and data attribute records 93

Figure 9-2 Problem Completion Information page

9.2 Status shadow s-words and data attribute records

Now, we take a closer look at how shadow s-words actually work. Remember there is a rule

that you can only have one data attribute record in a data view record with the same s-word.

For example, we could not have data attribute records BLQ&STAT and BLQ&STA1 both in

the same data view record for the status s-word S0BEE. Therefore, to get around this

restriction, shadow s-words and shadow data attribute records come into play. We have to

use multiple data attribute records and specify a shadow s-word in place of the real s-word.

A shadow s-word is a unique s-word in the dictionary that is mapped back to the s-word being

shadowed by means of using an entry in the BLQPARMS file (see 9.2.1, “The BLQPARMS

file” on page 94).

94 IBM Tivoli Web Access for Information Management

Web Access ships the following shadow s-words for your use:

5140 XDAR/A1

5141 XDAR/A2

5142 XDAR/A3

5143 XDAR/A4

5144 XDAR/A5

5145 XDAR/B1

5146 XDAR/B2

5147 XDAR/B3

5148 XDAR/B4

5149 XDAR/B5

514A XDAR/C1

514B XDAR/C2

514C XDAR/C3

514D XDAR/C4

514E XDAR/C5

514F XDAR/D1

5150 XDAR/D2

5151 XDAR/D3

5152 XDAR/D4

5153 XDAR/D5

5154 XDAR/E1

5155 XDAR/E2

5156 XDAR/E3

5157 XDAR/E4

5158 XDAR/E5

5159 XDAR/E6

515A XDAR/E7

515B XDAR/E8

515C XDAR/E9

515D XDAR/E10

There is nothing special

per se

about these s-words. XDAR at the beginning of each s-word

just serves as a visual clue that you are working with a data attribute record shadow s-word.

The /An - /Enn is just a group scheme to help you keep track of which ones you have used

thus far. These same s-words can be used in all record types. The /An s-words could be used

for status in problem records, as well as change records. No data is ever stored in a record

using these s-words. They merely serve as placeholders for the actual s-word (S0BEE in our

example). If you need additional shadow s-words, you can create them in the user 8000

section of the dictionary.

9.2.1 The BLQPARMS file

In the BLQPARMS file, there is a record_type statement for each record type. Under that

statement, you should include a dar_shadows statement for each of your shadow s-word

scenarios.

Chapter 9. Using shadow s-words and data attribute records 95

Example 9-1 BLQPARMS file

record_type PROBLEM S0032 P

create_view BLQVPROB BLQ0P001.html

update_view BLQVPROB BLQ0P101.html

retrieve_view BLQVPROB BLQ0P200.html

search_view BLQVPROB BLQ0P301.html BLQWSRLP.html

copy_view BLQVPROB BLQ0P001.html

history_view BLQVPROB BLQ0P205.html

print_view BLQVPROB BLQ0P206.html

text_append S0E01

dar_shadows S0BEE S5140 S5141 S5142

dar_shadows S0C0E S5154 S5155 S5156 S5157 S5158

9.2.2 Status shadow s-words

In Example 9-1, S5140, S5141, and S5142 are shadows for S0BEE. What this means is that

when S5140, S5141, and S5142 are encountered during processing, they are replaced with

S0BEE so that S0BEE is actually stored with the data in the record.

Example 9-1 also shows that completion code S0C0E has five shadows. You need a

dar_shadow list for each s-word for which you want to have shadow data attribute records.

Use as many dar_shadows keywords as you need.

9.2.3 Status shadow data attribute records

Each of these shadow s-words has a corresponding shadow data attribute record, as shown

in Example 9-2.

Example 9-2 Shadow data attribute record

S5140 BLQ&PSA1 Problem initial status

S5141 BLQ&PSA2 Problem tracking status

S5142 BLQ&PSA3 Problem closing Status

9.2.4 Groups that include the status shadows

If you look at the REPORTER group in data view record BLQVPROB, you see data attribute

record BLQ&PSA1 (see Figure 9-5 on page 97); in the TRACK group data attribute record,

BLQ&PSA2; and in the CLOSE group data attribute record, BLQ&PSA3. However, in

Figure 9-5 on page 97, you also see that data attribute record BLQ&PSAL is selected.

BLQ&PSAL (see Figure 9-3 on page 96) includes all the validation patterns that are in data

attribute records BLQ&PSA1 (see Figure 9-4 on page 96), BLQ&PSA2, and BLQ&PSA3.

32

32

BLG&PSAL also specifies the real Status s-word S0BEE.