Accessing Auxiliary Storage: FILE › Transient Data › FILE Functions for Transient Data Records › Add a New Transient Data Record

Add a New Transient Data Record

Follow this procedure to add a new transient data record:

1. Complete the FUNC= and DESTID= fields, and then complete the SIZE= field:

   DESTID= transient data destination
   FUNC=ADDN 	  (to obtain a new work area)
   

   or

   FUNC=ADDU 	  (to use the data in the existing work area)
   SIZE= size of the data area Note: The SIZE cannot be higher than permitted for the destination.
   

   In addition, you can complete the following optional field if appropriate:

   DATA= characters
   

   • If you enter FUNC=ADDN, the characters you type in the DATA= field 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 (if the new work area is larger than the present one).

   You are advised to enter the DESTID= field before entering the FUNC= field when you begin working with a particular destination. If only the DESTID= is entered, the properties of the transient data queue are shown for your verification. This can, for example, help you avoid entering a FUNC=ADDU for an extrapartition destination that is now open for input.

2. Press Enter. The following information is on the FILE screen:
   • The MESSAGE= field shows the message WORK AREA OBTAINED.
   • The SIZE= field gives the size of the work area (the size is the maximum permitted).

   The obtained work area is displayed, beginning with the byte indicated in the LOC= field.

3. Make any necessary changes to the newly obtained work area. To write the newly added record, complete the following fields:

   FUNC=PUT
   DESTID= transient data destination
   

   and, if appropriate, the following optional field:

   SIZE= size of the record         (if smaller than work area)
   

4. Press Enter.

   The MESSAGE= field on the FILE screen shows the message TD RECORD WRITTEN.

Examples

To add a new 100‑byte record (with most of its fields blank) to the transient data destination CSSL:

Specify the following, and then press Enter:

FUNC=ADDN 
DESTID=CSSL
DATA=C' ' 
SIZE= 100   or   64 	(for FORMAT=D)

Make changes to the work area.

Specify the following, and then press Enter:

FUNC=PUT
DESTID=CSSL

To add another new record to the transient data destination in Example 1, using the work area from Example 1:

Specify the following, and then press Enter:

FUNC=ADDU

Make changes to the work area.

Specify the following, and then press Enter:

FUNC=PUT
DESTID=CSSL