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

Add a New BDAM Record

To add a record, specify the ADD operation on the FILE definition.

Note: Before reading this section, consult the BDAM Data Sets section of the File Control Section in the IBM CICS/VS Application Programmer's Reference Manual.

1. Complete one of the following fields:

   FUNC=ADDN 	   (to obtain a new work area)
   FUNC=ADDU 	   (to use the data in the existing work area)
   

   Complete the following optional field, if appropriate:

   DATA= characters
   

   • If you enter FUNC=ADDN, the characters you type in the DATA= field are those that will fill the work area.
   • If you enter FUNC=ADDU, the characters you type in the DATA= field will fill the newly obtained data space (the new work area might be larger than the present one for a variable‑length file).
2. Press Enter. The following information displays on the FILE screen:
   • The MESSAGE= field shows the message WORK AREA OBTAINED.
   • The MODE= field indicates ADD.
   • The SIZE= field gives the size of the work area (the size is the maximum permitted for this particular file).
   • The obtained work area displays, beginning with the byte indicated in the LOC= field.
3. Make any necessary changes to the newly obtained work area.
4. To write the newly added record, complete the following fields as follows:

   FUNC=PUT
   RCID= record identification
   

   and, if appropriate, the following optional field:

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

   Press Enter. The following information appears on the FILE screen:

   • The MESSAGE= field shows the message RECORD ADDED.
   • The MODE= field becomes blank.
   • The data in the work area continues to display.
5. If you change your mind and decide not to add any records at this time, complete the FUNC= field as shown following, 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.