Guardian Procedure Calls Reference Manual (G06.25+)

ManualsBrandsHP ManualsServerHP NonStop G-Series

1621

Guardian Procedure Calls (W-Z)

Guardian Procedure Calls Reference Manual—522629-013

16-31

WRITEUPDATE[X] Procedures

the file is created, the value of write-count is rounded up to an even value

before the WRITEUPDATE[X] is executed.

You set the odd unstructured attribute with the FILE_CREATE_,

FILE_CREATELIST_, or CREATE procedure, or with the File Utility Program

(FUP) SET and CREATE commands.

•

Structured files

•

Calling WRITEUPDATE[X] after KEYPOSITION

If the call to WRITEUPDATE[X] immediately follows a call to KEYPOSITION in

which a nonunique alternate key is specified as the access path, the

WRITEUPDATE[X] fails. A subsequent call to FILE_GETINFO_ or FILEINFO

shows that error 46 (invalid key) occurred. However, if an intermediate call to

READ[X] or READLOCK[X] is performed, the call to WRITEUPDATE[X] is

permitted because a unique record is identified.

•

Specifying write-count for entry-sequenced files

For entry-sequenced files, the value of

write-count must match exactly the

write-count value specified when the record was originally inserted into the

file.

•

Changing the primary-key of a key-sequenced record

An update to a record in a key-sequenced file cannot alter the value of the

primary-key field. Changing the primary-key field must be done by

deleting the old record (WRITEUPDATE[X] with

write-count = 0) and

inserting a new record with the key field changed (WRITE).

•

Current-state indicators after WRITEUPDATE[X]

After a successful WRITEUPDATE[X], the current-state indicators remain

unchanged.

Magnetic Tape Considerations

•

WRITEUPDATE[X] is permitted only on the 3202 Controller for the 5103 or 5104

Tape Drives. This command is not supported on any other controller/tape drive

combination.

WRITEUPDATE[X] is specifically not permitted on the following controller/tape

drive pairs:

3206 Controller and the 5106 Tri-Density Tape Drive

3207 Controller and the 5103 & 5104 Tape Drives

3208 Controller and the 5130 & 5131 Tape Drives

•

Specifying the correct number of bytes written