published on in news

File Dump

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

The following attributes configure the task:

AttributeTypePurposeDefault
repositorystringName of the file repository
textstringText display mode: ascii, ebcdic or offascii
skipintegerNumber of records to skipzero
countintegerNumber of records to display. If zero, all records are displayed

The following elements configure the file comparison:

ElementPurpose
fileName 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:

AttributeTypePurposeDefault
recfmtstringDefines the record format of the file. Refer to File Formatsfixed
reclenintegerDefines the maximum record length
varfmtstringDefines the variable record format. Refer to Variable Record FormatsIf not specified, the repository default is assumed.
ddstringWhen 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.
trimboolIf true, trailing spaces and NULLs (0x00) are removed from line sequential recordsfalse
encodingstringName of the text encoding to be used for Line Sequential files.Latin1
cacheboolIf false, file copy is refreshed (applies to cached repositories only)true

File Formats

TypeSynonimDescription
fixedfbFixed Record Length
variablevbVariable Record Length
lineseqlsLine Sequential

Variable Record Formats

TypeDescription
ibmIBM variable record format
microfocusMicro 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

StatusStatus codeDescription
Ready-1Task is initialized, but not yet started
Running-2Task is running
Success0Task completed successfully
Warnings1Task completed with warnings
Errors2Task completed with errors
Aborted9Task cannot be executed

ncG1vNJzZmihkaPCtLDOnGWzbl6ssqN6wqipnmannrulu9asZaedpGSxsK%2FSaKuaq5uofKe1y56brqWgY7W1ucs%3D