@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSB2BiAsync extends AbstractAWSB2Bi implements AWSB2BiAsync
AWSB2BiAsync. Convenient method forms pass through to the corresponding overload
that takes a request object and an AsyncHandler, which throws an UnsupportedOperationException.ENDPOINT_PREFIXcreateCapability, createPartnership, createProfile, createTransformer, deleteCapability, deletePartnership, deleteProfile, deleteTransformer, getCachedResponseMetadata, getCapability, getPartnership, getProfile, getTransformer, getTransformerJob, listCapabilities, listPartnerships, listProfiles, listTagsForResource, listTransformers, shutdown, startTransformerJob, tagResource, testMapping, testParsing, untagResource, updateCapability, updatePartnership, updateProfile, updateTransformerequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcreateCapability, createPartnership, createProfile, createTransformer, deleteCapability, deletePartnership, deleteProfile, deleteTransformer, getCachedResponseMetadata, getCapability, getPartnership, getProfile, getTransformer, getTransformerJob, listCapabilities, listPartnerships, listProfiles, listTagsForResource, listTransformers, shutdown, startTransformerJob, tagResource, testMapping, testParsing, untagResource, updateCapability, updatePartnership, updateProfile, updateTransformerpublic Future<CreateCapabilityResult> createCapabilityAsync(CreateCapabilityRequest request)
AWSB2BiAsyncInstantiates a capability based on the specified parameters. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
createCapabilityAsync in interface AWSB2BiAsyncpublic Future<CreateCapabilityResult> createCapabilityAsync(CreateCapabilityRequest request, AsyncHandler<CreateCapabilityRequest,CreateCapabilityResult> asyncHandler)
AWSB2BiAsyncInstantiates a capability based on the specified parameters. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
createCapabilityAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreatePartnershipResult> createPartnershipAsync(CreatePartnershipRequest request)
AWSB2BiAsyncCreates a partnership between a customer and a trading partner, based on the supplied parameters. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
createPartnershipAsync in interface AWSB2BiAsyncpublic Future<CreatePartnershipResult> createPartnershipAsync(CreatePartnershipRequest request, AsyncHandler<CreatePartnershipRequest,CreatePartnershipResult> asyncHandler)
AWSB2BiAsyncCreates a partnership between a customer and a trading partner, based on the supplied parameters. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
createPartnershipAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateProfileResult> createProfileAsync(CreateProfileRequest request)
AWSB2BiAsyncCreates a customer profile. You can have up to five customer profiles, each representing a distinct private network. A profile is the mechanism used to create the concept of a private network.
createProfileAsync in interface AWSB2BiAsyncpublic Future<CreateProfileResult> createProfileAsync(CreateProfileRequest request, AsyncHandler<CreateProfileRequest,CreateProfileResult> asyncHandler)
AWSB2BiAsyncCreates a customer profile. You can have up to five customer profiles, each representing a distinct private network. A profile is the mechanism used to create the concept of a private network.
createProfileAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateTransformerResult> createTransformerAsync(CreateTransformerRequest request)
AWSB2BiAsyncCreates a transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
createTransformerAsync in interface AWSB2BiAsyncpublic Future<CreateTransformerResult> createTransformerAsync(CreateTransformerRequest request, AsyncHandler<CreateTransformerRequest,CreateTransformerResult> asyncHandler)
AWSB2BiAsyncCreates a transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
createTransformerAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteCapabilityResult> deleteCapabilityAsync(DeleteCapabilityRequest request)
AWSB2BiAsyncDeletes the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
deleteCapabilityAsync in interface AWSB2BiAsyncpublic Future<DeleteCapabilityResult> deleteCapabilityAsync(DeleteCapabilityRequest request, AsyncHandler<DeleteCapabilityRequest,DeleteCapabilityResult> asyncHandler)
AWSB2BiAsyncDeletes the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
deleteCapabilityAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeletePartnershipResult> deletePartnershipAsync(DeletePartnershipRequest request)
AWSB2BiAsyncDeletes the specified partnership. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
deletePartnershipAsync in interface AWSB2BiAsyncpublic Future<DeletePartnershipResult> deletePartnershipAsync(DeletePartnershipRequest request, AsyncHandler<DeletePartnershipRequest,DeletePartnershipResult> asyncHandler)
AWSB2BiAsyncDeletes the specified partnership. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
deletePartnershipAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteProfileResult> deleteProfileAsync(DeleteProfileRequest request)
AWSB2BiAsyncDeletes the specified profile. A profile is the mechanism used to create the concept of a private network.
deleteProfileAsync in interface AWSB2BiAsyncpublic Future<DeleteProfileResult> deleteProfileAsync(DeleteProfileRequest request, AsyncHandler<DeleteProfileRequest,DeleteProfileResult> asyncHandler)
AWSB2BiAsyncDeletes the specified profile. A profile is the mechanism used to create the concept of a private network.
deleteProfileAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteTransformerResult> deleteTransformerAsync(DeleteTransformerRequest request)
AWSB2BiAsyncDeletes the specified transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
deleteTransformerAsync in interface AWSB2BiAsyncpublic Future<DeleteTransformerResult> deleteTransformerAsync(DeleteTransformerRequest request, AsyncHandler<DeleteTransformerRequest,DeleteTransformerResult> asyncHandler)
AWSB2BiAsyncDeletes the specified transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
deleteTransformerAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetCapabilityResult> getCapabilityAsync(GetCapabilityRequest request)
AWSB2BiAsyncRetrieves the details for the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
getCapabilityAsync in interface AWSB2BiAsyncpublic Future<GetCapabilityResult> getCapabilityAsync(GetCapabilityRequest request, AsyncHandler<GetCapabilityRequest,GetCapabilityResult> asyncHandler)
AWSB2BiAsyncRetrieves the details for the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
getCapabilityAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetPartnershipResult> getPartnershipAsync(GetPartnershipRequest request)
AWSB2BiAsyncRetrieves the details for a partnership, based on the partner and profile IDs specified. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
getPartnershipAsync in interface AWSB2BiAsyncpublic Future<GetPartnershipResult> getPartnershipAsync(GetPartnershipRequest request, AsyncHandler<GetPartnershipRequest,GetPartnershipResult> asyncHandler)
AWSB2BiAsyncRetrieves the details for a partnership, based on the partner and profile IDs specified. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
getPartnershipAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetProfileResult> getProfileAsync(GetProfileRequest request)
AWSB2BiAsyncRetrieves the details for the profile specified by the profile ID. A profile is the mechanism used to create the concept of a private network.
getProfileAsync in interface AWSB2BiAsyncpublic Future<GetProfileResult> getProfileAsync(GetProfileRequest request, AsyncHandler<GetProfileRequest,GetProfileResult> asyncHandler)
AWSB2BiAsyncRetrieves the details for the profile specified by the profile ID. A profile is the mechanism used to create the concept of a private network.
getProfileAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetTransformerResult> getTransformerAsync(GetTransformerRequest request)
AWSB2BiAsyncRetrieves the details for the transformer specified by the transformer ID. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
getTransformerAsync in interface AWSB2BiAsyncpublic Future<GetTransformerResult> getTransformerAsync(GetTransformerRequest request, AsyncHandler<GetTransformerRequest,GetTransformerResult> asyncHandler)
AWSB2BiAsyncRetrieves the details for the transformer specified by the transformer ID. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
getTransformerAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetTransformerJobResult> getTransformerJobAsync(GetTransformerJobRequest request)
AWSB2BiAsyncReturns the details of the transformer run, based on the Transformer job ID.
getTransformerJobAsync in interface AWSB2BiAsyncpublic Future<GetTransformerJobResult> getTransformerJobAsync(GetTransformerJobRequest request, AsyncHandler<GetTransformerJobRequest,GetTransformerJobResult> asyncHandler)
AWSB2BiAsyncReturns the details of the transformer run, based on the Transformer job ID.
getTransformerJobAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListCapabilitiesResult> listCapabilitiesAsync(ListCapabilitiesRequest request)
AWSB2BiAsyncLists the capabilities associated with your Amazon Web Services account for your current or specified region. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
listCapabilitiesAsync in interface AWSB2BiAsyncpublic Future<ListCapabilitiesResult> listCapabilitiesAsync(ListCapabilitiesRequest request, AsyncHandler<ListCapabilitiesRequest,ListCapabilitiesResult> asyncHandler)
AWSB2BiAsyncLists the capabilities associated with your Amazon Web Services account for your current or specified region. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
listCapabilitiesAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListPartnershipsResult> listPartnershipsAsync(ListPartnershipsRequest request)
AWSB2BiAsyncLists the partnerships associated with your Amazon Web Services account for your current or specified region. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
listPartnershipsAsync in interface AWSB2BiAsyncpublic Future<ListPartnershipsResult> listPartnershipsAsync(ListPartnershipsRequest request, AsyncHandler<ListPartnershipsRequest,ListPartnershipsResult> asyncHandler)
AWSB2BiAsyncLists the partnerships associated with your Amazon Web Services account for your current or specified region. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
listPartnershipsAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListProfilesResult> listProfilesAsync(ListProfilesRequest request)
AWSB2BiAsyncLists the profiles associated with your Amazon Web Services account for your current or specified region. A profile is the mechanism used to create the concept of a private network.
listProfilesAsync in interface AWSB2BiAsyncpublic Future<ListProfilesResult> listProfilesAsync(ListProfilesRequest request, AsyncHandler<ListProfilesRequest,ListProfilesResult> asyncHandler)
AWSB2BiAsyncLists the profiles associated with your Amazon Web Services account for your current or specified region. A profile is the mechanism used to create the concept of a private network.
listProfilesAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request)
AWSB2BiAsyncLists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a capability, partnership, profile, or transformer.
listTagsForResourceAsync in interface AWSB2BiAsyncpublic Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest request, AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler)
AWSB2BiAsyncLists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a capability, partnership, profile, or transformer.
listTagsForResourceAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListTransformersResult> listTransformersAsync(ListTransformersRequest request)
AWSB2BiAsyncLists the available transformers. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
listTransformersAsync in interface AWSB2BiAsyncpublic Future<ListTransformersResult> listTransformersAsync(ListTransformersRequest request, AsyncHandler<ListTransformersRequest,ListTransformersResult> asyncHandler)
AWSB2BiAsyncLists the available transformers. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
listTransformersAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<StartTransformerJobResult> startTransformerJobAsync(StartTransformerJobRequest request)
AWSB2BiAsyncRuns a job, using a transformer, to parse input EDI (electronic data interchange) file into the output structures used by Amazon Web Services B2BI Data Interchange.
If you only want to transform EDI (electronic data interchange) documents, you don't need to create profiles,
partnerships or capabilities. Just create and configure a transformer, and then run the
StartTransformerJob API to process your files.
startTransformerJobAsync in interface AWSB2BiAsyncpublic Future<StartTransformerJobResult> startTransformerJobAsync(StartTransformerJobRequest request, AsyncHandler<StartTransformerJobRequest,StartTransformerJobResult> asyncHandler)
AWSB2BiAsyncRuns a job, using a transformer, to parse input EDI (electronic data interchange) file into the output structures used by Amazon Web Services B2BI Data Interchange.
If you only want to transform EDI (electronic data interchange) documents, you don't need to create profiles,
partnerships or capabilities. Just create and configure a transformer, and then run the
StartTransformerJob API to process your files.
startTransformerJobAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<TagResourceResult> tagResourceAsync(TagResourceRequest request)
AWSB2BiAsyncAttaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). Resources are capability, partnership, profile, transformers and other entities.
There is no response returned from this call.
tagResourceAsync in interface AWSB2BiAsyncpublic Future<TagResourceResult> tagResourceAsync(TagResourceRequest request, AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler)
AWSB2BiAsyncAttaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). Resources are capability, partnership, profile, transformers and other entities.
There is no response returned from this call.
tagResourceAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<TestMappingResult> testMappingAsync(TestMappingRequest request)
AWSB2BiAsync
Maps the input file according to the provided template file. The API call downloads the file contents from the
Amazon S3 location, and passes the contents in as a string, to the inputFileContent parameter.
testMappingAsync in interface AWSB2BiAsyncpublic Future<TestMappingResult> testMappingAsync(TestMappingRequest request, AsyncHandler<TestMappingRequest,TestMappingResult> asyncHandler)
AWSB2BiAsync
Maps the input file according to the provided template file. The API call downloads the file contents from the
Amazon S3 location, and passes the contents in as a string, to the inputFileContent parameter.
testMappingAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<TestParsingResult> testParsingAsync(TestParsingRequest request)
AWSB2BiAsyncParses the input EDI (electronic data interchange) file. The input file has a file size limit of 250 KB.
testParsingAsync in interface AWSB2BiAsyncpublic Future<TestParsingResult> testParsingAsync(TestParsingRequest request, AsyncHandler<TestParsingRequest,TestParsingResult> asyncHandler)
AWSB2BiAsyncParses the input EDI (electronic data interchange) file. The input file has a file size limit of 250 KB.
testParsingAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request)
AWSB2BiAsyncDetaches a key-value pair from the specified resource, as identified by its Amazon Resource Name (ARN). Resources are capability, partnership, profile, transformers and other entities.
untagResourceAsync in interface AWSB2BiAsyncpublic Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest request, AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler)
AWSB2BiAsyncDetaches a key-value pair from the specified resource, as identified by its Amazon Resource Name (ARN). Resources are capability, partnership, profile, transformers and other entities.
untagResourceAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateCapabilityResult> updateCapabilityAsync(UpdateCapabilityRequest request)
AWSB2BiAsyncUpdates some of the parameters for a capability, based on the specified parameters. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
updateCapabilityAsync in interface AWSB2BiAsyncpublic Future<UpdateCapabilityResult> updateCapabilityAsync(UpdateCapabilityRequest request, AsyncHandler<UpdateCapabilityRequest,UpdateCapabilityResult> asyncHandler)
AWSB2BiAsyncUpdates some of the parameters for a capability, based on the specified parameters. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
updateCapabilityAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdatePartnershipResult> updatePartnershipAsync(UpdatePartnershipRequest request)
AWSB2BiAsyncUpdates some of the parameters for a partnership between a customer and trading partner. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
updatePartnershipAsync in interface AWSB2BiAsyncpublic Future<UpdatePartnershipResult> updatePartnershipAsync(UpdatePartnershipRequest request, AsyncHandler<UpdatePartnershipRequest,UpdatePartnershipResult> asyncHandler)
AWSB2BiAsyncUpdates some of the parameters for a partnership between a customer and trading partner. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
updatePartnershipAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateProfileResult> updateProfileAsync(UpdateProfileRequest request)
AWSB2BiAsyncUpdates the specified parameters for a profile. A profile is the mechanism used to create the concept of a private network.
updateProfileAsync in interface AWSB2BiAsyncpublic Future<UpdateProfileResult> updateProfileAsync(UpdateProfileRequest request, AsyncHandler<UpdateProfileRequest,UpdateProfileResult> asyncHandler)
AWSB2BiAsyncUpdates the specified parameters for a profile. A profile is the mechanism used to create the concept of a private network.
updateProfileAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateTransformerResult> updateTransformerAsync(UpdateTransformerRequest request)
AWSB2BiAsyncUpdates the specified parameters for a transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
updateTransformerAsync in interface AWSB2BiAsyncpublic Future<UpdateTransformerResult> updateTransformerAsync(UpdateTransformerRequest request, AsyncHandler<UpdateTransformerRequest,UpdateTransformerResult> asyncHandler)
AWSB2BiAsyncUpdates the specified parameters for a transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
updateTransformerAsync in interface AWSB2BiAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.