W2AT gate, ADD_REPLACE_ATOMSERVICE function

The ADD_REPLACE_ATOMSERVICE function is used to add or replace an ATOMSERVICE resource in the Web 2.0 domain. If an ATOMSERVICE resource with the same name already exists, it is replaced if it is disabled; otherwise, this function fails with reason code ATOMSERVICE_ENABLED.

Input Parameters

ATOM_TYPE
Type of Atom document associated with this ATOMSERVICE resource.
Values for the parameter are:
  • CATEGORY
  • COLLECTION
  • FEED
  • SERVICE
ATOMSERVICE
Name of the ATOMSERVICE resource to be installed.
RESOURCE_SIGNATURE
The INSTALL resource signature for the new ATOMSERVICE resource.
BINDFILE
Optional Parameter
Name of the XSD bind file for this ATOMSERVICE resource.
CONFIGFILE
Optional Parameter
Name of the Atom configuration file for this ATOMSERVICE resource.
MESSAGE
Optional Parameter
Specifies whether installation messages will be issued.
Values for the parameter are:
  • NO
  • YES
RESOURCE_NAME
Optional Parameter
Name of the CICS resource associated with this ATOMSERVICE resource.
RESOURCE_TYPE
Optional Parameter
The type of the CICS resource associated with this ATOMSERVICE resource.
Values for the parameter are:
  • FILE
  • PROGRAM
  • TSQUEUE
STATUS
Optional Parameter
Specifies the state in which the new ATOMSERVICE resource is installed.
Values for the parameter are:
  • DISABLED
  • ENABLED

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • ATOMSERVICE_ENABLED
  • ATOMSERVICE_EXISTS
  • BINDFILE_ERROR
  • BINDFILE_NOT_FOUND
  • BINDFILE_NOTAUTH
  • BROWSE_END
  • CONFIGFILE_NOT_FOUND
  • CONFIGFILE_NOTAUTH
  • CONFIGURATION_ERROR
  • CONFLICTING_ATTRIBUTES
  • DIRECTORY_ERROR
  • GETMAIN_FAILED
  • INVALID_BROWSE_TOKEN
  • NOT_AUTH
  • NOT_FOUND
  • NOT_POSSIBLE
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
  • INVALID_SIGNATURE
RESPONSE
Standard domain response values.
Values for the parameter are:
  • OK
  • EXCEPTION
  • DISASTER
  • INVALID
  • KERNERROR
  • PURGED


dfhs3_W2ATadd_replace_atomservice.html | Timestamp icon Last updated: Monday, 5 June 2017