Example of using the CICSPlex SM API to install a remote CICS transaction definition

You can use the CICSPlex® SM API to install a remote CICS® transaction definition either from the CSD or by using BAS.

For resources which support Function Shipping, BAS provides the ability to install both the local and remote definitions of the resource simultaneously. If you are installing from the CSD, discrete local and remote definitions must be installed separately.

Installing a remote CICS transaction definition using BAS

This example shows the installation of a local CICS transaction definition, trandef_name, into a routing CICS System, cics_system_local, and the reciprocal remote definition, with the same name, into the target CICS System, cics_system_remote, both of which are in the CICSplex, cicsplex_name.

CONNECT CONTEXT(cicsplex_name) SCOPE(cicsplex_name)

GET OBJECT(TRANDEF)
    CRITERIA(NAME=trandef_name AND DEFVER=def_ver.)) 
    
PERFORM SET ACTION(INSTALL)
        PARM(TARGET(cics_system_remote) 
             USAGE(REMOTE)
             MODE(DYNAM) 
             RELATED(cics_system_local).)

Installing a remote CICS transaction definition from the CSD

This example shows the installation of a local CICS transaction definition, trandef_name, into the local CICS System, cics_system_local, in the CSD group, csd_group_local. This is followed by a separate install of the reciprocal remote definition, into the target CICS System, cics_system_remote, in the CSD group, csd_group_remote.

CONNECT CONTEXT(cicsplex_name) SCOPE(cicsplex_name)

GET OBJECT(TRANDEF)
    SCOPE(cics_system_local)
    PARM(CSDGROUP(csd_group_local).)
    CRITERIA(NAME=trandef_name.)
    
PERFORM SET ACTION(CSDINSTALL)

GET OBJECT(TRANDEF)
    SCOPE(cics_system_remote)
    PARM(CSDGROUP(csd_group_remote).)
    CRITERIA(NAME=trandef_name.)
    
PERFORM SET ACTION(CSDINSTALL)