Setting / changing the Central Version Number (CV or CVNUMBER) for Dispatch region.

Products

• Dispatch Output Mgmt

Issue/Introduction

Each IDMS CV that runs on a CPU must have its own unique CV number. If you are running IDMS as a database application tool separate from Dispatch in the target CPU, see your IDMS DBA for a CV number reserve list.

CVNUMBER specifies the number of the central version associated with this IDMS system. As the SVC is delivered and installed, the CVNUMBER must be an integer in the range 0 through 31, and must be unique within the machine that Dispatch is running on. This includes all Dispatch systems and all IDMS systems.

A Dispatch regions CVNUMBER can be identified from the startup messages via the following startup message:

         DC201001 V1 T1 IDMS CENTRAL VERSION ?? STARTED

Resolution

Outline of the Instructions for changing the CVNUMBER

1. Make sure Dispatch comes down clean via a STOPCADS command. If you are attempting to change the CVNUMBER after a Dispatch U3977 CV number conflict abend, then you first need to execute the CADSJCL library job called DSEXPFIX to unlock/reset the database file "in use" flags before proceeding.
2. Run backups of the Dispatch related dictionary files (DICTDB, DLODDB and DMSGDB) before proceeding.
3. Locate and access the CADSOPTN library member called DSSYSXA.
   1. Towards the top of this member, verify that the SYSTEM statement is correct and that it points to the correct SYSTEM NUMBER (Typically SYSTEM 01) for the Dispatch region you want to modify.
   2. The next statement you will see in this member is the CVNUM statement. This is the statement you will modify in order to change the CV number associated to this Dispatch region. As an example, if the CV number you want to use for this Dispatch region is 7, you would specify CVNUM 07 on this statement.
   3. Save your change in this member.
   4. Locate and access the CADSJCL library job called DSEXUSR1, verify that the JCL symbolics are setup to include the correct DSHLQ values. 
4. For the purpose of changing the CV number, you do not need to pull in the DSNETWKX and DSUSERS control members. Thus, the &TERMS and &USERS symbolics and their associated //SYSIPT DD statements can be commented out. To actually compile the change to the CVNUMBER into the Dispatch dictionary, execute the DSEXUSR1 job.

 Additional Considerations:

It’s imperative that the DSEXUSR1 job end with RC=00 so be sure and check the output.
If for some reason the job ends with a non zero return code you must RESTORE the dictionary files from the backup taken in step 2 of the above outline.
You must correct the problem that caused the non-zero return code to be received, and then RERUN the DSEXUSR1 job.

If you attempt to start Dispatch after receiving a non zero return code in this job and fail to take the corrective actions outlined above, Dispatch will appear to be active but never  fully initializes. This leaves Dispatch in a completely unresponsive state and it will have to be CANCELED.

Additional Information

- Basic information about the DSEXUSR1 job and the CV number can be found in the CA Dispatch 11.7 Installation guide on page 90 where we document "STEP 5 - Define Users and the Network".

- More detailed information can be found in chapter 3 of the CA Dispatch System Programmers guide in the section entitled "User Generation Reference Section" and more specifically, in the section where we document the "SYSTEM Statement".