How do I append a LDS?

Document ID : KB000038691
Last Modified Date : 14/02/2018
Show Technical Document Details

Question:  

How do I add/append a LDS?

 

Answer:

1. Check the number of LDS Datasets currently in use by issuing the following command:

F SPLx,STAT X

Make note of the Append LDS count in the resulting display.

2. Bring down the CA Dispatch task cleanly by issuing the 99STOPCADS command.

3. Stop the CADDSPLx environment by issuing the following command:

F SPLx,CLOSE

4. Customize and execute CADSJCL member DDEXLDSA to allocate and initialize the new Appended LDS file. Review the JCL and make the following changes where necessary:

? Define the new LDS name in the DEFINE CLUSTER statement and specify the appropriate VOLUME and SPACE allocations. (size limit is 2G per LDS).

? Verify that the STEPLIB and ROOT DD statements are set correctly.

? Define the new LDS name on the APPEND statement that immediately follows the ROOT DD statement.

? Verify that the ROOT DDNAME = parameter is set to point to the name of the DD statement in the JCL that references the Root LDS name.

? Verify that the APD DDNAME = parameter is set to point to the name of the DD statement in the JCL that references the new LDS name to be appended. And, for the purposes of appending a new LDS, that the INIT control value is specified.

5. Review the output from the DDEXLDSA job. Make sure the job received RC=00. 

When successful, you will receive the following messages:

CADD603I UTIL Input complete - processing request

CADD608I UTIL SplHdr0 rewritten on ROOT

CADD609I UTIL CADDUTIL utility complete (rc=0000)

6. Restart the CADDSPLx environment by issuing the following command:

S CADDSPLx

7. Re-check the number of LDS Datasets currently in use by issuing the following command:

F SPLx,STAT X

Make note of the Append LDS count in the resulting display. It should have been incremented by 1 and you should now see an additional ACTIVE LDS file.

8. Restart the CA Dispatch started task. 

 

Additional Information:

 

The above procedure can also be found in the CA Dispatch 11.7 Systems Programmer Guide, chapter 7, in the section entitled "Add an Appended LDS" starting on or around page 195.