Accessing Auxiliary Storage: FILE › BDAM Files › FILE Functions for BDAM Records › Update a BDAM Record

Update a BDAM Record

To update a record, specify the UPDATE operation on the FILE definition.

1. Complete the following fields:

   FUNC=GETU
   RCID= record identification
   

   and, if appropriate, the following optional field:

   RETMETH=KEY       (if RCID contains a deblocking key)
   RETMETH=RELREC    (if RCID contains a deblocking relative record number)               
   

   Note: You can update any record that was obtained by a GET, BEGB, NEXT, or PREV function. If you already have a record, go to Step 3.

2. Press Enter, and the following information appears on the FILE screen:
   • The MESSAGE= field shows the message RECORD OBTAINED FOR UPDATE
   • The MODE= field indicates UPDATE
   • The RETNRCID= field contains the returned record's identification
   • The SIZE= field gives the size of the data in the record (the size of the work area)
   • The data displays, beginning with the byte indicated in the LOC= field
3. Make any necessary changes to the displayed record's data. However, the record will not change until you perform Step 4 and rewrite the updated record. To rewrite the updated record, complete the following fields, and then press Enter:

   FUNC=PUT
   RCID= record identification
   

   and, if appropriate, the following optional field:

   SIZE= size of record's data	  (required for variable length)
   

   The following information appears on the FILE screen:

   • The MESSAGE= field shows the message RECORD UPDATED.
   • The MODE= field becomes blank.
   • The data in the work area continues to display.
4. If you change your mind and decide not to update the record at this time, complete the FUNC= field as shown next, and press Enter:

   FUNC=REL
   

   The following information appears on the FILE screen:

   • The MESSAGE= field shows the message FWA HAS BEEN RELEASED.
   • The MODE= field becomes blank.
   • The data in the work area continues to display.