File Dump

The file dump task (filedump) displays the content of the specified file to the job log.

The following attributes configure the task:

Attribute	Type	Purpose	Default
repository	string	Name of the file repository
text	string	Text display mode: ascii, ebcdic or off	ascii
skip	integer	Number of records to skip	zero
count	integer	Number of records to display. If zero, all records are displayed

The following elements configure the file comparison:

Element	Purpose
file	Name and attributes of the file. Refer to File.

File

The file element is used to define the file to display.

The following attributes configure the file:

Attribute	Type	Purpose	Default
recfmt	string	Defines the record format of the file. Refer to File Formats	fixed
reclen	integer	Defines the maximum record length
varfmt	string	Defines the variable record format. Refer to Variable Record Formats	If not specified, the repository default is assumed.
dd	string	When used with in a JCL interface, the name of the DD JCL statement referencing the file. The file characteristics are extracted from the file catalog and, therefore, the other attributes (recfmt, reclen and varfmt) are ignored.
trim	bool	If true, trailing spaces and NULLs (0x00) are removed from line sequential records	false
encoding	string	Name of the text encoding to be used for Line Sequential files.	Latin1
cache	bool	If false, file copy is refreshed (applies to cached repositories only)	true

Note

The list of available encodings is listed here: https://docs.microsoft.com/it-it/dotnet/api/system.text.encoding?view=net-5.0

Note

For MARS repositories, recfmt, reclen and varfmt are ignored. The file characteristics are extracted from the MARS file catalog.

File Formats

Type	Synonim	Description
fixed	fb	Fixed Record Length
variable	vb	Variable Record Length
lineseq	ls	Line Sequential

Variable Record Formats

Type	Description
ibm	IBM variable record format
microfocus	Micro Focus variable record format

Example

<job name="DUMPTASK">
	<filedump name="TESTASCII" repository="REPOASCII">
		<file recfmt="fixed" reclen="80">IANUS.TEST.SEQ01.ASCII.DAT</file>
	</filedump>
	<filedump name="TESTEBCDIC" repository="REPOEBCDIC" 
                text="ebcdic" skip="1" count="2">
		<file recfmt="fixed" reclen="80">IANUS.TEST.SEQ01.EBCDIC.DAT</file>
	</filedump>
</job>

Status codes

Status	Status code	Description
Ready	-1	Task is initialized, but not yet started
Running	-2	Task is running
Success	0	Task completed successfully
Warnings	1	Task completed with warnings
Errors	2	Task completed with errors
Aborted	9	Task cannot be executed