S3Utils

BLOB Copy Operations

BLOB (Binary Large Object) copy operations copy the contents of S3 objects to or from the S3SERV request or response IPM.

Get S3 Object

The Get Object request is used to retrieve the content of an S3 object and return its content to the requester in the reply IPM. S3SSERV retrieves the S3 Object contents and stores as much of it as will fit TARGET-BLOB. The data length is returned TARGET-BLOB-LEN.

Get S3 Object Request

DEF S3-GET-BLOB-RQ.
  02  RQ-HDR                            TYPE S3-HEADER-RQ.
  02  SOURCE-OBJECT                     TYPE CHARACTER 256.
END

Get S3 Object Reply

DEF S3-GET-BLOB-RP.
  02  RP-HDR                            TYPE S3-HEADER-RP.
  02  TARGET-BLOB-LEN                   TYPE BINARY 32 UNSIGNED.
  02  TARGET-BLOB                       TYPE CHARACTER 32000.
END


Put S3 Object

The “put object” request is used to store content received in the IPM to an S3 object.  S3SERV attempts to store SOURCE-BLOB-LEN bytes from SOURCE-BLOB to the S3 Object. 

Put S3 Object Request

DEF S3-PUT-BLOB-RQ.
  02  RQ-HDR                            TYPE S3-HEADER-RQ.
  02  TARGET-OBJECT                     TYPE CHARACTER 256.
  02  SOURCE-BLOB-LEN                   TYPE BINARY 32 UNSIGNED.
  02  SOURCE-BLOB                       TYPE CHARACTER 32000.
END

Put S3 Object Reply

DEF S3-PUT-BLOB-RP.
  02  RP-HDR                            TYPE S3-HEADER-RP.
END