Knowledge Base > Automation Engine and Target Systems > BS2000 > Agent - File Transfer Support

BS2000 Agent - File Transfer Support

The BS2000 agent supports all file transfer functions such as the transfers of text and binary files or file transfers with wildcard characters.

File Attributes for Destination

When defining a FileTransfer object, you can also specify file attributes for the destination in the FileTransfer tab. All file attributes which comply with the file command can be used. They are entered in a separate text field. Several file attributes need to be separated with commas:

Text mode:

FCB=SAM,LINK=UCEXSAM,SPACE=(300,300)

Binary mode:

SPACE=(300,300),BLKSIZE=STD,BLKCTRL=NO,FCB=PAM

Specified attributes replace default values or are added to the command.

Specifying an attribute means that the default-file command in the agent is overwritten. The specification of SPACE= would result in a SAM file with RECFORM=FIX, for example. In this case, the attribute RECFORM is also required if you use RECFORM=V.

The Siemens FT BS2000 can also be used to create ISAM files. Example:

FCB=ISAM,BLKCTRL=DATA,RECFORM=V,KEYPOS=5,KEYLEN=8

Example

RECSIZE=50,VOLUME=PRIVATE,SPACE=(100,100)

Library Elements As Source and Destination

Elements of LMS libraries (PLAM) can be a file transfer's source and destination.

Library elements can be transferred between two LMS libraries.
A library element can be transferred as a file to any destination system.
Text files can be transferred to an LMS library from any destination system.

The element should be specified in the following form:

*LIB(Library,Element(Version),Type)

The element version is optional. The highest version is read (source) or an element is written with version "@" (target) if no version has been specified.

Examples

*LIB($RS.LMS.LIB,MY.ELEMENT,S)

+LIB($RS.LMS.LIB,MY.*,S)

Keeping the Original Attributes

To assume the attributes of source files to destination files, use the option Keep original file attributes in the FileTransfer tab. This setting is only considered if source and destination agent are of a Automation Engine version 9.00A or later (newfile transfer protocol). Source and destination platform must comply with each other.

The following file attributes can be preserved in BS2000 file transfers:

Attributes Catalog Macro	Attributes File Macro
ACCESS ACLPROT BACKUP BASACL CCS DESTROY EXDATE GROUPAR GUARDS LARGE OTHERAR OWNERAR RETPD SHARE	BLKCTRL BLKSIZE DUPEKY FCBTYPE KEYLEN KEYPOS RECFORM RECSIZE RETPD SPACE

Note that the file transfer must not include additional attributes for the destination file if this setting is used. Otherwise, an error will occur.

Limitations to File Transfers with PAM Files

Keep the following limitations in mind:

The BS2000 agent sends the file: If the PAM file is available in Non-Key (NK) format without an end being marked, the last page is ignored and the file is read to the file size.
The BS2000 agent receives the file: When writing a PAM file, an end marker (additional logical block) is attached. This block can occasionally disturb (in particular cases even destroy) file structures.