Starting Your Product › How to Configure Without CA MSM › Step 7. Update CAIRIM Parameters › Optional DSINIT functions

Optional DSINIT functions

The following are the optional DSINIT function sub-parameters:

PARM(CADSSVC)

Request DSINIT to initialize or refresh the CA Dispatch SVC.

PRODUCT(CA DISPATCH) VERSION(DSB7) INIT(DSINIT) PARM(CADSSVC)

The following conditions apply:

• All Dispatch regions using this SVC must be down.
• Performs initial Load or refresh of the Dispatch SVC.
• Used to modify the Dispatch SVC if it has been changed.
• The CADDSPL SNT and load modules are not affected.

PARM(CADDSNT,DELETE)

If all CADDSPLx tasks are inactive, modules CADDMSG, CADDMSGI, CADDSPAU, CADDSPOI, CADDTABU, and the CADDSNT control block are removed from the operating system.

PRODUCT(CA DISPATCH) VERSION(DSB7) INIT(DSINIT) PARM(CADDSNT,DELETE)

The following tasks are performed:

• All CADDSPL tasks must be inactive.
• Deletes the CADDSPL CADDSNT control block from storage
• Deletes the CADDSPL the load modules CADDMSG, CADDMSGI, CADDSPAU, CADDSPOI, or CADDTABU from storage.
• Must perform another PARM(CADDSNT, INIT) to reinitialize environment.
• Does not delete the Dispatch SVC.
• Used only in exceptional situations.

PARM(CADDSNT,REFRESH)

Look for CADDSNT and no active tasks with CA Dispatch. When these conditions are met, load a new copy of CADDSNT. The prior copy of CADDSNT is deleted.

PRODUCT(CA DISPATCH) VERSION(DSB7) INIT(DSINIT) PARM(CADDSNT,REFRESH)

The following tasks are performed:

• All CADDSPLx tasks must be inactive.
• Existing CADDSNT is deleted from storage
• Create a new CADDSPL CADDSNT control block for new CADDSPL tasks
• Used only in exceptional situations.

PARM(module,DELETE)

Request to remove a specific module from storage; module is either CADDMSG, CADDMSGI, CADDSPAU, CADDSPOI, or CADDTABU.

PRODUCT(CA DISPATCH) VERSION(DSB7) INIT(DSINIT) PARM(module,DELETE)

The following tasks are performed:

• All CADDSPL tasks must be inactive
• Deletes a specific CADDSPL load module; can be CADDMSG, CADDMSGI, CADDSPAU, CADDSPOI, or CADDTABU from storage.
• Used only in exceptional situations
• Perform PARM(modulename,REFRESH) to reload a new copy of the module after deleting it.
• Used only in exceptional situations

PARM(module,REFRESH)

Requests that a new copy of module, which is either CADDMSG, CADDMSGI, CADDSPAU, CADDSPOI, or CADDTABU, be loaded into storage. The prior copy of the refreshed module is deleted.

PRODUCT(CA DISPATCH) VERSION(DSB7) INIT(DSINIT) PARM(module,REFRESH)

The following tasks are performed:

• CADDSPLx tasks must be inactive
• Existing refreshed module is deleted from storage
• Adds/loads a new copy of a specific CADDSPL load module, can be CADDMSG, CADDMSGI, CADDSPAU, CADDSPOI, or CADDTABU
• Used only in exceptional situations

Important Usage Information

Prior to starting CA Dispatch or CADDSPL, Client sites must execute CAS9 with either of the following initialization statements to set up the complete CA Dispatch r11 environment:

PRODUCT(CA DISPATCH)  VERSION(DSB7) INIT(DSINIT)

or

PRODUCT(CA DISPATCH) VERSION(DSB7)INIT(DSINIT) PARM(CADDSNT,INIT)

Executing the statement without the PARM sub-parameter defaults to PARM(CADDSNT,INIT).

The PARM(CADDSNT,INIT) performs the following tasks:

• Builds the CADDSNT control block in storage.
• Loads the 5 refreshable CADDSPL load modules into storage.
  • CADDMSG—'Message Processing Module'
  • CADDMSGI—'Specific Spool Message Table for CADDSPL Intercept'
  • CADDSPAU—'Spool SSI Allocate/Deallocate'
  • CADDSPOI—'Spool Open/Close Front-End'
  • CADDTABU—'MVS and JES Table of Offsets'
• Performs a check to determine whether the CA Dispatch level of software is compatible with the operating system of the site or the JES software level.

  If the operating system level is not supported, the initialization will end with a return code of 8, and the following messages will be displayed:

  *CADS012E DSINIT Unsupported release/level of JES
  *CADS014I DSINIT JESLIT   value is: z/OS 1.16
  

• Installs the Dispatch SVC.

  Successful initializations will end with a zero conditional code. Incomplete or Unsuccessful initializations will end with a non-zero conditional code.

  Important! Incomplete or unsuccessful initialization may result in the inability to start the product.

• A successful initialization will display the following messages:

  CAS9115I - INPUT: PRODUCT(CA DISPATCH)   VERSION(DSB7) INIT(DSINIT)
  CADS015I DSINIT Module CADDSNT  at 8575F2A0 added
  CADS015I DSINIT Module CADDMSG  at 8575E000 added
  CADS015I DSINIT Module CADDMSGI at 8575D000 added
  CADS015I DSINIT Module CADDSPAU at 8575B000 added
  CADS015I DSINIT Module CADDSPOI at 85756BF0 added
  CADS015I DSINIT Module CADDTABU at 85755000 added
  CADS014I DSINIT JESLIT   value is: z/OS 1.16
  CADS004I CA Dispatch Initialization Successful
  CAS9130I - MODULE DSINIT COMPLETE, RC=00
  

• An unsuccessful initialization will display the following messages:

  CAS9115I - Input: PRODUCT(CA DISPATCH) VERSION(DSB7) INIT(DSINIT)
  CADS015I DSINIT Module CADDSNT  at 97B632A0 added
  CADS015I DSINIT Module CADDMSG  at 9A988000 added
  CADS015I DSINIT Module CADDMSGI at 987CD000 added
  CADS015I DSINIT Module CADDSPAU at 987D7000 added
  CADS015I DSINIT Module CADDSPOI at 98738000 added
  CADS015I DSINIT Module CADDTABU at 987D5000 added
  CADS012E DSINIT Unsupported release/level of JES
  CADS014I DSINIT JESLIT   value is: z/OS 1.12
  CADS004I CA Dispatch Initialization Successful
  CAS9140E - Init error: CA DISPATCH     Ver DSB7, Init routineRC=0008
  

• Execute CAS9 / DSINIT PARM(CADDSNT,DELETE) to remove the CADDSPL components from the operating system. Shut down all Dispatch and CADDSPLx tasks (if running multiple Dispatch/CADDSPL regions). Once everything is inactive, execute CAS9 / DSINIT with PARM(CADDSNT,DELETE) to remove the components.

  Note: The PARM(CADDSNT,DELETE) does not remove the Dispatch SVC from the system.

• If you modify the CA Dispatch SVC between IPLs, you must execute CAS9 / DSINIT PARM(CADSSVC) to reinstall the new version of the SVC.

  This can be done repeatedly if need be. You no longer need to change the VERSION(DSB7) to force a reinstall of the SVC (as you did in prior releases of Dispatch). This function may be used more often under z/OS 1.9 if using the default AllowUserKeyCSA(NO) configuration as you will need to modify the SVC to run non-KEY 8.

  Note: You cannot repeatedly run PARM(CADDSNT,INIT) to reinstall the SVC; as you will receive an error message: "CADS001E CADDSNT already active" if it has been previously executed.

• If you need to apply a specific fix or maintenance to one or more of the five refreshable CADDSPL load modules:
  1. Stop all open intercept tasks.
  2. Shut down all CA Dispatch and CADDSPL tasks (if running multiple Dispatch/CADDSPL regions).
  3. Once everything is inactive:
     1. Execute CAS9 / DSINIT PARM(CADDSNT,DELETE) to remove everything,
     2. Execute a CAS9 / DSINIT PARM(CADDSNT,INIT) to reinstall everything new or refresh the affected load modules using CAS9/DSB7INIT PARM(modulename,REFRESH

     The PARM(CADDSNT,DELETE) does not remove the Dispatch SVC.