Synopsis
[Windows]
file [file name],ac (access name) [,prt({printer name | *})
[,prtform([fontname=font name] [,fontsize=font size]
[,orient={port | land}] [,form=paper size])]][UNIX]
file [file name],ac(access name) [,prt ({printer name | *})]Description
This statement specifies the file information used by the total job.
By specifying the prt operand, the file can be printed.
Operands
file name
Specify the file name of an input/output file used in the executable program or batch file [Windows]/shell script [UNIX].
The specified file name is set to the same name as the environment variable of the access name. Even if the specified file name contains other environment variable "%character strings%" [Windows]/"$character strings" [UNIX], it is not set to the other environment variable name. The executable program or batch file [Windows] or shell script [UNIX] specified in the exec control statement can obtain the file name from the environment variable.
This operand can be omitted only when the prt operand is specified.
If this operand is omitted, Job Execution Control will create a temporary work file. A unique file name is set for this temporary work file on the system. Note that this temporary work file is deleted when the job is deleted from the job queue after the file contents have been output to the printer.
ac (access name)
Specify any access name. The file name is set in the environment variable with the same name as the specified access name.
Access names must meet the following conditions:
No more than 64 bytes
Only alphanumeric characters and "_" (underscores) are used
The first character is not a numeral
prt ({printer name|*})
After the job has completed, the contents of the file specified in the first argument of this statement are output to the printer. However, only the contents of text file can be output.
If the printer name is specified, it is output to the specified printer. The printer name must meet the following requirements:
32 bytes or less
"&", "(" and ")" are not included
If (*) is specified, the file is output to the printer that is specified in the prt operand of the jobstart statement.
When specifying the printer name, the name defined in the [Print Format] sheet of the [Define Operating Information] window can be used. [Windows]
prtform [Windows]
Specify the attributes related to print format. Make sure to specify one or more sub operands. For the specification value of the sub operand, specify values allowed in the Print Manager for Windows.
When the attributes related to print format are specified, the print format is determined as follows:
If the printer defined in the prt operand of the file statement is already defined in the [Print Format] sheet of the [Define Operating Information] window for Job Execution Control
The print form defined in the above sheet and the one specified in this operand will be merged.
If the printer defined in the prt operand of the file statement is not defined in the [Print Format] sheet of the [Define Operating Information] window for Job Execution Control
The print form specified in this operand will be used.
When this operand is omitted, the print format is determined as follows:
If the printer specified in the prt operand of the file statement is already defined in the [Print Format] sheet of the [Define Operation Information] window for Job Execution Control
The print form defined in the above sheet will be used.
If the printer specified in the prt operand of the file statement is not defined in the [Print Format] sheet of the [Define Operating Information] window for Job Execution Control
The defaults (in Windows' definition) of the printer will be used.
Specify the font name.
If this operand is omitted, the font name specified in initialization parameter "prt" will be used.
Specify the font size. The unit is measured in points.
If this operand is omitted, the font size specified in initialization parameter "prt" will be used.
Specify the print orientation. For portrait printing, specify port, and for landscape printing, specify land.
If this operand is omitted, the print orientation specified in initialization parameter "prt" will be used.
Specify the paper size.
If this operand is omitted, the paper size specified in initialization parameter "prt" will be used.
Examples
[Windows]
In the following example, the access name "out1" is assigned to the file called "d:\result\data1" (from job process, the file name can be obtained by referring to the environment variable "out1") and the file is set to be output to "prt1" after the job has completed. The output attributes are the font name "system," font size "10 points", and print orientation "landscape."
file d:\result\data1,ac(out1),prt(prt1), prtform(fontname=system,fontsize=10,orient=port)
[UNIX]
In the following example, the access name "output1" is assigned to the file called "/result/data1" (from job process, the file name can be obtained by referring to the environment variable "output1") and the file is set to be output to "printer1" after the job has completed.
file /result/data1,ac(output1),prt(printer1)
The file name can be omitted as follows.
file ,ac(output1),prt(printer1)