Accessing Auxiliary Storage: FILE › Temporary Storage › FILE Functions for Temporary Storage › Add a New Temporary Storage Queue Record

Add a New Temporary Storage Queue Record

Follow this procedure to add a temporary storage queue record:

1. Specify one of the following:

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

   Then complete the SIZE= field as shown next:

   SIZE= size of data area
   

   In addition, 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).
2. Press Enter. The following information displays 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 will be 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.
4. To write the newly added record, complete the following fields:

   FUNC=PUTQ
   ENTRY= record's relative position in queue
   RCID= temporary storage identification
   SIZE= size of data in the record
   

   and, if appropriate, the following two optional fields:

   SUBFUNC= REPL 	(to replace an existing record)
   STORFAC=AUX
   

   or

   STORFAC=MAIN
   

   • Use STORFAC=AUX to place the record on a direct access storage device. This is the default.
   • Use STORFAC=MAIN to place the record in main storage.
5. Press Enter. The following information displays on the FILE screen:
   • Without SUBFUNC=REPL, the MESSAGE= field shows the message TS QUEUE RECORD WRITTEN.
   • With SUBFUNC=REPL, the MESSAGE= field shows the message TS QUEUE RECORD WRITTEN AND REPLACED.
   • The SIZE= field gives the size of the work area.
   • The work area displays, beginning with the byte indicated in the LOC=field.