Synopsis
[Windows]
file {[file name],ac(access name)|* ,ac(access name),dlm(delimiter)}
[,prt({printer name|* })
[,prtform([fontname=font name] [,fontsize=font size]
[,orient={port|land}][,form=paper size])]][UNIX]
file {[file name],ac(access name) | *,ac(access name),dlm(delimiter)}
[,prt ({printer name | *})]Description
This statement specifies the file used by the program executed by this step.
By specifying the prt operand, the file can be printed.
Operands
[file name],ac (access 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 will be deleted when the job is deleted from the job queue after the file contents have been output to the printer.
Specify any 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
When submitting a network job, specify the file name that stores the command string controlling the network job in the previously mentioned "file name", and then specify "mjsin" as the access name.
See "Figure 14.1 Job Step Configuration of Network Job" for details on job step configuration when a network job is submitted.
*,ac(access name), dlm(delimiter)
If "*" is specified, the row from the next row of this control statement to the row immediately before the delimiter appears, are stored in a temporary file created by Job Execution Control.
If "*" is specified in this control statement, it is used when executable program or batch file [Windows], or shell script [UNIX] obtains the input parameter from the file.
There is no need to create a separate file for input parameters since the input parameters can be described in JCL.
Specify any character string that signifies the last row of data in JCL. Rows up to immediately before the delimiter string specified in this operand appears are saved in a temporary file created by Job Execution Control.
Specify the delimiter character at the start of a row. Rows starting with anything other than delimiter characters, such as spaces, cannot be handled as the final row of data.
The delimiter should be specified with up to eight bytes of alphanumeric characters and it is case sensitive.
prt{printer name|*}
After the job has completed, the contents of the file specified in the first argument of this control statement are output to the printer. However only 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 two requirements.
32 bytes or less
"&", "(" and ")" are not included
If (*) is specified, the file is output to the printer specified in the prt operand of the jobstart statement.
Another printer name specified in the [Print Format] sheet of the [Define Operating Information] window for Job Execution Control can also be specified. [Windows]
prtform [Windows]
Specify the attribute 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 is 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 prt operand in the operating information file of the Job Execution Control function
The print form defined in the relevant prt operand of the operating information file and the print form specified in this operand will be merged.
If the printer defined in the prt operand of the file statement is not defined in the prt operand in the operating information file of the Job Execution Control function
The print form specified in this operand will be used.
When this operand is omitted, the print form is determined as follows:
If the printer defined in the prt operand of the file statement is already defined in the prt operand in the operating information file of the Job Execution Control function
The print form defined in the prt operand in the operating information file will be used.
If the printer defined in the prt operand of the file statement is not defined in the prt operand in the operating information file of the Job Execution Control function
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" (the file name can be obtained by referring to the environment variable "out1" from job process) 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 "portrait."
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" (the file name can be obtained by referring to the environment variable "output1" from job process) and the file is set to be output to the "printer1" after the job has completed.
file /result/data1,ac(output1),prt(printer1)
When omitting the file name in the above, describe it as follows:
file ,ac(output1),prt(printer1)
If "*" is specified in the file name, inline development of any data in JCL is specified. Below is an example of using "ZZZ" as a delimiter string to indicate the end of inline development.
file *,ac(indata1),dlm(ZZZ) .... .... .... ZZZ
....: Optional data
Synopsis
connect host(host name)
Description
This command establishes connections to another server to which job execution is requested.
Operand
host name
Specify the host name of another server to which job execution is requested. The host name is the host name defined by the network set up with TCP/IP configuration.
If the configuration has not been changed, the host name is the string with which the computer name is converted into lower case characters. [Windows]
Example
connect host(host1)
host1: Host name of another server to be connected
Synopsis
send access name [,file(send destination file name) ]
Description
This command sends the files on the server, which has submitted the job to another server specified in the connect command.
Operands
access name
Specify the access name of the file statement specifying the file to send. If an access name that is not described in JCL is specified, an error occurs and the job is terminated.
file(send destination file name)
Specify the destination file name with a full path. If this operand is specified, a file is created with the specified name, and after the job execution is completed, the file won't be deleted.
If this operand is omitted, the file is sent as a temporary file, and the access from the job is handled normally (the temporary file name is set in the access name and environment variable). When the job execution is completed, the temporary file is deleted.
Examples
[Windows]
In the following example, the file specified in the file statement in which access name "data1" is defined is sent to "d:\userinfo\data1" specified in the file operand.
send data1,file(d:\userinfo\data1)
[UNIX]
In the following example, the file specified in the file statement in which access name "data1" is defined is sent to "/userinfo/data1" specified in the file operand.
send data1,file(/userinfo/data1)
Synopsis
receive access name [,file(receive source file name) ]
Description
This command receives the file specified with the connect command from another server on the local server where the job was submitted.
Operands
access name
Specify the access name of the file statement that specifies the file to be received. If an access name that is not described in JCL is specified, an error occurs and the job is terminated.
file(receive source file name)
Specify the file name of a file that exists on the host connected with the connect command with full path. The specified file will be received.
If this operand is omitted, the file corresponding to the access name will be received.
Examples
[Windows]
The following example receives a file specified in the file statement in which access name "list1" is defined from "d:\userinfo\list1" specified in the file operand.
receive list1,file(d:\userinfo\list1)
[UNIX]
The following example receives a file specified in the file statement in which access name "list1" is defined from "/userinfo/list1" specified in the file operand.
receive list1,file(/userinfo/list1)
Synopsis
execute (execution file name execution option) [,queue(queue name)]
Description
This command executes jobs on another server specified by the connect command, according to the specifications in the operands.
Operands
execution file name execution option
Specify the execution file name and execution options to be carried out on another server.
Specifying the qsub command as the job file name, a free format network job can be requested. Note that at least one space must be placed between the execution file name and the execution options.
queue(queue name)
Specify on which queue the job requested to another server will be executed.
If this operand is omitted, the queue is determined as follows:
The queue that has the name identical to the execution queue of the submission source job (queue name specified at submission or default name).
If a queue of the same name does not exist, the queue that has the name defined in "Specify default queue to submit jobs to" (dfltqueue operand of the system parameter) in the [Define Operating Information] window.
The job submission fails if "Specify default queue to submit jobs to" (dfltqueue operand in the system parameter) is not selected in the [Define Operating Information] window.
Example
The following example executes application "appl1.exe" on queue "queue1."
execute (appl1.exe),queue(queue1)
Synopsis
disconnect
Description
This command disconnects another server that has been connected with the connect command.
This command can be omitted. If omitted, the other server is automatically disconnected at the end of the job step or when the next connect command is executed.
Note that if the disconnect command is executed when there is no connection, the command is ignored and processing continues.
This command has no operands.