Web Services › Using Web Services › CA Endevor SCM SOAP Web Services › Valid Operations for User-Written Client Programs › SubmitSCL Operation › To | From Attachment Syntax

To | From Attachment Syntax

Instead of the TO | FROM DDNAME clause on the SCL statement for an Add, Update, or Retrieve action, use the following syntax:

TO|FROM ATTachment attachment-name PATH mypath LFSFILE myfile

To Attachment attachment-name

Specifies the name of the SOAP Attachment object that contains the data that is to be sent from CA Endevor SCM to the client.

From Attachment attachment-name

Specifies the name of the SOAP Attachment object that contains the data that is to be sent from the client to CA Endevor SCM.

PATH mypath

Specifies the directory on the client side. For the From Attachment clause, Path is where the source file resides. For the To Attachment clause, Path is where the file is to be saved to.

LFSFILE myfile

Specifies the name of the file in the directory on the client side. For the From Attachment clause, Lfsfile is the name of the source file. For the To Attachment clause, Lfsfile is the name that the received file is saved as.

Example: Add Element Statement with Attachment

The following Add Element statement adds element CCIDRPT2 to Stage 1 of the DEV Environment, EABASE System, UTILITY Subsytem, COBOL Type library. The SOAP Attachment object UPLOADD contains a copy of the content of myfile located at myPath. on the client side. This statement adds the contents of the SOAP Attachment to CA Endevor SCM. The optional Options clause associates the comment "Project myfile' to the element.

ADD ELEMENT CCIDRPT2 
	FROM ATTACHMENT UPLOADDD PATH myPath LFSFILE myFile 
	TO ENV DEV SYS EABASE SUB UTILITY TYPE COBOL STAGE NUMBER 1
	OPTIONS UPD COMMENT 'Project myFile' .

Example: Retrieve Element Statement with Attachment

The following Retrieve Element statement retrieves element CCIDRPT5 from Stage 1 of the DEV Environment, EABASE System, UTILITY Subsytem, COBOL Type library. A copy of the data that is element CCIDRPT5 is added to the SOAP Attachment object DNLOADD. Web Services send a SOAP message response back to the client. The SOAP message includes Attachment. The client extracts the data from the Attachment and copies it to myfile located at myPath. on the client side.

RETRIEVE ELEMENT CCIDRPT5 
	FROM ENV DEV SYS EABASE SUB UTILITY TYPE COBOL STAGE NUMBER 1	
	TO ATTACHMENT DNLOADDD PATH myPath LFSFILE myFile .