FILETACQ 🚀

Name

filetacq

Location

The CLI executable is available at:

<installation_dir>/app/bin

Purpose

Acquires one or more files from a specified queue to a local filesystem.

Synopsis

• filetacq [options] <QueueManagerName> <QueueName>

• filetacq -h

Description

The filetacq command acquires one or more files from a specified queue and writes them into a local filesystem. When you use this command, metadata can be applied as a filter to select the file that is acquired.

This command is provided to ensure backward compatibility with legacy automation and operational scripts. See Compatibility Command Line Interfaces to map QueueManagerName and QueueName concepts into Data Mover Smart concepts.

Arguments

Argument	Description	Required
QueueManagerName	Name of the Queue Manager hosting the queue	Yes
QueueName	Name of the queue to be listed	Yes

Options

Option	Parameter	Description
[-w]	MsgFileId	Optional metadata associated with the file; it can be used as a filter when retrieving the file. Cannot be used with [-i]
[-c]	CorrelID	Optional metadata associated with the file; it can be used as a filter when retrieving the file. Cannot be used with [-i]
[-i]	IntNum	Specifies the Internal Number of the file to be retrieved. Cannot be used with [-c], [-w], [-s], [-n]
[-s]	Sender	Optional metadata associated with the file; can be used as a filter when retrieving the file. Cannot be used with [-i]
[-n]	UserClass	Optional metadata associated with the file; can be used as a filter when retrieving the file. Cannot be used with [-i]
[-u]	<userId>	User registered in Data Mover Smart.
[-p]	<userPwd>	Password of the UserId.
[-f]	FileName	If specified, it assigns a name to the retrieved files; otherwise the filename is searched the Spazio UserArea. By default an internal specification of filename is searched; if not found MsgFileId is used.
[-d]	FilePath	If specified, it is used as a destination directory for the retrieved files; otherwise the current working directory is used. By default Spazio working directory is used.
[-g]	CodePage	Specifies a code page number.
[-m]	INput | BRowselast	Specifies whether the acquired file must be deleted (INput set) or left in the queue. By default the first file found is returned. If BRowselast is set, the last file found is returned.
[-o]	NOBanner	Ignored.
[-o]	ALl	Specifies multiple acquisition; by default a single file is acquired.
[-o]	CLRF | LF | NOEor	Specifies EOR character for DATA file BYREC acquisitions. Default EOR is LF or CRLF (platform dependent).
[-x]	CCSID(string)	Specifies destination Character Set name or alias.
[-x]	🚀 Language(ENG|ITA)	Specifies the language of the LogFileName.
[-v]		Enables verbose output to standard output. Ignored.
[-l]	🚀 LogFileName	Writes log output to specified file (or default log file if omitted).

Option usage rules

• multiple -o and -x options can be specified

• options are processed cumulatively

Exit status

Code	Legacy code	Meaning
0	SP0000	Success
1	SP6001	Invalid number of arguments/incorrect usage
1	SP2085	Queue name does not exist
1	SP8002	Queue Manager does not exist
3	SP6301	Specified file not found or a directory has been provided, but ZDIR option is not specified