INSTALL

Purpose

Dynamically makes resource definitions available to an active CICS® region.

Format

Read syntax diagramSkip visual syntax diagram
>>-INSTALL--+-CPID=change_package-------+----------------------->
            '-EXTREF=external_reference-'   

>--,-SCHEME=migration_scheme------------------------------------>

>--+-------------------------------------+---------------------->
   |  (1)                                |   
   '-----,DATA=(qualification_exit_data)-'   

>--+-------------------+--+-------------------------------+----->
   |           .-NO--. |  |  (2)                          |   
   '-,QUIESCE=-+-YES-+-'  '-----,TARGETSCOPE=target_scope-'   

>--+-----------------------------------------+------------------>
   '-,FILE=(-+---------------------------+-)-'   
             +-RSCOPE=,USAGE=LOCAL-------+       
             '-RSCOPE=scope,USAGE=REMOTE-'       

>--+--------------------------------------------------------+--->
   '-,PROGRAM=(-+---------------------------+-,-MODE=mode-)-'   
                +-RSCOPE=,USAGE=LOCAL-------+                   
                '-RSCOPE=scope,USAGE=REMOTE-'                   

>--+--------------------------------------------------------+--->
   '-,TDQUEUE=(-+---------------------------+-,-MODE=mode-)-'   
                +-RSCOPE=,USAGE=LOCAL-------+                   
                '-RSCOPE=scope,USAGE=REMOTE-'                   

>--+------------------------------------------------------------+-->
   '-,TRANSACTION=(-+---------------------------+-,-MODE=mode-)-'   
                    +-RSCOPE=,USAGE=LOCAL-------+                   
                    '-RSCOPE=scope,USAGE=REMOTE-'                   

>--+-----------------------------------+-----------------------><
   '-,CONNECTION=(-REFASSGN=refassgn-)-'   

Notes:
  1. The DATA parameter is used only if your site has developed an exit program for the operations qualification exit point for an install action (OPQAIN01), and that exit point is active. CICS Configuration Manager passes the qualification_exit_data (a freeform text string) to your exit program. Your exit program can use the value to decide whether to allow or disallow each instance of an install action.
  2. If the change package contains candidates for migration to context-based target CICS configurations, target_scope is required.

For details on the PROGRAM, TDQUEUE, TRANSACTION, CONNECTION, and scope-related parameters, see the CICSPlex® SM documentation.


Reference Reference

Feedback


Timestamp icon Last updated: Friday, 1 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//ccv-batch-cmd-install.htm