Example of using the CICSPlex SM API to create an ATOM service definition

You can use the CICSPlex® SM API to create a CICS® ATOM service definition in both the CICS CSD and in CICSPlex SM BAS.

Create an ATOM service definition using BAS

This example shows the creation of a CICS ATOM service definition, atomdef_name, using BAS.

CONNECT CONTEXT(cicsplex_name)                      1 

CRERESG_RESGROUP     = resgroup_name
CRERESG_DESCRIPTION  = “Sample BAS Resource Group”

CREATE OBJECT(RESGROUP)
       FROM(CRERESG)
       LENGTH(resgroup_tbl_len)                     2  
        
CREATOM_DEFVER       = "1";                         3  
CREATOM_NAME         = atomdef_name;
CREATOM_DESCRIPTION  = “Dummy FILE ATOM Service”;        
CREATOM_STATUS       = "ENABLED”;     
CREATOM_ATOMTYPE     = "FEED";           
CREATOM_RESOURCETYPE = "FILE";             
CREATOM_RESOURCENAME = atomdef_file_name;             
CREATOM_BINDFILE     = atomdef_bindfile_name;
CREATOM_CONFILE      = atomdef_configfile_name; 
             
CREATE OBJECT(ATOMDEF)
       FROM(CREATOM)
       LENGTH(atomdef_tbl_len)
       PARM(RESGROUP(resgroup_name).)                4

Create an ATOM service definition from the CSD

This example shows the creation of a CICS ATOM service definition, atomdef_name, into a CICS System, cics_system_name, in the CSD group csd_group_name.

CONNECT CONTEXT(cicsplex_name)

CREATOM_CSDGROUP     = csd_group_name;               5  
CREATOM_NAME         = atomdef_name;
CREATOM_DESCRIPTION  = “Dummy FILE ATOM Service”;        
CREATOM_STATUS       = "ENABLED”;     
CREATOM_ATOMTYPE     = "FEED";           
CREATOM_RESOURCETYPE = "FILE";             
CREATOM_RESOURCENAME = atomdef_file_name;             
CREATOM_BINDFILE     = atomdef_bindfile_name;
CREATOM_CONFILE      = atomdef_configfile_name; 
             
CREATE OBJECT(ATOMDEF)
       SCOPE(cics_system_name)                       6  
       FROM(CREATOM)
       LENGTH(atomdef_tbl_len)
       PARM(CSD.)                                    7

1 BAS resource definitions are stored in the CICSplex identified by the CONTEXT parameter. Do not specify the SCOPE parameter for BAS resource definitions.

2 If the RESGROUP parameter is specified on the CREATE command, the RESGROUP must have already been defined to the CICSplex.

3 If you are defining a BAS resource, you must specify a value for the DEFVER parameter. If the DEFVER parameter and the CSDGROUP parameter are both specified the CSDGROUP parameter is ignored.

4 Adding a BAS CICS resource definition to a resource group is optional. If you specify the RESGROUP parameter, the CICS resource definition is associated with a BAS resource group. Resource definitions can also be explicitly added to one or more resource groups using a PERFORM command with the action set to ACTION=ADDTOGRP.

5 The CSDGROUP parameter specifies the CSD group in which the resource definition are created. All CSD resource definitions must have belong to a group; if the group does not already exist in the CSD it is created dynamically.

6 The SCOPE parameter specifies the name of the CICS system using the CSD in which the definition is to be created.

7 Specifying the CSD attribute on the PARM parameter identifies the resource definition as a CSD resource definition.