We announced the upcoming end-of-support for AWS SDK for JavaScript v2.
We recommend that you migrate to AWS SDK for JavaScript v3. For dates, additional details, and information on how to migrate, please refer to the linked announcement.

Class: AWS.AppTest

Inherits:
AWS.Service show all
Identifier:
apptest
API Version:
2022-12-06
Defined in:
(unknown)

Overview

Constructs a service interface object. Each API operation is exposed as a function on service.

Service Description

AWS Mainframe Modernization Application Testing provides tools and resources for automated functional equivalence testing for your migration projects.

Sending a Request Using AppTest

var apptest = new AWS.AppTest();
apptest.createTestCase(params, function (err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Locking the API Version

In order to ensure that the AppTest object uses this specific API, you can construct the object by passing the apiVersion option to the constructor:

var apptest = new AWS.AppTest({apiVersion: '2022-12-06'});

You can also set the API version globally in AWS.config.apiVersions using the apptest service identifier:

AWS.config.apiVersions = {
  apptest: '2022-12-06',
  // other service API versions
};

var apptest = new AWS.AppTest();

Version:

  • 2022-12-06

Constructor Summary collapse

Property Summary collapse

Properties inherited from AWS.Service

apiVersions

Method Summary collapse

Methods inherited from AWS.Service

makeRequest, makeUnauthenticatedRequest, setupRequestListeners, defineService

Constructor Details

new AWS.AppTest(options = {}) ⇒ Object

Constructs a service object. This object has one method for each API operation.

Examples:

Constructing a AppTest object

var apptest = new AWS.AppTest({apiVersion: '2022-12-06'});

Options Hash (options):

  • params (map)

    An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.

  • endpoint (String|AWS.Endpoint)

    The endpoint URI to send requests to. The default endpoint is built from the configured region. The endpoint should be a string like 'https://{service}.{region}.amazonaws.com' or an Endpoint object.

  • accessKeyId (String)

    your AWS access key ID.

  • secretAccessKey (String)

    your AWS secret access key.

  • sessionToken (AWS.Credentials)

    the optional AWS session token to sign requests with.

  • credentials (AWS.Credentials)

    the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.

  • credentialProvider (AWS.CredentialProviderChain)

    the provider chain used to resolve credentials if no static credentials property is set.

  • region (String)

    the region to send service requests to. See AWS.AppTest.region for more information.

  • maxRetries (Integer)

    the maximum amount of retries to attempt with a request. See AWS.AppTest.maxRetries for more information.

  • maxRedirects (Integer)

    the maximum amount of redirects to follow with a request. See AWS.AppTest.maxRedirects for more information.

  • sslEnabled (Boolean)

    whether to enable SSL for requests.

  • paramValidation (Boolean|map)

    whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:

    • min [Boolean] — Validates that a value meets the min constraint. This is enabled by default when paramValidation is set to true.
    • max [Boolean] — Validates that a value meets the max constraint.
    • pattern [Boolean] — Validates that a string value matches a regular expression.
    • enum [Boolean] — Validates that a string value matches one of the allowable enum values.
  • computeChecksums (Boolean)

    whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)

  • convertResponseTypes (Boolean)

    whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to true.

  • correctClockSkew (Boolean)

    whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to false.

  • s3ForcePathStyle (Boolean)

    whether to force path style URLs for S3 objects.

  • s3BucketEndpoint (Boolean)

    whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an endpoint to be provided explicitly to the service constructor.

  • s3DisableBodySigning (Boolean)

    whether S3 body signing should be disabled when using signature version v4. Body signing can only be disabled when using https. Defaults to true.

  • s3UsEast1RegionalEndpoint ('legacy'|'regional')

    when region is set to 'us-east-1', whether to send s3 request to global endpoints or 'us-east-1' regional endpoints. This config is only applicable to S3 client. Defaults to legacy

  • s3UseArnRegion (Boolean)

    whether to override the request region with the region inferred from requested resource's ARN. Only available for S3 buckets Defaults to true

  • retryDelayOptions (map)

    A set of options to configure the retry delay on retryable errors. Currently supported options are:

    • base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
    • customBackoff [function] — A custom function that accepts a retry count and error and returns the amount of time to delay in milliseconds. If the result is a non-zero negative value, no further retry attempts will be made. The base option will be ignored if this option is supplied. The function is only called for retryable errors.
  • httpOptions (map)

    A set of options to pass to the low-level HTTP request. Currently supported options are:

    • proxy [String] — the URL to proxy requests through
    • agent [http.Agent, https.Agent] — the Agent object to perform HTTP requests with. Used for connection pooling. Defaults to the global agent (http.globalAgent) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment.
    • connectTimeout [Integer] — Sets the socket to timeout after failing to establish a connection with the server after connectTimeout milliseconds. This timeout has no effect once a socket connection has been established.
    • timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
    • xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
    • xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
  • apiVersion (String, Date)

    a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by apiVersions). Specify 'latest' to use the latest possible version.

  • apiVersions (map<String, String|Date>)

    a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.

  • logger (#write, #log)

    an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests

  • systemClockOffset (Number)

    an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global AWS.config object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds.

  • signatureVersion (String)

    the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.

  • signatureCache (Boolean)

    whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to true.

  • dynamoDbCrc32 (Boolean)

    whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default: true.

  • useAccelerateEndpoint (Boolean)

    Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default: false.

  • clientSideMonitoring (Boolean)

    whether to collect and publish this client's performance metrics of all its API requests.

  • endpointDiscoveryEnabled (Boolean|undefined)

    whether to call operations with endpoints given by service dynamically. Setting this

  • endpointCacheSize (Number)

    the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000

  • hostPrefixEnabled (Boolean)

    whether to marshal request parameters to the prefix of hostname. Defaults to true.

  • stsRegionalEndpoints ('legacy'|'regional')

    whether to send sts request to global endpoints or regional endpoints. Defaults to 'legacy'.

  • useFipsEndpoint (Boolean)

    Enables FIPS compatible endpoints. Defaults to false.

  • useDualstackEndpoint (Boolean)

    Enables IPv6 dualstack endpoint. Defaults to false.

Property Details

endpointAWS.Endpoint (readwrite)

Returns an Endpoint object representing the endpoint URL for service requests.

Returns:

  • (AWS.Endpoint)

    an Endpoint object representing the endpoint URL for service requests.

Method Details

createTestCase(params = {}, callback) ⇒ AWS.Request

Creates a test case.

Service Reference:

Examples:

Calling the createTestCase operation

var params = {
  name: 'STRING_VALUE', /* required */
  steps: [ /* required */
    {
      action: { /* required */
        compareAction: {
          input: { /* required */
            file: {
              fileMetadata: { /* required */
                dataSets: [
                  {
                    ccsid: 'STRING_VALUE', /* required */
                    format: FIXED | VARIABLE | LINE_SEQUENTIAL, /* required */
                    length: 'NUMBER_VALUE', /* required */
                    name: 'STRING_VALUE', /* required */
                    type: PS /* required */
                  },
                  /* more items */
                ],
                databaseCDC: {
                  sourceMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: z/OS-DB2 /* required */
                  },
                  targetMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: PostgreSQL /* required */
                  }
                }
              },
              sourceLocation: 'STRING_VALUE', /* required */
              targetLocation: 'STRING_VALUE' /* required */
            }
          },
          output: {
            file: {
              fileLocation: 'STRING_VALUE'
            }
          }
        },
        mainframeAction: {
          actionType: { /* required */
            batch: {
              batchJobName: 'STRING_VALUE', /* required */
              batchJobParameters: {
                '<String>': 'STRING_VALUE',
                /* '<String>': ... */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            },
            tn3270: {
              script: { /* required */
                scriptLocation: 'STRING_VALUE', /* required */
                type: Selenium /* required */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            }
          },
          resource: 'STRING_VALUE', /* required */
          properties: {
            dmsTaskArn: 'STRING_VALUE'
          }
        },
        resourceAction: {
          cloudFormationAction: {
            resource: 'STRING_VALUE', /* required */
            actionType: Create | Delete
          },
          m2ManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE', /* required */
            properties: {
              forceStop: true || false,
              importDataSetLocation: 'STRING_VALUE'
            }
          },
          m2NonManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE' /* required */
          }
        }
      },
      name: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE'
    },
    /* more items */
  ],
  clientToken: 'STRING_VALUE',
  description: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
apptest.createTestCase(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      The name of the test case.

    • description — (String)

      The description of the test case.

    • steps — (Array<map>)

      The steps in the test case.

      • namerequired — (String)

        The name of the step.

      • description — (String)

        The description of the step.

      • actionrequired — (map)

        The action of the step.

        • resourceAction — (map)

          The resource action of the step action.

          • m2ManagedApplicationAction — (map)

            The AWS Mainframe Modernization managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
            • properties — (map)

              The properties of the AWS Mainframe Modernization managed application action.

              • forceStop — (Boolean)

                Force stops the AWS Mainframe Modernization managed action properties.

              • importDataSetLocation — (String)

                The import data set location of the AWS Mainframe Modernization managed action properties.

          • m2NonManagedApplicationAction — (map)

            The AWS Mainframe Modernization non-managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization non-managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization non-managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
          • cloudFormationAction — (map)

            The CloudFormation action of the resource action.

            • resourcerequired — (String)

              The resource of the CloudFormation action.

            • actionType — (String)

              The action type of the CloudFormation action.

              Possible values include:
              • "Create"
              • "Delete"
        • mainframeAction — (map)

          The mainframe action of the step action.

          • resourcerequired — (String)

            The resource of the mainframe action.

          • actionTyperequired — (map)

            The action type of the mainframe action.

            • batch — (map)

              The batch of the mainframe action type.

              • batchJobNamerequired — (String)

                The job name of the batch.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch.

            • tn3270 — (map)

              The tn3270 port of the mainframe action type.

              • scriptrequired — (map)

                The script of the TN3270 protocol.

                • scriptLocationrequired — (String)

                  The script location of the scripts.

                • typerequired — (String)

                  The type of the scripts.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The data set names of the TN3270 protocol.

          • properties — (map)

            The properties of the mainframe action.

            • dmsTaskArn — (String)

              The DMS task ARN of the mainframe action properties.

        • compareAction — (map)

          The compare action of the step action.

          • inputrequired — (map)

            The input of the compare action.

            • file — (map)

              The file in the input.

              • sourceLocationrequired — (String)

                The source location of the input file.

              • targetLocationrequired — (String)

                The target location of the input file.

              • fileMetadatarequired — (map)

                The file metadata of the input file.

                • dataSets — (Array<map>)

                  The data sets of the file metadata.

                  • typerequired — (String)

                    The type of the data set.

                    Possible values include:
                    • "PS"
                  • namerequired — (String)

                    The name of the data set.

                  • ccsidrequired — (String)

                    The CCSID of the data set.

                  • formatrequired — (String)

                    The format of the data set.

                    Possible values include:
                    • "FIXED"
                    • "VARIABLE"
                    • "LINE_SEQUENTIAL"
                  • lengthrequired — (Integer)

                    The length of the data set.

                • databaseCDC — (map)

                  The database CDC of the file metadata.

                  • sourceMetadatarequired — (map)

                    The source metadata of the database CDC.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata of the database CDC.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
          • output — (map)

            The output of the compare action.

            • file — (map)

              The file of the output.

              • fileLocation — (String)

                The file location of the output file.

    • clientToken — (String)

      The client token of the test case.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      The specified tags of the test case.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testCaseId — (String)

        The test case ID of the test case.

      • testCaseVersion — (Integer)

        The test case version of the test case.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createTestConfiguration(params = {}, callback) ⇒ AWS.Request

Creates a test configuration.

Service Reference:

Examples:

Calling the createTestConfiguration operation

var params = {
  name: 'STRING_VALUE', /* required */
  resources: [ /* required */
    {
      name: 'STRING_VALUE', /* required */
      type: { /* required */
        cloudFormation: {
          templateLocation: 'STRING_VALUE', /* required */
          parameters: {
            '<String>': 'STRING_VALUE',
            /* '<String>': ... */
          }
        },
        m2ManagedApplication: {
          applicationId: 'STRING_VALUE', /* required */
          runtime: MicroFocus, /* required */
          listenerPort: 'STRING_VALUE',
          vpcEndpointServiceName: 'STRING_VALUE'
        },
        m2NonManagedApplication: {
          listenerPort: 'STRING_VALUE', /* required */
          runtime: BluAge, /* required */
          vpcEndpointServiceName: 'STRING_VALUE', /* required */
          webAppName: 'STRING_VALUE'
        }
      }
    },
    /* more items */
  ],
  clientToken: 'STRING_VALUE',
  description: 'STRING_VALUE',
  properties: {
    '<String>': 'STRING_VALUE',
    /* '<String>': ... */
  },
  serviceSettings: {
    kmsKeyId: 'STRING_VALUE'
  },
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
apptest.createTestConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      The name of the test configuration.

    • description — (String)

      The description of the test configuration.

    • resources — (Array<map>)

      The defined resources of the test configuration.

      • namerequired — (String)

        The name of the resource.

      • typerequired — (map)

        The type of the resource.

        • cloudFormation — (map)

          The CloudFormation template of the resource type.

          • templateLocationrequired — (String)

            The template location of the CloudFormation template.

          • parameters — (map<String>)

            The CloudFormation properties in the CloudFormation template.

        • m2ManagedApplication — (map)

          The AWS Mainframe Modernization managed application of the resource type.

          • applicationIdrequired — (String)

            The application ID of the AWS Mainframe Modernization managed application.

          • runtimerequired — (String)

            The runtime of the AWS Mainframe Modernization managed application.

            Possible values include:
            • "MicroFocus"
          • vpcEndpointServiceName — (String)

            The VPC endpoint service name of the AWS Mainframe Modernization managed application.

          • listenerPort — (String)

            The listener port of the AWS Mainframe Modernization managed application.

        • m2NonManagedApplication — (map)

          The AWS Mainframe Modernization non-managed application of the resource type.

          • vpcEndpointServiceNamerequired — (String)

            The VPC endpoint service name of the AWS Mainframe Modernization non-managed application.

          • listenerPortrequired — (String)

            The listener port of the AWS Mainframe Modernization non-managed application.

          • runtimerequired — (String)

            The runtime of the AWS Mainframe Modernization non-managed application.

            Possible values include:
            • "BluAge"
          • webAppName — (String)

            The web application name of the AWS Mainframe Modernization non-managed application.

    • properties — (map<String>)

      The properties of the test configuration.

    • clientToken — (String)

      The client token of the test configuration.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      The tags of the test configuration.

    • serviceSettings — (map)

      The service settings of the test configuration.

      • kmsKeyId — (String)

        The KMS key ID of the service settings.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testConfigurationId — (String)

        The test configuration ID.

      • testConfigurationVersion — (Integer)

        The test configuration version.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createTestSuite(params = {}, callback) ⇒ AWS.Request

Creates a test suite.

Service Reference:

Examples:

Calling the createTestSuite operation

var params = {
  name: 'STRING_VALUE', /* required */
  testCases: { /* required */
    sequential: [
      'STRING_VALUE',
      /* more items */
    ]
  },
  afterSteps: [
    {
      action: { /* required */
        compareAction: {
          input: { /* required */
            file: {
              fileMetadata: { /* required */
                dataSets: [
                  {
                    ccsid: 'STRING_VALUE', /* required */
                    format: FIXED | VARIABLE | LINE_SEQUENTIAL, /* required */
                    length: 'NUMBER_VALUE', /* required */
                    name: 'STRING_VALUE', /* required */
                    type: PS /* required */
                  },
                  /* more items */
                ],
                databaseCDC: {
                  sourceMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: z/OS-DB2 /* required */
                  },
                  targetMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: PostgreSQL /* required */
                  }
                }
              },
              sourceLocation: 'STRING_VALUE', /* required */
              targetLocation: 'STRING_VALUE' /* required */
            }
          },
          output: {
            file: {
              fileLocation: 'STRING_VALUE'
            }
          }
        },
        mainframeAction: {
          actionType: { /* required */
            batch: {
              batchJobName: 'STRING_VALUE', /* required */
              batchJobParameters: {
                '<String>': 'STRING_VALUE',
                /* '<String>': ... */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            },
            tn3270: {
              script: { /* required */
                scriptLocation: 'STRING_VALUE', /* required */
                type: Selenium /* required */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            }
          },
          resource: 'STRING_VALUE', /* required */
          properties: {
            dmsTaskArn: 'STRING_VALUE'
          }
        },
        resourceAction: {
          cloudFormationAction: {
            resource: 'STRING_VALUE', /* required */
            actionType: Create | Delete
          },
          m2ManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE', /* required */
            properties: {
              forceStop: true || false,
              importDataSetLocation: 'STRING_VALUE'
            }
          },
          m2NonManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE' /* required */
          }
        }
      },
      name: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE'
    },
    /* more items */
  ],
  beforeSteps: [
    {
      action: { /* required */
        compareAction: {
          input: { /* required */
            file: {
              fileMetadata: { /* required */
                dataSets: [
                  {
                    ccsid: 'STRING_VALUE', /* required */
                    format: FIXED | VARIABLE | LINE_SEQUENTIAL, /* required */
                    length: 'NUMBER_VALUE', /* required */
                    name: 'STRING_VALUE', /* required */
                    type: PS /* required */
                  },
                  /* more items */
                ],
                databaseCDC: {
                  sourceMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: z/OS-DB2 /* required */
                  },
                  targetMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: PostgreSQL /* required */
                  }
                }
              },
              sourceLocation: 'STRING_VALUE', /* required */
              targetLocation: 'STRING_VALUE' /* required */
            }
          },
          output: {
            file: {
              fileLocation: 'STRING_VALUE'
            }
          }
        },
        mainframeAction: {
          actionType: { /* required */
            batch: {
              batchJobName: 'STRING_VALUE', /* required */
              batchJobParameters: {
                '<String>': 'STRING_VALUE',
                /* '<String>': ... */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            },
            tn3270: {
              script: { /* required */
                scriptLocation: 'STRING_VALUE', /* required */
                type: Selenium /* required */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            }
          },
          resource: 'STRING_VALUE', /* required */
          properties: {
            dmsTaskArn: 'STRING_VALUE'
          }
        },
        resourceAction: {
          cloudFormationAction: {
            resource: 'STRING_VALUE', /* required */
            actionType: Create | Delete
          },
          m2ManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE', /* required */
            properties: {
              forceStop: true || false,
              importDataSetLocation: 'STRING_VALUE'
            }
          },
          m2NonManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE' /* required */
          }
        }
      },
      name: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE'
    },
    /* more items */
  ],
  clientToken: 'STRING_VALUE',
  description: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
apptest.createTestSuite(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      The name of the test suite.

    • description — (String)

      The description of the test suite.

    • beforeSteps — (Array<map>)

      The before steps of the test suite.

      • namerequired — (String)

        The name of the step.

      • description — (String)

        The description of the step.

      • actionrequired — (map)

        The action of the step.

        • resourceAction — (map)

          The resource action of the step action.

          • m2ManagedApplicationAction — (map)

            The AWS Mainframe Modernization managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
            • properties — (map)

              The properties of the AWS Mainframe Modernization managed application action.

              • forceStop — (Boolean)

                Force stops the AWS Mainframe Modernization managed action properties.

              • importDataSetLocation — (String)

                The import data set location of the AWS Mainframe Modernization managed action properties.

          • m2NonManagedApplicationAction — (map)

            The AWS Mainframe Modernization non-managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization non-managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization non-managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
          • cloudFormationAction — (map)

            The CloudFormation action of the resource action.

            • resourcerequired — (String)

              The resource of the CloudFormation action.

            • actionType — (String)

              The action type of the CloudFormation action.

              Possible values include:
              • "Create"
              • "Delete"
        • mainframeAction — (map)

          The mainframe action of the step action.

          • resourcerequired — (String)

            The resource of the mainframe action.

          • actionTyperequired — (map)

            The action type of the mainframe action.

            • batch — (map)

              The batch of the mainframe action type.

              • batchJobNamerequired — (String)

                The job name of the batch.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch.

            • tn3270 — (map)

              The tn3270 port of the mainframe action type.

              • scriptrequired — (map)

                The script of the TN3270 protocol.

                • scriptLocationrequired — (String)

                  The script location of the scripts.

                • typerequired — (String)

                  The type of the scripts.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The data set names of the TN3270 protocol.

          • properties — (map)

            The properties of the mainframe action.

            • dmsTaskArn — (String)

              The DMS task ARN of the mainframe action properties.

        • compareAction — (map)

          The compare action of the step action.

          • inputrequired — (map)

            The input of the compare action.

            • file — (map)

              The file in the input.

              • sourceLocationrequired — (String)

                The source location of the input file.

              • targetLocationrequired — (String)

                The target location of the input file.

              • fileMetadatarequired — (map)

                The file metadata of the input file.

                • dataSets — (Array<map>)

                  The data sets of the file metadata.

                  • typerequired — (String)

                    The type of the data set.

                    Possible values include:
                    • "PS"
                  • namerequired — (String)

                    The name of the data set.

                  • ccsidrequired — (String)

                    The CCSID of the data set.

                  • formatrequired — (String)

                    The format of the data set.

                    Possible values include:
                    • "FIXED"
                    • "VARIABLE"
                    • "LINE_SEQUENTIAL"
                  • lengthrequired — (Integer)

                    The length of the data set.

                • databaseCDC — (map)

                  The database CDC of the file metadata.

                  • sourceMetadatarequired — (map)

                    The source metadata of the database CDC.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata of the database CDC.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
          • output — (map)

            The output of the compare action.

            • file — (map)

              The file of the output.

              • fileLocation — (String)

                The file location of the output file.

    • afterSteps — (Array<map>)

      The after steps of the test suite.

      • namerequired — (String)

        The name of the step.

      • description — (String)

        The description of the step.

      • actionrequired — (map)

        The action of the step.

        • resourceAction — (map)

          The resource action of the step action.

          • m2ManagedApplicationAction — (map)

            The AWS Mainframe Modernization managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
            • properties — (map)

              The properties of the AWS Mainframe Modernization managed application action.

              • forceStop — (Boolean)

                Force stops the AWS Mainframe Modernization managed action properties.

              • importDataSetLocation — (String)

                The import data set location of the AWS Mainframe Modernization managed action properties.

          • m2NonManagedApplicationAction — (map)

            The AWS Mainframe Modernization non-managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization non-managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization non-managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
          • cloudFormationAction — (map)

            The CloudFormation action of the resource action.

            • resourcerequired — (String)

              The resource of the CloudFormation action.

            • actionType — (String)

              The action type of the CloudFormation action.

              Possible values include:
              • "Create"
              • "Delete"
        • mainframeAction — (map)

          The mainframe action of the step action.

          • resourcerequired — (String)

            The resource of the mainframe action.

          • actionTyperequired — (map)

            The action type of the mainframe action.

            • batch — (map)

              The batch of the mainframe action type.

              • batchJobNamerequired — (String)

                The job name of the batch.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch.

            • tn3270 — (map)

              The tn3270 port of the mainframe action type.

              • scriptrequired — (map)

                The script of the TN3270 protocol.

                • scriptLocationrequired — (String)

                  The script location of the scripts.

                • typerequired — (String)

                  The type of the scripts.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The data set names of the TN3270 protocol.

          • properties — (map)

            The properties of the mainframe action.

            • dmsTaskArn — (String)

              The DMS task ARN of the mainframe action properties.

        • compareAction — (map)

          The compare action of the step action.

          • inputrequired — (map)

            The input of the compare action.

            • file — (map)

              The file in the input.

              • sourceLocationrequired — (String)

                The source location of the input file.

              • targetLocationrequired — (String)

                The target location of the input file.

              • fileMetadatarequired — (map)

                The file metadata of the input file.

                • dataSets — (Array<map>)

                  The data sets of the file metadata.

                  • typerequired — (String)

                    The type of the data set.

                    Possible values include:
                    • "PS"
                  • namerequired — (String)

                    The name of the data set.

                  • ccsidrequired — (String)

                    The CCSID of the data set.

                  • formatrequired — (String)

                    The format of the data set.

                    Possible values include:
                    • "FIXED"
                    • "VARIABLE"
                    • "LINE_SEQUENTIAL"
                  • lengthrequired — (Integer)

                    The length of the data set.

                • databaseCDC — (map)

                  The database CDC of the file metadata.

                  • sourceMetadatarequired — (map)

                    The source metadata of the database CDC.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata of the database CDC.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
          • output — (map)

            The output of the compare action.

            • file — (map)

              The file of the output.

              • fileLocation — (String)

                The file location of the output file.

    • testCases — (map)

      The test cases in the test suite.

      • sequential — (Array<String>)

        The sequential of the test case.

    • clientToken — (String)

      The client token of the test suite.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      The tags of the test suite.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testSuiteId — (String)

        The suite ID of the test suite.

      • testSuiteVersion — (Integer)

        The suite version of the test suite.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTestCase(params = {}, callback) ⇒ AWS.Request

Deletes a test case.

Service Reference:

Examples:

Calling the deleteTestCase operation

var params = {
  testCaseId: 'STRING_VALUE' /* required */
};
apptest.deleteTestCase(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testCaseId — (String)

      The test case ID of the test case.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTestConfiguration(params = {}, callback) ⇒ AWS.Request

Deletes a test configuration.

Service Reference:

Examples:

Calling the deleteTestConfiguration operation

var params = {
  testConfigurationId: 'STRING_VALUE' /* required */
};
apptest.deleteTestConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testConfigurationId — (String)

      The test ID of the test configuration.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTestRun(params = {}, callback) ⇒ AWS.Request

Deletes a test run.

Service Reference:

Examples:

Calling the deleteTestRun operation

var params = {
  testRunId: 'STRING_VALUE' /* required */
};
apptest.deleteTestRun(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testRunId — (String)

      The run ID of the test run.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTestSuite(params = {}, callback) ⇒ AWS.Request

Deletes a test suite.

Service Reference:

Examples:

Calling the deleteTestSuite operation

var params = {
  testSuiteId: 'STRING_VALUE' /* required */
};
apptest.deleteTestSuite(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testSuiteId — (String)

      The test ID of the test suite.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTestCase(params = {}, callback) ⇒ AWS.Request

Gets a test case.

Service Reference:

Examples:

Calling the getTestCase operation

var params = {
  testCaseId: 'STRING_VALUE', /* required */
  testCaseVersion: 'NUMBER_VALUE'
};
apptest.getTestCase(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testCaseId — (String)

      The request test ID of the test case.

    • testCaseVersion — (Integer)

      The test case version of the test case.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testCaseId — (String)

        The response test ID of the test case.

      • testCaseArn — (String)

        The Amazon Resource Name (ARN) of the test case.

      • name — (String)

        The name of the test case.

      • description — (String)

        The description of the test case.

      • latestVersion — (map)

        The latest version of the test case.

        • versionrequired — (Integer)

          The version of the test case latest version.

        • statusrequired — (String)

          The status of the test case latest version.

          Possible values include:
          • "Active"
          • "Deleting"
        • statusReason — (String)

          The status reason of the test case latest version.

      • testCaseVersion — (Integer)

        The case version of the test case.

      • status — (String)

        The status of the test case.

        Possible values include:
        • "Active"
        • "Deleting"
      • statusReason — (String)

        The status reason of the test case.

      • creationTime — (Date)

        The creation time of the test case.

      • lastUpdateTime — (Date)

        The last update time of the test case.

      • steps — (Array<map>)

        The steps of the test case.

        • namerequired — (String)

          The name of the step.

        • description — (String)

          The description of the step.

        • actionrequired — (map)

          The action of the step.

          • resourceAction — (map)

            The resource action of the step action.

            • m2ManagedApplicationAction — (map)

              The AWS Mainframe Modernization managed application action of the resource action.

              • resourcerequired — (String)

                The resource of the AWS Mainframe Modernization managed application action.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization managed application action.

                Possible values include:
                • "Configure"
                • "Deconfigure"
              • properties — (map)

                The properties of the AWS Mainframe Modernization managed application action.

                • forceStop — (Boolean)

                  Force stops the AWS Mainframe Modernization managed action properties.

                • importDataSetLocation — (String)

                  The import data set location of the AWS Mainframe Modernization managed action properties.

            • m2NonManagedApplicationAction — (map)

              The AWS Mainframe Modernization non-managed application action of the resource action.

              • resourcerequired — (String)

                The resource of the AWS Mainframe Modernization non-managed application action.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization non-managed application action.

                Possible values include:
                • "Configure"
                • "Deconfigure"
            • cloudFormationAction — (map)

              The CloudFormation action of the resource action.

              • resourcerequired — (String)

                The resource of the CloudFormation action.

              • actionType — (String)

                The action type of the CloudFormation action.

                Possible values include:
                • "Create"
                • "Delete"
          • mainframeAction — (map)

            The mainframe action of the step action.

            • resourcerequired — (String)

              The resource of the mainframe action.

            • actionTyperequired — (map)

              The action type of the mainframe action.

              • batch — (map)

                The batch of the mainframe action type.

                • batchJobNamerequired — (String)

                  The job name of the batch.

                • batchJobParameters — (map<String>)

                  The batch job parameters of the batch.

                • exportDataSetNames — (Array<String>)

                  The export data set names of the batch.

              • tn3270 — (map)

                The tn3270 port of the mainframe action type.

                • scriptrequired — (map)

                  The script of the TN3270 protocol.

                  • scriptLocationrequired — (String)

                    The script location of the scripts.

                  • typerequired — (String)

                    The type of the scripts.

                    Possible values include:
                    • "Selenium"
                • exportDataSetNames — (Array<String>)

                  The data set names of the TN3270 protocol.

            • properties — (map)

              The properties of the mainframe action.

              • dmsTaskArn — (String)

                The DMS task ARN of the mainframe action properties.

          • compareAction — (map)

            The compare action of the step action.

            • inputrequired — (map)

              The input of the compare action.

              • file — (map)

                The file in the input.

                • sourceLocationrequired — (String)

                  The source location of the input file.

                • targetLocationrequired — (String)

                  The target location of the input file.

                • fileMetadatarequired — (map)

                  The file metadata of the input file.

                  • dataSets — (Array<map>)

                    The data sets of the file metadata.

                    • typerequired — (String)

                      The type of the data set.

                      Possible values include:
                      • "PS"
                    • namerequired — (String)

                      The name of the data set.

                    • ccsidrequired — (String)

                      The CCSID of the data set.

                    • formatrequired — (String)

                      The format of the data set.

                      Possible values include:
                      • "FIXED"
                      • "VARIABLE"
                      • "LINE_SEQUENTIAL"
                    • lengthrequired — (Integer)

                      The length of the data set.

                  • databaseCDC — (map)

                    The database CDC of the file metadata.

                    • sourceMetadatarequired — (map)

                      The source metadata of the database CDC.

                      • typerequired — (String)

                        The type of the source database metadata.

                        Possible values include:
                        • "z/OS-DB2"
                      • captureToolrequired — (String)

                        The capture tool of the source database metadata.

                        Possible values include:
                        • "Precisely"
                        • "AWS DMS"
                    • targetMetadatarequired — (map)

                      The target metadata of the database CDC.

                      • typerequired — (String)

                        The type of the target database metadata.

                        Possible values include:
                        • "PostgreSQL"
                      • captureToolrequired — (String)

                        The capture tool of the target database metadata.

                        Possible values include:
                        • "Precisely"
                        • "AWS DMS"
            • output — (map)

              The output of the compare action.

              • file — (map)

                The file of the output.

                • fileLocation — (String)

                  The file location of the output file.

      • tags — (map<String>)

        The tags of the test case.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTestConfiguration(params = {}, callback) ⇒ AWS.Request

Gets a test configuration.

Service Reference:

Examples:

Calling the getTestConfiguration operation

var params = {
  testConfigurationId: 'STRING_VALUE', /* required */
  testConfigurationVersion: 'NUMBER_VALUE'
};
apptest.getTestConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testConfigurationId — (String)

      The request test configuration ID.

    • testConfigurationVersion — (Integer)

      The test configuration version.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testConfigurationId — (String)

        The response test configuration ID.

      • name — (String)

        The test configuration name

      • testConfigurationArn — (String)

        The test configuration Amazon Resource Name (ARN).

      • latestVersion — (map)

        The latest version of the test configuration.

        • versionrequired — (Integer)

          The version of the test configuration latest version.

        • statusrequired — (String)

          The status of the test configuration latest version.

          Possible values include:
          • "Active"
          • "Deleting"
        • statusReason — (String)

          The status reason of the test configuration latest version.

      • testConfigurationVersion — (Integer)

        The test configuration version.

      • status — (String)

        The status of the test configuration.

        Possible values include:
        • "Active"
        • "Deleting"
      • statusReason — (String)

        The status reason of the test configuration.

      • creationTime — (Date)

        The creation time of the test configuration.

      • lastUpdateTime — (Date)

        The last update time of the test configuration.

      • description — (String)

        The description of the test configuration.

      • resources — (Array<map>)

        The resources of the test configuration.

        • namerequired — (String)

          The name of the resource.

        • typerequired — (map)

          The type of the resource.

          • cloudFormation — (map)

            The CloudFormation template of the resource type.

            • templateLocationrequired — (String)

              The template location of the CloudFormation template.

            • parameters — (map<String>)

              The CloudFormation properties in the CloudFormation template.

          • m2ManagedApplication — (map)

            The AWS Mainframe Modernization managed application of the resource type.

            • applicationIdrequired — (String)

              The application ID of the AWS Mainframe Modernization managed application.

            • runtimerequired — (String)

              The runtime of the AWS Mainframe Modernization managed application.

              Possible values include:
              • "MicroFocus"
            • vpcEndpointServiceName — (String)

              The VPC endpoint service name of the AWS Mainframe Modernization managed application.

            • listenerPort — (String)

              The listener port of the AWS Mainframe Modernization managed application.

          • m2NonManagedApplication — (map)

            The AWS Mainframe Modernization non-managed application of the resource type.

            • vpcEndpointServiceNamerequired — (String)

              The VPC endpoint service name of the AWS Mainframe Modernization non-managed application.

            • listenerPortrequired — (String)

              The listener port of the AWS Mainframe Modernization non-managed application.

            • runtimerequired — (String)

              The runtime of the AWS Mainframe Modernization non-managed application.

              Possible values include:
              • "BluAge"
            • webAppName — (String)

              The web application name of the AWS Mainframe Modernization non-managed application.

      • properties — (map<String>)

        The properties of the test configuration.

      • tags — (map<String>)

        The tags of the test configuration.

      • serviceSettings — (map)

        The service settings of the test configuration.

        • kmsKeyId — (String)

          The KMS key ID of the service settings.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTestRunStep(params = {}, callback) ⇒ AWS.Request

Gets a test run step.

Service Reference:

Examples:

Calling the getTestRunStep operation

var params = {
  stepName: 'STRING_VALUE', /* required */
  testRunId: 'STRING_VALUE', /* required */
  testCaseId: 'STRING_VALUE',
  testSuiteId: 'STRING_VALUE'
};
apptest.getTestRunStep(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testRunId — (String)

      The test run ID of the test run step.

    • stepName — (String)

      The step name of the test run step.

    • testCaseId — (String)

      The test case ID of a test run step.

    • testSuiteId — (String)

      The test suite ID of a test run step.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • stepName — (String)

        The step name of the test run step.

      • testRunId — (String)

        The test run ID of the test run step.

      • testCaseId — (String)

        The test case ID of the test run step.

      • testCaseVersion — (Integer)

        The test case version of the test run step.

      • testSuiteId — (String)

        The test suite ID of the test run step.

      • testSuiteVersion — (Integer)

        The test suite version of the test run step.

      • beforeStep — (Boolean)

        The before steps of the test run step.

      • afterStep — (Boolean)

        The after steps of the test run step.

      • status — (String)

        The status of the test run step.

        Possible values include:
        • "Success"
        • "Failed"
        • "Running"
      • statusReason — (String)

        The status reason of the test run step.

      • runStartTime — (Date)

        The run start time of the test run step.

      • runEndTime — (Date)

        The run end time of the test run step.

      • stepRunSummary — (map)

        The step run summary of the test run step.

        • mainframeAction — (map)

          The mainframe action of the step run summary.

          • batch — (map)

            The batch of the mainframe action summary.

            • stepInputrequired — (map)

              The step input of the batch summary.

              • resourcerequired — (map)

                The resource of the batch step input.

                • m2ManagedApplication — (map)

                  The AWS Mainframe Modernization managed application in the mainframe resource summary.

                  • applicationIdrequired — (String)

                    The application ID of the AWS Mainframe Modernization managed application summary.

                  • runtimerequired — (String)

                    The runtime of the AWS Mainframe Modernization managed application summary.

                    Possible values include:
                    • "MicroFocus"
                  • listenerPort — (Integer)

                    The listener port of the AWS Mainframe Modernization managed application summary.

                • m2NonManagedApplication — (map)

                  The AWS Mainframe Modernization non-managed application in the mainframe resource summary.

                  • vpcEndpointServiceNamerequired — (String)

                    The VPC endpoint service name of the AWS Mainframe Modernization non-managed application summary.

                  • listenerPortrequired — (Integer)

                    The listener port of the AWS Mainframe Modernization non-managed application summary.

                  • runtimerequired — (String)

                    The runtime of the AWS Mainframe Modernization non-managed application summary.

                    Possible values include:
                    • "BluAge"
                  • webAppName — (String)

                    The web application name of the AWS Mainframe Modernization non-managed application summary.

              • batchJobNamerequired — (String)

                The batch job name of the batch step input.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch step input.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch step input.

              • properties — (map)

                The properties of the batch step input.

                • dmsTaskArn — (String)

                  The DMS task ARN of the mainframe action properties.

            • stepOutput — (map)

              The step output of the batch summary.

              • dataSetExportLocation — (String)

                The data set export location of the batch step output.

              • dmsOutputLocation — (String)

                The Database Migration Service (DMS) output location of the batch step output.

              • dataSetDetails — (Array<map>)

                The data set details of the batch step output.

                • typerequired — (String)

                  The type of the data set.

                  Possible values include:
                  • "PS"
                • namerequired — (String)

                  The name of the data set.

                • ccsidrequired — (String)

                  The CCSID of the data set.

                • formatrequired — (String)

                  The format of the data set.

                  Possible values include:
                  • "FIXED"
                  • "VARIABLE"
                  • "LINE_SEQUENTIAL"
                • lengthrequired — (Integer)

                  The length of the data set.

          • tn3270 — (map)

            The tn3270 port of the mainframe action summary.

            • stepInputrequired — (map)

              The step input of the TN3270 summary.

              • resourcerequired — (map)

                The resource of the TN3270 step input.

                • m2ManagedApplication — (map)

                  The AWS Mainframe Modernization managed application in the mainframe resource summary.

                  • applicationIdrequired — (String)

                    The application ID of the AWS Mainframe Modernization managed application summary.

                  • runtimerequired — (String)

                    The runtime of the AWS Mainframe Modernization managed application summary.

                    Possible values include:
                    • "MicroFocus"
                  • listenerPort — (Integer)

                    The listener port of the AWS Mainframe Modernization managed application summary.

                • m2NonManagedApplication — (map)

                  The AWS Mainframe Modernization non-managed application in the mainframe resource summary.

                  • vpcEndpointServiceNamerequired — (String)

                    The VPC endpoint service name of the AWS Mainframe Modernization non-managed application summary.

                  • listenerPortrequired — (Integer)

                    The listener port of the AWS Mainframe Modernization non-managed application summary.

                  • runtimerequired — (String)

                    The runtime of the AWS Mainframe Modernization non-managed application summary.

                    Possible values include:
                    • "BluAge"
                  • webAppName — (String)

                    The web application name of the AWS Mainframe Modernization non-managed application summary.

              • scriptrequired — (map)

                The script of the TN3270 step input.

                • scriptLocationrequired — (String)

                  The script location of the script summary.

                • typerequired — (String)

                  The type of the script summary.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The export data set names of the TN3270 step input.

              • properties — (map)

                The properties of the TN3270 step input.

                • dmsTaskArn — (String)

                  The DMS task ARN of the mainframe action properties.

            • stepOutput — (map)

              The step output of the TN3270 summary.

              • dataSetExportLocation — (String)

                The data set export location of the TN3270 step output.

              • dmsOutputLocation — (String)

                The output location of the TN3270 step output.

              • dataSetDetails — (Array<map>)

                The data set details of the TN3270 step output.

                • typerequired — (String)

                  The type of the data set.

                  Possible values include:
                  • "PS"
                • namerequired — (String)

                  The name of the data set.

                • ccsidrequired — (String)

                  The CCSID of the data set.

                • formatrequired — (String)

                  The format of the data set.

                  Possible values include:
                  • "FIXED"
                  • "VARIABLE"
                  • "LINE_SEQUENTIAL"
                • lengthrequired — (Integer)

                  The length of the data set.

              • scriptOutputLocationrequired — (String)

                The script output location of the TN3270 step output.

        • compareAction — (map)

          The compare action of the step run summary.

          • typerequired — (map)

            The type of the compare action summary.

            • fileType — (map)

              The file type of the file.

              • datasets — (map)

                The data sets in the compare file type.

                • stepInputrequired — (map)

                  The step input of the compare data sets summary.

                  • sourceLocationrequired — (String)

                    The source location of the compare data sets step input location.

                  • targetLocationrequired — (String)

                    The target location of the compare data sets step input location.

                  • sourceDataSetsrequired — (Array<map>)

                    The source data sets of the compare data sets step input location.

                    • typerequired — (String)

                      The type of the data set.

                      Possible values include:
                      • "PS"
                    • namerequired — (String)

                      The name of the data set.

                    • ccsidrequired — (String)

                      The CCSID of the data set.

                    • formatrequired — (String)

                      The format of the data set.

                      Possible values include:
                      • "FIXED"
                      • "VARIABLE"
                      • "LINE_SEQUENTIAL"
                    • lengthrequired — (Integer)

                      The length of the data set.

                  • targetDataSetsrequired — (Array<map>)

                    The target data sets of the compare data sets step input location.

                    • typerequired — (String)

                      The type of the data set.

                      Possible values include:
                      • "PS"
                    • namerequired — (String)

                      The name of the data set.

                    • ccsidrequired — (String)

                      The CCSID of the data set.

                    • formatrequired — (String)

                      The format of the data set.

                      Possible values include:
                      • "FIXED"
                      • "VARIABLE"
                      • "LINE_SEQUENTIAL"
                    • lengthrequired — (Integer)

                      The length of the data set.

                • stepOutput — (map)

                  The step output of the compare data sets summary.

                  • comparisonOutputLocationrequired — (String)

                    The comparison output location of the compare data sets step output.

                  • comparisonStatusrequired — (String)

                    The comparison status of the compare data sets step output.

                    Possible values include:
                    • "Different"
                    • "Equivalent"
                    • "Equal"
              • databaseCDC — (map)

                The database CDC of the compare file type.

                • stepInputrequired — (map)

                  The step input of the compare database CDC summary.

                  • sourceLocationrequired — (String)

                    The source location of the compare database CDC step input.

                  • targetLocationrequired — (String)

                    The target location of the compare database CDC step input.

                  • outputLocation — (String)

                    The output location of the compare database CDC step input.

                  • sourceMetadatarequired — (map)

                    The source metadata of the compare database CDC step input.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata location of the compare database CDC step input.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                • stepOutput — (map)

                  The step output of the compare database CDC summary.

                  • comparisonOutputLocationrequired — (String)

                    The comparison output of the compare database CDC step output.

                  • comparisonStatusrequired — (String)

                    The comparison status of the compare database CDC step output.

                    Possible values include:
                    • "Different"
                    • "Equivalent"
                    • "Equal"
        • resourceAction — (map)

          The resource action of the step run summary.

          • cloudFormation — (map)

            The CloudFormation template of the resource action summary.

            • createCloudformation — (map)

              Creates the CloudFormation summary of the step.

              • stepInputrequired — (map)

                The step input of the CloudFormation summary.

                • templateLocationrequired — (String)

                  The template location of the CloudFormation step input.

                • parameters — (map<String>)

                  The CloudFormation properties of the CloudFormation step input.

              • stepOutput — (map)

                The step output of the CloudFormation summary.

                • stackIdrequired — (String)

                  The stack ID of the CloudFormation step output.

                • exports — (map<String>)

                  The exports of the CloudFormation step output.

            • deleteCloudformation — (map)

              Deletes the CloudFormation summary of the CloudFormation step summary.

              • stepInputrequired — (map)

                The step input of the deleted CloudFormation summary.

                • stackIdrequired — (String)

                  The stack ID of the deleted CloudFormation step input.

              • stepOutput — (map)

                The step output of the deleted CloudFormation summary.

          • m2ManagedApplication — (map)

            The AWS Mainframe Modernization managed application of the resource action summary.

            • stepInputrequired — (map)

              The step input of the AWS Mainframe Modernization managed application step summary.

              • applicationIdrequired — (String)

                The application ID of the AWS Mainframe Modernization managed application step input.

              • runtimerequired — (String)

                The runtime of the AWS Mainframe Modernization managed application step input.

              • vpcEndpointServiceName — (String)

                The VPC endpoint service name of the AWS Mainframe Modernization managed application step input.

              • listenerPort — (Integer)

                The listener port of the AWS Mainframe Modernization managed application step input.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization managed application step input.

                Possible values include:
                • "Configure"
                • "Deconfigure"
              • properties — (map)

                The properties of the AWS Mainframe Modernization managed application step input.

                • forceStop — (Boolean)

                  Force stops the AWS Mainframe Modernization managed action properties.

                • importDataSetLocation — (String)

                  The import data set location of the AWS Mainframe Modernization managed action properties.

            • stepOutput — (map)

              The step output of the AWS Mainframe Modernization managed application step summary.

              • importDataSetSummary — (map<String>)

                The import data set summary of the AWS Mainframe Modernization managed application step output.

          • m2NonManagedApplication — (map)

            The AWS Mainframe Modernization non-managed application of the resource action summary.

            • stepInputrequired — (map)

              The step input of the AWS Mainframe Modernization non-managed application step summary.

              • vpcEndpointServiceNamerequired — (String)

                The VPC endpoint service name of the AWS Mainframe Modernization non-managed application step input.

              • listenerPortrequired — (Integer)

                The listener port of the AWS Mainframe Modernization non-managed application step input.

              • runtimerequired — (String)

                The runtime of the AWS Mainframe Modernization non-managed application step input.

                Possible values include:
                • "BluAge"
              • webAppName — (String)

                The web app name of the AWS Mainframe Modernization non-managed application step input.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization non-managed application step input.

                Possible values include:
                • "Configure"
                • "Deconfigure"
            • stepOutput — (map)

              The step output of the AWS Mainframe Modernization non-managed application step summary.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTestSuite(params = {}, callback) ⇒ AWS.Request

Gets a test suite.

Service Reference:

Examples:

Calling the getTestSuite operation

var params = {
  testSuiteId: 'STRING_VALUE', /* required */
  testSuiteVersion: 'NUMBER_VALUE'
};
apptest.getTestSuite(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testSuiteId — (String)

      The ID of the test suite.

    • testSuiteVersion — (Integer)

      The version of the test suite.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testSuiteId — (String)

        The response ID of the test suite.

      • name — (String)

        The name of the test suite.

      • latestVersion — (map)

        The latest version of the test suite.

        • versionrequired — (Integer)

          The version of the test suite latest version.

        • statusrequired — (String)

          The status of the test suite latest version.

          Possible values include:
          • "Creating"
          • "Updating"
          • "Active"
          • "Failed"
          • "Deleting"
        • statusReason — (String)

          The status reason of the test suite latest version.

      • testSuiteVersion — (Integer)

        The version of the test suite.

      • status — (String)

        The status of the test suite.

        Possible values include:
        • "Creating"
        • "Updating"
        • "Active"
        • "Failed"
        • "Deleting"
      • statusReason — (String)

        The status reason of the test suite.

      • testSuiteArn — (String)

        The test suite Amazon Resource Name (ARN).

      • creationTime — (Date)

        The creation time of the test suite.

      • lastUpdateTime — (Date)

        The last update time of the test suite.

      • description — (String)

        The description of the test suite.

      • beforeSteps — (Array<map>)

        The before steps of the test suite.

        • namerequired — (String)

          The name of the step.

        • description — (String)

          The description of the step.

        • actionrequired — (map)

          The action of the step.

          • resourceAction — (map)

            The resource action of the step action.

            • m2ManagedApplicationAction — (map)

              The AWS Mainframe Modernization managed application action of the resource action.

              • resourcerequired — (String)

                The resource of the AWS Mainframe Modernization managed application action.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization managed application action.

                Possible values include:
                • "Configure"
                • "Deconfigure"
              • properties — (map)

                The properties of the AWS Mainframe Modernization managed application action.

                • forceStop — (Boolean)

                  Force stops the AWS Mainframe Modernization managed action properties.

                • importDataSetLocation — (String)

                  The import data set location of the AWS Mainframe Modernization managed action properties.

            • m2NonManagedApplicationAction — (map)

              The AWS Mainframe Modernization non-managed application action of the resource action.

              • resourcerequired — (String)

                The resource of the AWS Mainframe Modernization non-managed application action.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization non-managed application action.

                Possible values include:
                • "Configure"
                • "Deconfigure"
            • cloudFormationAction — (map)

              The CloudFormation action of the resource action.

              • resourcerequired — (String)

                The resource of the CloudFormation action.

              • actionType — (String)

                The action type of the CloudFormation action.

                Possible values include:
                • "Create"
                • "Delete"
          • mainframeAction — (map)

            The mainframe action of the step action.

            • resourcerequired — (String)

              The resource of the mainframe action.

            • actionTyperequired — (map)

              The action type of the mainframe action.

              • batch — (map)

                The batch of the mainframe action type.

                • batchJobNamerequired — (String)

                  The job name of the batch.

                • batchJobParameters — (map<String>)

                  The batch job parameters of the batch.

                • exportDataSetNames — (Array<String>)

                  The export data set names of the batch.

              • tn3270 — (map)

                The tn3270 port of the mainframe action type.

                • scriptrequired — (map)

                  The script of the TN3270 protocol.

                  • scriptLocationrequired — (String)

                    The script location of the scripts.

                  • typerequired — (String)

                    The type of the scripts.

                    Possible values include:
                    • "Selenium"
                • exportDataSetNames — (Array<String>)

                  The data set names of the TN3270 protocol.

            • properties — (map)

              The properties of the mainframe action.

              • dmsTaskArn — (String)

                The DMS task ARN of the mainframe action properties.

          • compareAction — (map)

            The compare action of the step action.

            • inputrequired — (map)

              The input of the compare action.

              • file — (map)

                The file in the input.

                • sourceLocationrequired — (String)

                  The source location of the input file.

                • targetLocationrequired — (String)

                  The target location of the input file.

                • fileMetadatarequired — (map)

                  The file metadata of the input file.

                  • dataSets — (Array<map>)

                    The data sets of the file metadata.

                    • typerequired — (String)

                      The type of the data set.

                      Possible values include:
                      • "PS"
                    • namerequired — (String)

                      The name of the data set.

                    • ccsidrequired — (String)

                      The CCSID of the data set.

                    • formatrequired — (String)

                      The format of the data set.

                      Possible values include:
                      • "FIXED"
                      • "VARIABLE"
                      • "LINE_SEQUENTIAL"
                    • lengthrequired — (Integer)

                      The length of the data set.

                  • databaseCDC — (map)

                    The database CDC of the file metadata.

                    • sourceMetadatarequired — (map)

                      The source metadata of the database CDC.

                      • typerequired — (String)

                        The type of the source database metadata.

                        Possible values include:
                        • "z/OS-DB2"
                      • captureToolrequired — (String)

                        The capture tool of the source database metadata.

                        Possible values include:
                        • "Precisely"
                        • "AWS DMS"
                    • targetMetadatarequired — (map)

                      The target metadata of the database CDC.

                      • typerequired — (String)

                        The type of the target database metadata.

                        Possible values include:
                        • "PostgreSQL"
                      • captureToolrequired — (String)

                        The capture tool of the target database metadata.

                        Possible values include:
                        • "Precisely"
                        • "AWS DMS"
            • output — (map)

              The output of the compare action.

              • file — (map)

                The file of the output.

                • fileLocation — (String)

                  The file location of the output file.

      • afterSteps — (Array<map>)

        The after steps of the test suite.

        • namerequired — (String)

          The name of the step.

        • description — (String)

          The description of the step.

        • actionrequired — (map)

          The action of the step.

          • resourceAction — (map)

            The resource action of the step action.

            • m2ManagedApplicationAction — (map)

              The AWS Mainframe Modernization managed application action of the resource action.

              • resourcerequired — (String)

                The resource of the AWS Mainframe Modernization managed application action.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization managed application action.

                Possible values include:
                • "Configure"
                • "Deconfigure"
              • properties — (map)

                The properties of the AWS Mainframe Modernization managed application action.

                • forceStop — (Boolean)

                  Force stops the AWS Mainframe Modernization managed action properties.

                • importDataSetLocation — (String)

                  The import data set location of the AWS Mainframe Modernization managed action properties.

            • m2NonManagedApplicationAction — (map)

              The AWS Mainframe Modernization non-managed application action of the resource action.

              • resourcerequired — (String)

                The resource of the AWS Mainframe Modernization non-managed application action.

              • actionTyperequired — (String)

                The action type of the AWS Mainframe Modernization non-managed application action.

                Possible values include:
                • "Configure"
                • "Deconfigure"
            • cloudFormationAction — (map)

              The CloudFormation action of the resource action.

              • resourcerequired — (String)

                The resource of the CloudFormation action.

              • actionType — (String)

                The action type of the CloudFormation action.

                Possible values include:
                • "Create"
                • "Delete"
          • mainframeAction — (map)

            The mainframe action of the step action.

            • resourcerequired — (String)

              The resource of the mainframe action.

            • actionTyperequired — (map)

              The action type of the mainframe action.

              • batch — (map)

                The batch of the mainframe action type.

                • batchJobNamerequired — (String)

                  The job name of the batch.

                • batchJobParameters — (map<String>)

                  The batch job parameters of the batch.

                • exportDataSetNames — (Array<String>)

                  The export data set names of the batch.

              • tn3270 — (map)

                The tn3270 port of the mainframe action type.

                • scriptrequired — (map)

                  The script of the TN3270 protocol.

                  • scriptLocationrequired — (String)

                    The script location of the scripts.

                  • typerequired — (String)

                    The type of the scripts.

                    Possible values include:
                    • "Selenium"
                • exportDataSetNames — (Array<String>)

                  The data set names of the TN3270 protocol.

            • properties — (map)

              The properties of the mainframe action.

              • dmsTaskArn — (String)

                The DMS task ARN of the mainframe action properties.

          • compareAction — (map)

            The compare action of the step action.

            • inputrequired — (map)

              The input of the compare action.

              • file — (map)

                The file in the input.

                • sourceLocationrequired — (String)

                  The source location of the input file.

                • targetLocationrequired — (String)

                  The target location of the input file.

                • fileMetadatarequired — (map)

                  The file metadata of the input file.

                  • dataSets — (Array<map>)

                    The data sets of the file metadata.

                    • typerequired — (String)

                      The type of the data set.

                      Possible values include:
                      • "PS"
                    • namerequired — (String)

                      The name of the data set.

                    • ccsidrequired — (String)

                      The CCSID of the data set.

                    • formatrequired — (String)

                      The format of the data set.

                      Possible values include:
                      • "FIXED"
                      • "VARIABLE"
                      • "LINE_SEQUENTIAL"
                    • lengthrequired — (Integer)

                      The length of the data set.

                  • databaseCDC — (map)

                    The database CDC of the file metadata.

                    • sourceMetadatarequired — (map)

                      The source metadata of the database CDC.

                      • typerequired — (String)

                        The type of the source database metadata.

                        Possible values include:
                        • "z/OS-DB2"
                      • captureToolrequired — (String)

                        The capture tool of the source database metadata.

                        Possible values include:
                        • "Precisely"
                        • "AWS DMS"
                    • targetMetadatarequired — (map)

                      The target metadata of the database CDC.

                      • typerequired — (String)

                        The type of the target database metadata.

                        Possible values include:
                        • "PostgreSQL"
                      • captureToolrequired — (String)

                        The capture tool of the target database metadata.

                        Possible values include:
                        • "Precisely"
                        • "AWS DMS"
            • output — (map)

              The output of the compare action.

              • file — (map)

                The file of the output.

                • fileLocation — (String)

                  The file location of the output file.

      • testCases — (map)

        The test cases of the test suite.

        • sequential — (Array<String>)

          The sequential of the test case.

      • tags — (map<String>)

        The tags of the test suite.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTagsForResource(params = {}, callback) ⇒ AWS.Request

Lists tags for a resource.

Service Reference:

Examples:

Calling the listTagsForResource operation

var params = {
  resourceArn: 'STRING_VALUE' /* required */
};
apptest.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • resourceArn — (String)

      The Amazon Resource Name (ARN) of the resource.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • tags — (map<String>)

        The tags of the resource.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestCases(params = {}, callback) ⇒ AWS.Request

Lists test cases.

Service Reference:

Examples:

Calling the listTestCases operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  testCaseIds: [
    'STRING_VALUE',
    /* more items */
  ]
};
apptest.listTestCases(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testCaseIds — (Array<String>)

      The IDs of the test cases.

    • nextToken — (String)

      The next token of the test cases.

    • maxResults — (Integer)

      The maximum results of the test case.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testCases — (Array<map>)

        The test cases in an application.

        • testCaseIdrequired — (String)

          The test case ID of the test case summary.

        • testCaseArnrequired — (String)

          The test case Amazon Resource Name (ARN) of the test case summary.

        • namerequired — (String)

          The name of the test case summary.

        • statusReason — (String)

          The status reason of the test case summary.

        • latestVersionrequired — (Integer)

          The latest version of the test case summary.

        • statusrequired — (String)

          The status of the test case summary.

          Possible values include:
          • "Active"
          • "Deleting"
        • creationTimerequired — (Date)

          The creation time of the test case summary.

        • lastUpdateTimerequired — (Date)

          The last update time of the test case summary.

      • nextToken — (String)

        The next token in test cases.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestConfigurations(params = {}, callback) ⇒ AWS.Request

Lists test configurations.

Service Reference:

Examples:

Calling the listTestConfigurations operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  testConfigurationIds: [
    'STRING_VALUE',
    /* more items */
  ]
};
apptest.listTestConfigurations(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testConfigurationIds — (Array<String>)

      The configuration IDs of the test configurations.

    • nextToken — (String)

      The next token for the test configurations.

    • maxResults — (Integer)

      The maximum results of the test configuration.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testConfigurations — (Array<map>)

        The test configurations.

        • testConfigurationIdrequired — (String)

          The test configuration ID of the test configuration summary.

        • namerequired — (String)

          The name of the test configuration summary.

        • statusReason — (String)

          The status reason of the test configuration summary.

        • latestVersionrequired — (Integer)

          The latest version of the test configuration summary.

        • testConfigurationArnrequired — (String)

          The test configuration ARN of the test configuration summary.

        • statusrequired — (String)

          The status of the test configuration summary.

          Possible values include:
          • "Active"
          • "Deleting"
        • creationTimerequired — (Date)

          The creation time of the test configuration summary.

        • lastUpdateTimerequired — (Date)

          The last update time of the test configuration summary.

      • nextToken — (String)

        The next token in the test configurations.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestRuns(params = {}, callback) ⇒ AWS.Request

Lists test runs.

Service Reference:

Examples:

Calling the listTestRuns operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  testRunIds: [
    'STRING_VALUE',
    /* more items */
  ],
  testSuiteId: 'STRING_VALUE'
};
apptest.listTestRuns(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testSuiteId — (String)

      The test suite ID of the test runs.

    • testRunIds — (Array<String>)

      The test run IDs of the test runs.

    • nextToken — (String)

      The token from the previous request to retrieve the next page of test run results.

    • maxResults — (Integer)

      The maximum number of test runs to return in one page of results.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testRuns — (Array<map>)

        The test runs of the response query.

        • testRunIdrequired — (String)

          The test run ID of the test run summary.

        • testRunArnrequired — (String)

          The test run ARN of the test run summary.

        • testSuiteIdrequired — (String)

          The test suite ID of the test run summary.

        • testSuiteVersionrequired — (Integer)

          The test suite version of the test run summary.

        • testConfigurationId — (String)

          The test configuration ID of the test run summary.

        • testConfigurationVersion — (Integer)

          The test configuration version of the test run summary.

        • statusrequired — (String)

          The status of the test run summary.

          Possible values include:
          • "Success"
          • "Running"
          • "Failed"
          • "Deleting"
        • statusReason — (String)

          The status reason of the test run summary.

        • runStartTimerequired — (Date)

          The run start time of the test run summary.

        • runEndTime — (Date)

          The run end time of the test run summary.

      • nextToken — (String)

        The token from the previous request to retrieve the next page of results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestRunSteps(params = {}, callback) ⇒ AWS.Request

Lists test run steps.

Service Reference:

Examples:

Calling the listTestRunSteps operation

var params = {
  testRunId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  testCaseId: 'STRING_VALUE',
  testSuiteId: 'STRING_VALUE'
};
apptest.listTestRunSteps(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testRunId — (String)

      The test run ID of the test run steps.

    • testCaseId — (String)

      The test case ID of the test run steps.

    • testSuiteId — (String)

      The test suite ID of the test run steps.

    • nextToken — (String)

      The token from a previous step to retrieve the next page of results.

    • maxResults — (Integer)

      The maximum number of test run steps to return in one page of results.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testRunSteps — (Array<map>)

        The test run steps of the response query.

        • stepNamerequired — (String)

          The step name of the test run step summary.

        • testRunIdrequired — (String)

          The test run ID of the test run step summary.

        • testCaseId — (String)

          The test case ID of the test run step summary.

        • testCaseVersion — (Integer)

          The test case version of the test run step summary.

        • testSuiteId — (String)

          The test suite ID of the test run step summary.

        • testSuiteVersion — (Integer)

          The test suite version of the test run step summary.

        • beforeStep — (Boolean)

          The before step of the test run step summary.

        • afterStep — (Boolean)

          The after step of the test run step summary.

        • statusrequired — (String)

          The status of the test run step summary.

          Possible values include:
          • "Success"
          • "Failed"
          • "Running"
        • statusReason — (String)

          The status reason of the test run step summary.

        • runStartTimerequired — (Date)

          The run start time of the test run step summary.

        • runEndTime — (Date)

          The run end time of the test run step summary.

      • nextToken — (String)

        The token from a previous request to retrieve the next page of results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestRunTestCases(params = {}, callback) ⇒ AWS.Request

Lists test run test cases.

Service Reference:

Examples:

Calling the listTestRunTestCases operation

var params = {
  testRunId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
apptest.listTestRunTestCases(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testRunId — (String)

      The test run ID of the test cases.

    • nextToken — (String)

      The token from a previous request to retrieve the next page of results.

    • maxResults — (Integer)

      The maximum number of test run test cases to return in one page of results.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testRunTestCases — (Array<map>)

        The test run of the test cases.

        • testCaseIdrequired — (String)

          The test case id of the test case run summary.

        • testCaseVersionrequired — (Integer)

          The test case version of the test case run summary.

        • testRunIdrequired — (String)

          The test run id of the test case run summary.

        • statusrequired — (String)

          The status of the test case run summary.

          Possible values include:
          • "Success"
          • "Running"
          • "Failed"
        • statusReason — (String)

          The status reason of the test case run summary.

        • runStartTimerequired — (Date)

          The run start time of the test case run summary.

        • runEndTime — (Date)

          The run end time of the test case run summary.

      • nextToken — (String)

        The token from a previous request to retrieve the next page of results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTestSuites(params = {}, callback) ⇒ AWS.Request

Lists test suites.

Service Reference:

Examples:

Calling the listTestSuites operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  testSuiteIds: [
    'STRING_VALUE',
    /* more items */
  ]
};
apptest.listTestSuites(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testSuiteIds — (Array<String>)

      The suite ID of the test suites.

    • nextToken — (String)

      The token from a previous request to retrieve the next page of results.

    • maxResults — (Integer)

      The maximum number of test suites to return in one page of results.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testSuites — (Array<map>)

        The test suites returned with the response query.

        • testSuiteIdrequired — (String)

          The test suite ID of the test suite summary.

        • namerequired — (String)

          The name of the test suite summary.

        • statusReason — (String)

          The status reason of the test suite summary.

        • latestVersionrequired — (Integer)

          The latest version of the test suite summary.

        • testSuiteArnrequired — (String)

          The test suite Amazon Resource Name (ARN) of the test suite summary.

        • statusrequired — (String)

          The status of the test suite summary.

          Possible values include:
          • "Creating"
          • "Updating"
          • "Active"
          • "Failed"
          • "Deleting"
        • creationTimerequired — (Date)

          The creation time of the test suite summary.

        • lastUpdateTimerequired — (Date)

          The last update time of the test suite summary.

      • nextToken — (String)

        The token from a previous request to retrieve the next page of test suites results.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

startTestRun(params = {}, callback) ⇒ AWS.Request

Starts a test run.

Service Reference:

Examples:

Calling the startTestRun operation

var params = {
  testSuiteId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  },
  testConfigurationId: 'STRING_VALUE'
};
apptest.startTestRun(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testSuiteId — (String)

      The test suite ID of the test run.

    • testConfigurationId — (String)

      The configuration ID of the test run.

    • clientToken — (String)

      The client token of the test run.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (map<String>)

      The tags of the test run.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testRunId — (String)

        The test run ID of the test run.

      • testRunStatus — (String)

        The test run status of the test run.

        Possible values include:
        • "Success"
        • "Running"
        • "Failed"
        • "Deleting"

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

tagResource(params = {}, callback) ⇒ AWS.Request

Specifies tags of a resource.

Service Reference:

Examples:

Calling the tagResource operation

var params = {
  resourceArn: 'STRING_VALUE', /* required */
  tags: { /* required */
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
apptest.tagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • resourceArn — (String)

      The Amazon Resource Name (ARN) of the tag resource.

    • tags — (map<String>)

      The tags of the resource.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

untagResource(params = {}, callback) ⇒ AWS.Request

Untags a resource.

Service Reference:

Examples:

Calling the untagResource operation

var params = {
  resourceArn: 'STRING_VALUE', /* required */
  tagKeys: [ /* required */
    'STRING_VALUE',
    /* more items */
  ]
};
apptest.untagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • resourceArn — (String)

      The Amazon Resource Name (ARN) of the resource.

    • tagKeys — (Array<String>)

      The tag keys of the resource.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateTestCase(params = {}, callback) ⇒ AWS.Request

Updates a test case.

Service Reference:

Examples:

Calling the updateTestCase operation

var params = {
  testCaseId: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  steps: [
    {
      action: { /* required */
        compareAction: {
          input: { /* required */
            file: {
              fileMetadata: { /* required */
                dataSets: [
                  {
                    ccsid: 'STRING_VALUE', /* required */
                    format: FIXED | VARIABLE | LINE_SEQUENTIAL, /* required */
                    length: 'NUMBER_VALUE', /* required */
                    name: 'STRING_VALUE', /* required */
                    type: PS /* required */
                  },
                  /* more items */
                ],
                databaseCDC: {
                  sourceMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: z/OS-DB2 /* required */
                  },
                  targetMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: PostgreSQL /* required */
                  }
                }
              },
              sourceLocation: 'STRING_VALUE', /* required */
              targetLocation: 'STRING_VALUE' /* required */
            }
          },
          output: {
            file: {
              fileLocation: 'STRING_VALUE'
            }
          }
        },
        mainframeAction: {
          actionType: { /* required */
            batch: {
              batchJobName: 'STRING_VALUE', /* required */
              batchJobParameters: {
                '<String>': 'STRING_VALUE',
                /* '<String>': ... */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            },
            tn3270: {
              script: { /* required */
                scriptLocation: 'STRING_VALUE', /* required */
                type: Selenium /* required */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            }
          },
          resource: 'STRING_VALUE', /* required */
          properties: {
            dmsTaskArn: 'STRING_VALUE'
          }
        },
        resourceAction: {
          cloudFormationAction: {
            resource: 'STRING_VALUE', /* required */
            actionType: Create | Delete
          },
          m2ManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE', /* required */
            properties: {
              forceStop: true || false,
              importDataSetLocation: 'STRING_VALUE'
            }
          },
          m2NonManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE' /* required */
          }
        }
      },
      name: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE'
    },
    /* more items */
  ]
};
apptest.updateTestCase(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testCaseId — (String)

      The test case ID of the test case.

    • description — (String)

      The description of the test case.

    • steps — (Array<map>)

      The steps of the test case.

      • namerequired — (String)

        The name of the step.

      • description — (String)

        The description of the step.

      • actionrequired — (map)

        The action of the step.

        • resourceAction — (map)

          The resource action of the step action.

          • m2ManagedApplicationAction — (map)

            The AWS Mainframe Modernization managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
            • properties — (map)

              The properties of the AWS Mainframe Modernization managed application action.

              • forceStop — (Boolean)

                Force stops the AWS Mainframe Modernization managed action properties.

              • importDataSetLocation — (String)

                The import data set location of the AWS Mainframe Modernization managed action properties.

          • m2NonManagedApplicationAction — (map)

            The AWS Mainframe Modernization non-managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization non-managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization non-managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
          • cloudFormationAction — (map)

            The CloudFormation action of the resource action.

            • resourcerequired — (String)

              The resource of the CloudFormation action.

            • actionType — (String)

              The action type of the CloudFormation action.

              Possible values include:
              • "Create"
              • "Delete"
        • mainframeAction — (map)

          The mainframe action of the step action.

          • resourcerequired — (String)

            The resource of the mainframe action.

          • actionTyperequired — (map)

            The action type of the mainframe action.

            • batch — (map)

              The batch of the mainframe action type.

              • batchJobNamerequired — (String)

                The job name of the batch.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch.

            • tn3270 — (map)

              The tn3270 port of the mainframe action type.

              • scriptrequired — (map)

                The script of the TN3270 protocol.

                • scriptLocationrequired — (String)

                  The script location of the scripts.

                • typerequired — (String)

                  The type of the scripts.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The data set names of the TN3270 protocol.

          • properties — (map)

            The properties of the mainframe action.

            • dmsTaskArn — (String)

              The DMS task ARN of the mainframe action properties.

        • compareAction — (map)

          The compare action of the step action.

          • inputrequired — (map)

            The input of the compare action.

            • file — (map)

              The file in the input.

              • sourceLocationrequired — (String)

                The source location of the input file.

              • targetLocationrequired — (String)

                The target location of the input file.

              • fileMetadatarequired — (map)

                The file metadata of the input file.

                • dataSets — (Array<map>)

                  The data sets of the file metadata.

                  • typerequired — (String)

                    The type of the data set.

                    Possible values include:
                    • "PS"
                  • namerequired — (String)

                    The name of the data set.

                  • ccsidrequired — (String)

                    The CCSID of the data set.

                  • formatrequired — (String)

                    The format of the data set.

                    Possible values include:
                    • "FIXED"
                    • "VARIABLE"
                    • "LINE_SEQUENTIAL"
                  • lengthrequired — (Integer)

                    The length of the data set.

                • databaseCDC — (map)

                  The database CDC of the file metadata.

                  • sourceMetadatarequired — (map)

                    The source metadata of the database CDC.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata of the database CDC.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
          • output — (map)

            The output of the compare action.

            • file — (map)

              The file of the output.

              • fileLocation — (String)

                The file location of the output file.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testCaseId — (String)

        The test case ID of the test case.

      • testCaseVersion — (Integer)

        The test case version of the test case.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateTestConfiguration(params = {}, callback) ⇒ AWS.Request

Updates a test configuration.

Service Reference:

Examples:

Calling the updateTestConfiguration operation

var params = {
  testConfigurationId: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  properties: {
    '<String>': 'STRING_VALUE',
    /* '<String>': ... */
  },
  resources: [
    {
      name: 'STRING_VALUE', /* required */
      type: { /* required */
        cloudFormation: {
          templateLocation: 'STRING_VALUE', /* required */
          parameters: {
            '<String>': 'STRING_VALUE',
            /* '<String>': ... */
          }
        },
        m2ManagedApplication: {
          applicationId: 'STRING_VALUE', /* required */
          runtime: MicroFocus, /* required */
          listenerPort: 'STRING_VALUE',
          vpcEndpointServiceName: 'STRING_VALUE'
        },
        m2NonManagedApplication: {
          listenerPort: 'STRING_VALUE', /* required */
          runtime: BluAge, /* required */
          vpcEndpointServiceName: 'STRING_VALUE', /* required */
          webAppName: 'STRING_VALUE'
        }
      }
    },
    /* more items */
  ],
  serviceSettings: {
    kmsKeyId: 'STRING_VALUE'
  }
};
apptest.updateTestConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testConfigurationId — (String)

      The test configuration ID of the test configuration.

    • description — (String)

      The description of the test configuration.

    • resources — (Array<map>)

      The resources of the test configuration.

      • namerequired — (String)

        The name of the resource.

      • typerequired — (map)

        The type of the resource.

        • cloudFormation — (map)

          The CloudFormation template of the resource type.

          • templateLocationrequired — (String)

            The template location of the CloudFormation template.

          • parameters — (map<String>)

            The CloudFormation properties in the CloudFormation template.

        • m2ManagedApplication — (map)

          The AWS Mainframe Modernization managed application of the resource type.

          • applicationIdrequired — (String)

            The application ID of the AWS Mainframe Modernization managed application.

          • runtimerequired — (String)

            The runtime of the AWS Mainframe Modernization managed application.

            Possible values include:
            • "MicroFocus"
          • vpcEndpointServiceName — (String)

            The VPC endpoint service name of the AWS Mainframe Modernization managed application.

          • listenerPort — (String)

            The listener port of the AWS Mainframe Modernization managed application.

        • m2NonManagedApplication — (map)

          The AWS Mainframe Modernization non-managed application of the resource type.

          • vpcEndpointServiceNamerequired — (String)

            The VPC endpoint service name of the AWS Mainframe Modernization non-managed application.

          • listenerPortrequired — (String)

            The listener port of the AWS Mainframe Modernization non-managed application.

          • runtimerequired — (String)

            The runtime of the AWS Mainframe Modernization non-managed application.

            Possible values include:
            • "BluAge"
          • webAppName — (String)

            The web application name of the AWS Mainframe Modernization non-managed application.

    • properties — (map<String>)

      The properties of the test configuration.

    • serviceSettings — (map)

      The service settings of the test configuration.

      • kmsKeyId — (String)

        The KMS key ID of the service settings.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testConfigurationId — (String)

        The configuration ID of the test configuration.

      • testConfigurationVersion — (Integer)

        The configuration version of the test configuration.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateTestSuite(params = {}, callback) ⇒ AWS.Request

Updates a test suite.

Service Reference:

Examples:

Calling the updateTestSuite operation

var params = {
  testSuiteId: 'STRING_VALUE', /* required */
  afterSteps: [
    {
      action: { /* required */
        compareAction: {
          input: { /* required */
            file: {
              fileMetadata: { /* required */
                dataSets: [
                  {
                    ccsid: 'STRING_VALUE', /* required */
                    format: FIXED | VARIABLE | LINE_SEQUENTIAL, /* required */
                    length: 'NUMBER_VALUE', /* required */
                    name: 'STRING_VALUE', /* required */
                    type: PS /* required */
                  },
                  /* more items */
                ],
                databaseCDC: {
                  sourceMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: z/OS-DB2 /* required */
                  },
                  targetMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: PostgreSQL /* required */
                  }
                }
              },
              sourceLocation: 'STRING_VALUE', /* required */
              targetLocation: 'STRING_VALUE' /* required */
            }
          },
          output: {
            file: {
              fileLocation: 'STRING_VALUE'
            }
          }
        },
        mainframeAction: {
          actionType: { /* required */
            batch: {
              batchJobName: 'STRING_VALUE', /* required */
              batchJobParameters: {
                '<String>': 'STRING_VALUE',
                /* '<String>': ... */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            },
            tn3270: {
              script: { /* required */
                scriptLocation: 'STRING_VALUE', /* required */
                type: Selenium /* required */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            }
          },
          resource: 'STRING_VALUE', /* required */
          properties: {
            dmsTaskArn: 'STRING_VALUE'
          }
        },
        resourceAction: {
          cloudFormationAction: {
            resource: 'STRING_VALUE', /* required */
            actionType: Create | Delete
          },
          m2ManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE', /* required */
            properties: {
              forceStop: true || false,
              importDataSetLocation: 'STRING_VALUE'
            }
          },
          m2NonManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE' /* required */
          }
        }
      },
      name: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE'
    },
    /* more items */
  ],
  beforeSteps: [
    {
      action: { /* required */
        compareAction: {
          input: { /* required */
            file: {
              fileMetadata: { /* required */
                dataSets: [
                  {
                    ccsid: 'STRING_VALUE', /* required */
                    format: FIXED | VARIABLE | LINE_SEQUENTIAL, /* required */
                    length: 'NUMBER_VALUE', /* required */
                    name: 'STRING_VALUE', /* required */
                    type: PS /* required */
                  },
                  /* more items */
                ],
                databaseCDC: {
                  sourceMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: z/OS-DB2 /* required */
                  },
                  targetMetadata: { /* required */
                    captureTool: Precisely | AWS DMS, /* required */
                    type: PostgreSQL /* required */
                  }
                }
              },
              sourceLocation: 'STRING_VALUE', /* required */
              targetLocation: 'STRING_VALUE' /* required */
            }
          },
          output: {
            file: {
              fileLocation: 'STRING_VALUE'
            }
          }
        },
        mainframeAction: {
          actionType: { /* required */
            batch: {
              batchJobName: 'STRING_VALUE', /* required */
              batchJobParameters: {
                '<String>': 'STRING_VALUE',
                /* '<String>': ... */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            },
            tn3270: {
              script: { /* required */
                scriptLocation: 'STRING_VALUE', /* required */
                type: Selenium /* required */
              },
              exportDataSetNames: [
                'STRING_VALUE',
                /* more items */
              ]
            }
          },
          resource: 'STRING_VALUE', /* required */
          properties: {
            dmsTaskArn: 'STRING_VALUE'
          }
        },
        resourceAction: {
          cloudFormationAction: {
            resource: 'STRING_VALUE', /* required */
            actionType: Create | Delete
          },
          m2ManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE', /* required */
            properties: {
              forceStop: true || false,
              importDataSetLocation: 'STRING_VALUE'
            }
          },
          m2NonManagedApplicationAction: {
            actionType: Configure | Deconfigure, /* required */
            resource: 'STRING_VALUE' /* required */
          }
        }
      },
      name: 'STRING_VALUE', /* required */
      description: 'STRING_VALUE'
    },
    /* more items */
  ],
  description: 'STRING_VALUE',
  testCases: {
    sequential: [
      'STRING_VALUE',
      /* more items */
    ]
  }
};
apptest.updateTestSuite(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • testSuiteId — (String)

      The test suite ID of the test suite.

    • description — (String)

      The description of the test suite.

    • beforeSteps — (Array<map>)

      The before steps for the test suite.

      • namerequired — (String)

        The name of the step.

      • description — (String)

        The description of the step.

      • actionrequired — (map)

        The action of the step.

        • resourceAction — (map)

          The resource action of the step action.

          • m2ManagedApplicationAction — (map)

            The AWS Mainframe Modernization managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
            • properties — (map)

              The properties of the AWS Mainframe Modernization managed application action.

              • forceStop — (Boolean)

                Force stops the AWS Mainframe Modernization managed action properties.

              • importDataSetLocation — (String)

                The import data set location of the AWS Mainframe Modernization managed action properties.

          • m2NonManagedApplicationAction — (map)

            The AWS Mainframe Modernization non-managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization non-managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization non-managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
          • cloudFormationAction — (map)

            The CloudFormation action of the resource action.

            • resourcerequired — (String)

              The resource of the CloudFormation action.

            • actionType — (String)

              The action type of the CloudFormation action.

              Possible values include:
              • "Create"
              • "Delete"
        • mainframeAction — (map)

          The mainframe action of the step action.

          • resourcerequired — (String)

            The resource of the mainframe action.

          • actionTyperequired — (map)

            The action type of the mainframe action.

            • batch — (map)

              The batch of the mainframe action type.

              • batchJobNamerequired — (String)

                The job name of the batch.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch.

            • tn3270 — (map)

              The tn3270 port of the mainframe action type.

              • scriptrequired — (map)

                The script of the TN3270 protocol.

                • scriptLocationrequired — (String)

                  The script location of the scripts.

                • typerequired — (String)

                  The type of the scripts.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The data set names of the TN3270 protocol.

          • properties — (map)

            The properties of the mainframe action.

            • dmsTaskArn — (String)

              The DMS task ARN of the mainframe action properties.

        • compareAction — (map)

          The compare action of the step action.

          • inputrequired — (map)

            The input of the compare action.

            • file — (map)

              The file in the input.

              • sourceLocationrequired — (String)

                The source location of the input file.

              • targetLocationrequired — (String)

                The target location of the input file.

              • fileMetadatarequired — (map)

                The file metadata of the input file.

                • dataSets — (Array<map>)

                  The data sets of the file metadata.

                  • typerequired — (String)

                    The type of the data set.

                    Possible values include:
                    • "PS"
                  • namerequired — (String)

                    The name of the data set.

                  • ccsidrequired — (String)

                    The CCSID of the data set.

                  • formatrequired — (String)

                    The format of the data set.

                    Possible values include:
                    • "FIXED"
                    • "VARIABLE"
                    • "LINE_SEQUENTIAL"
                  • lengthrequired — (Integer)

                    The length of the data set.

                • databaseCDC — (map)

                  The database CDC of the file metadata.

                  • sourceMetadatarequired — (map)

                    The source metadata of the database CDC.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata of the database CDC.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
          • output — (map)

            The output of the compare action.

            • file — (map)

              The file of the output.

              • fileLocation — (String)

                The file location of the output file.

    • afterSteps — (Array<map>)

      The after steps of the test suite.

      • namerequired — (String)

        The name of the step.

      • description — (String)

        The description of the step.

      • actionrequired — (map)

        The action of the step.

        • resourceAction — (map)

          The resource action of the step action.

          • m2ManagedApplicationAction — (map)

            The AWS Mainframe Modernization managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
            • properties — (map)

              The properties of the AWS Mainframe Modernization managed application action.

              • forceStop — (Boolean)

                Force stops the AWS Mainframe Modernization managed action properties.

              • importDataSetLocation — (String)

                The import data set location of the AWS Mainframe Modernization managed action properties.

          • m2NonManagedApplicationAction — (map)

            The AWS Mainframe Modernization non-managed application action of the resource action.

            • resourcerequired — (String)

              The resource of the AWS Mainframe Modernization non-managed application action.

            • actionTyperequired — (String)

              The action type of the AWS Mainframe Modernization non-managed application action.

              Possible values include:
              • "Configure"
              • "Deconfigure"
          • cloudFormationAction — (map)

            The CloudFormation action of the resource action.

            • resourcerequired — (String)

              The resource of the CloudFormation action.

            • actionType — (String)

              The action type of the CloudFormation action.

              Possible values include:
              • "Create"
              • "Delete"
        • mainframeAction — (map)

          The mainframe action of the step action.

          • resourcerequired — (String)

            The resource of the mainframe action.

          • actionTyperequired — (map)

            The action type of the mainframe action.

            • batch — (map)

              The batch of the mainframe action type.

              • batchJobNamerequired — (String)

                The job name of the batch.

              • batchJobParameters — (map<String>)

                The batch job parameters of the batch.

              • exportDataSetNames — (Array<String>)

                The export data set names of the batch.

            • tn3270 — (map)

              The tn3270 port of the mainframe action type.

              • scriptrequired — (map)

                The script of the TN3270 protocol.

                • scriptLocationrequired — (String)

                  The script location of the scripts.

                • typerequired — (String)

                  The type of the scripts.

                  Possible values include:
                  • "Selenium"
              • exportDataSetNames — (Array<String>)

                The data set names of the TN3270 protocol.

          • properties — (map)

            The properties of the mainframe action.

            • dmsTaskArn — (String)

              The DMS task ARN of the mainframe action properties.

        • compareAction — (map)

          The compare action of the step action.

          • inputrequired — (map)

            The input of the compare action.

            • file — (map)

              The file in the input.

              • sourceLocationrequired — (String)

                The source location of the input file.

              • targetLocationrequired — (String)

                The target location of the input file.

              • fileMetadatarequired — (map)

                The file metadata of the input file.

                • dataSets — (Array<map>)

                  The data sets of the file metadata.

                  • typerequired — (String)

                    The type of the data set.

                    Possible values include:
                    • "PS"
                  • namerequired — (String)

                    The name of the data set.

                  • ccsidrequired — (String)

                    The CCSID of the data set.

                  • formatrequired — (String)

                    The format of the data set.

                    Possible values include:
                    • "FIXED"
                    • "VARIABLE"
                    • "LINE_SEQUENTIAL"
                  • lengthrequired — (Integer)

                    The length of the data set.

                • databaseCDC — (map)

                  The database CDC of the file metadata.

                  • sourceMetadatarequired — (map)

                    The source metadata of the database CDC.

                    • typerequired — (String)

                      The type of the source database metadata.

                      Possible values include:
                      • "z/OS-DB2"
                    • captureToolrequired — (String)

                      The capture tool of the source database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
                  • targetMetadatarequired — (map)

                    The target metadata of the database CDC.

                    • typerequired — (String)

                      The type of the target database metadata.

                      Possible values include:
                      • "PostgreSQL"
                    • captureToolrequired — (String)

                      The capture tool of the target database metadata.

                      Possible values include:
                      • "Precisely"
                      • "AWS DMS"
          • output — (map)

            The output of the compare action.

            • file — (map)

              The file of the output.

              • fileLocation — (String)

                The file location of the output file.

    • testCases — (map)

      The test cases in the test suite.

      • sequential — (Array<String>)

        The sequential of the test case.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • testSuiteId — (String)

        The test suite ID of the test suite.

      • testSuiteVersion — (Integer)

        The test suite version of the test suite.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

waitFor(state, params = {}, callback) ⇒ AWS.Request

Waits for a given AppTest resource. The final callback or 'complete' event will be fired only when the resource is either in its final state or the waiter has timed out and stopped polling for the final state.

Parameters:

  • state (String)

    the resource state to wait for. Available states for this service are listed in "Waiter Resource States" below.

  • params (map) (defaults to: {})

    a list of parameters for the given state. See each waiter resource state for required parameters.

Callback (callback):

  • function(err, data) { ... }

    Callback containing error and data information. See the respective resource state for the expected error or data information.

    If the waiter times out its requests, it will return a ResourceNotReady error.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.