jprprint (Windows)

Syntax

jprprint
     job-operation-information-file-name
     format-definition-file-name
     [-p|-c output-CSV-file-name [-u]]
     [-r release-ID]

To Page Top

Description

The jprprint command outputs the contents of a job operation information file to a printer in the format defined in a format definition file. The command outputs the information to the default printer.

The jprprint command displays a window when it creates a document. For this reason, you must be logged in to Windows to use this command.

Specify the job operation information file (.aoi) and format definition file (.jof) by full path. You cannot specify a relative path.

If you specify an output CSV file name (.csv), the jprprint command outputs the information to the specified file in CSV format. In this case, the document is not output to the printer. Specify the name of the CSV file by full path.

Example of command specification:

To print the job operation information file C:\Input\SAMP.aoi as defined in the format definition file C:\Format\unit.jof, execute the command as follows:

jprprint  c:\Input\SAMP.aoi c:\Format\unit.jof

To Page Top

Command directory

installation-directory

To Page Top

Options and arguments

job-operation-information-file-name

Specify the name of the job operation information file whose information you want to output.

Specify the file name by full path (including the extension .aoi).

Make sure that the path and file name of the file do not exceed 258 bytes in total, the path does not exceed 194 bytes, and the file name does not exceed 63 bytes.

format-definition-file-name

Specify the name of the format definition file that contains the formats for the job operation information you want to output.

Specify the file name by full path (including the extension .jof).

Make sure that the path and file name do not exceed 258 bytes in total, the path does not exceed 194 bytes, and the file name does not exceed 63 bytes.

The format definition file is located in the folder specified in the Format definition field in the Environment Settings window.

You can create format definition files in the Format Definition Settings window.

-p

Specify this option to output the job operation information to the default printer.

-c output-CSV-file-name

When you want to output job operation information to a CSV file, specify the -c option and the name of the CSV file to which to output the information.

Specify the file name by full path (including the extension .csv).

Make sure that the path and file name of the file do not exceed 258 bytes in total, and the path does not exceed 194 bytes. The file names of files whose path and file name exceed 258 bytes in total are converted automatically when the file is saved. For details on the rules governing automatic file name conversion, see 7.10 Save CSV File window.

Do not use any of the following characters in a file name:

\ / : * ? " < > |

If you specify this operand, the document is not output to the printer.

The contents of the CSV file differ depending on whether the Outputs CRLFs to CSV file check box is selected in the Environment Settings window.

-u

You can specify this option when -c output-CSV-file-name is specified.

This option dictates how the command behaves when the file specified in output-CSV-file-name already exists.

If you specify this option, the file is overwritten if it already exists. If you omit this option, the command terminates abnormally if the file already exists.

-r

If the specified job operation information file contains release ID information, specify the release ID of the jobnet whose information you want to output.

If you do not specify a release ID, the command outputs jobnet information for one of the release IDs in the file. For details on release IDs, see the manual Job Management Partner 1/Automatic Job Management System 3 Overview.

Cautionary notes:

• The jprprint command executes its processing in the user session space. You can use JP1/AJS of another scheduler program to automate the process by executing the jprprint command in the user session space.

• In Windows 8.1, Windows Server 2012, Windows 8, Windows 7, Windows Server 2008, or Windows Vista, if you specify a protected folder such as C:\Program Files as the output destination for a CSV file, the file might not be output to the location you intended.

Return values

0	Normal termination
4	Terminated with warning (there is no information to output or the input file includes unsupported units)
Other	Abnormal termination

Memory used by jprprint command

You can use the following equation to determine how much memory the jprprint command will use.

Keep in mind that a certain amount of leeway is built into this equation.

Many of the factors governing memory usage depend on individual user settings. These include the length of unit names, the depth of the hierarchy, the amount of unit attribute data, and the number of schedule rules. For this reason, the result of the equation does not always reflect actual memory usage.

Equation:

4 MB + (Memory needed to load job operation information file) x 3.5 bytes

• Memory needed to load job operation information file:

  = All units + Format

• All units:

  = 20 bytes + 4 bytes x Total number of units + (1 unit) x Total number of units

• 1 unit:

  = 28 bytes + (48 bytes + average data of unit attributes x number of days of daily data collected) x number of attributes collected by ajsshow command + (48 bytes + average data of unit attributes) x number of attributes collected by ajsprint command + (number of attributes collected by ajsshow command + number of attributes collected by ajsprint command) x 8 bytes

• Format

  = 61 bytes x 4 bytes + 12 bytes x number of columns selected

To Page Top