Skip to main content

Standalone File Transfer

The SMAFT agent can be run in a job step, using the following JCL:

//GETFILE EXEC PGM=IKJEFT1B,PARM='XPFTAGT'
//SYSEXEC DD DISP=SHR,DSN=OPCON.V210004.INSTLIB
//SYSTSIN DD DUMMY
//SYSTSPRT DD SYSOUT=*
//XPSIN DD *
SERVER name:port
file Source File Name
SAVEAS Destination File Name

Standalone File Transfer JCL

DDRequired?Description
SYSEXECYesThis must point to a library containing XPSFTAGTXPFTAGT and XPCRCRX. In V4.03.02 and higher, the z/OS LSAM installs these programs in *hlq.mlq.*INSTLIB.
SYSTSINYesMust be DUMMY.
SYSTSPRTYesThis file will contain any messages from the agent.
XPSINYes
  • This file contains the instructions to the agent. Each line contains a keyword, followed by one or more space, and the value. Leading and trailing spaces will be removed.
  • Keywords are not case sensitive.
  • File and Auth values are case sensitive, others are not.
  • Refer to below for supported keywords.
XPSOUT or user defined nameNoThis file will be used if no SaveAs keyword is supplied. It can be allocated to any sequential file, including SYSOUT or generation data sets.

Keywords Table for Standalone File Transfer

KeywordRequired?ValuesDefaultNotes
ServerYesThe name or IP address of a SMAFT server, followed by a colon (:) and port number.NoneIf then server name is used, it must be resolvable to an IP address.
FileYesThe name of the source file name.None 
AuthNoThe security code under which to obtain access to the file in the server.Null (the empty string)The format is server specific. Consult the necessary documentation.
SaveAsNoThe dataset name to be used for the output file, or DD:ddname to write the data to a user defined DDname.DD:XPSOUTIf a dataset name is used, it will be qualified with the prefix defined for the active user. If that is not desired, enclose the name in single quotes. If the DD: form is used, the following keywords are ignored:
  • Collision
  • LRECL
  • RECFM
SourceDataTypeNoThe data type of the file on the source machine:
  • Binary
  • EBCDIC
  • ASCII
  • Default Text
Default TextIf Binary is chosen for SourceDataType, DestDataType will be forced to binary.
DestDataTypeNoThe data type to be used locally. The values are the same as SourceDataType.EBCDIC 
CollisionNoWhat to do if the SaveAs dataset name exists:
  • Do Not Overwrite
  • Overwrite
  • Append
Do Not OverwriteThe BACKUP options are not supported at this time.
LRECLNoThe logical record length of the output dataset.The smallest value that will hold the longest input record 
RECFMNoThe record format of the output dataset:
  • F B
  • V B
  • F
  • V
V B