TRANSFER Reference Manual

WRITE-PROFILE-REC
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–523
WRITE-PROFILE-REC Operation
WRITE-PROFILE-REC writes or updates a user-maintained record in the depot Profile
file. The UOW must start on a word boundary. Each response consumes a whole
number of words of the IPC reply.
To update a record, you supply the update counter for that record in the UPDATE-
CONTROL field. When you issue the WRITE-PROFILE-REC UOW with a nonzero
value in the UPDATE-CONTROL field, the TRANSFER delivery system first reads the
old record (locking it temporarily) and compares the UPDATE-CONTROL value in the
record with that which you have supplied; the old record must already exist. If the
two values match, or if the value you have supplied is -1:
The record is updated with the new information supplied in PROFILE-DATA.
The updated record is written (and unlocked) with its old UPDATE-CONTROL
value incremented by 1. The TRANSFER delivery system ensures that this value
wraps around from 9999 to 1 every ten thousand updates.
To write a new record, set the UPDATE-CONTROL field to zero. The TRANSFER
delivery system takes the input from PROFILE-DATA, and writes it into a new record
in the file. If the record indicated by REC-TYPE and REC-SEQ-NUM already exists,
the TRANSFER delivery system returns an error condition.