deploy

Purpose

This command deploys configuration data for the specified SAG.

Notes:
  1. This command can take a few minutes to process. To ensure that you receive the result, use the .set command to set the timeout interval to a higher value. For example, to set the timeout interval to 300 seconds (=300 000 milliseconds), enter: 
    INST1.DNFSYSOU.DNFSAGCFG>.set -to 300000
    For more information about setting the timeout interval, see Setting environment variables for the CLI.
  2. To receive an event when the deployment completes, you must monitor services from the SAG. If the deployment fails, the event contains information about the possible cause.
  3. You must stop and start the SAG after you initially define the SAG global parameters and routing information. If you change the request queues, you must stop and start the SAG to make these changes effective.
Required access rights: See Table 4
Predefined roles that provide required access rights: See Table 2
Issue for OU: DNFSYSOU
Issue to service: DNFSAGCFG

Format

Read syntax diagramSkip visual syntax diagramdeploydep -sagsag -forcecfgsagnoreq

Parameters

-sag sag
Name of the SAG.
-force
The parameter influences the behavior of the deployment process:
  • If this parameter is not specified:
    • All approved changes to configuration entities in DNFSYSOU are deployed in the FTM SWIFT database, and thereby made current.
    • All configuration entities that affect the specified SAG and that have a timestamp that is more recent than that of the corresponding SAG object are deployed to the SAG.
  • If this parameter is specified, the resulting behavior depends on its value:
    cfg
    If this value is specified:
    • No changes to configuration entities in DNFSYSOU are deployed in the FTM SWIFT database.
    • All configuration entities that affect the specified SAG and that have a timestamp that is more recent than that of the corresponding SAG object are deployed to the SAG.
    sag
    If this value is specified:
    • No changes to configuration entities in DNFSYSOU are deployed in the FTM SWIFT database.
    • All configuration entities that affect the specified SAG are deployed to the SAG, regardless of their timestamp values, and regardless of whether they were created using FTM SWIFT or other means such as the SWIFT Alliance Web Platform.
    Specify this parameter when you want to be sure that the current contents of the FTM SWIFT database and the contents of the SAG are synchronized.
    noreq
    If this value is specified:
    • All approved changes to configuration entities in DNFSYSOU are deployed in the FTM SWIFT database, and thereby made current.
    • No configuration entities are deployed to the SAG.
    Specify this parameter when you want to deploy data in the FTM SWIFT database but the corresponding SAG is not yet available.

Examples

The following command deploys the approved changes in DNFSYSOU in the FTM SWIFT database, and to SAG1: 
INST1.DNFSYSOU.DNFSAGCFG>dep -sag SAG1