Parameters

-a application

The name of the application to load. If the application group contains more than one application, then you must identify the application to load. Otherwise, the load fails. If you plan to automate the loading of files into different application groups and applications, then use the -A parameter to specify the part of the file name that identifies the name of the application.

-A applID

Determines the part of the file name that identifies the application to load. If the application group contains more than one application, then you must identify the application to load; otherwise, the load fails.

You typically use this parameter when you run the ARSLOAD program as a monitor to automate the loading of files into different application groups and applications. For example, a file that is transmitted from a z/OS® system might use the following file naming convention:

MVS.JOBNAME.DATASET.FORMS.YYYYDDD.HHMMSST.ARD

Important: The .ARD file name extension is required to initiate a load process.

Unless you specify otherwise, the ARSLOAD program uses the FORMS part of the file name to identify the application group to load. You can use the -g parameter to specify a different part of the file name that identifies the application group (MVS, JOBNAME, or DATASET). For example, arsload -G JOBNAME.
If the application group to load contains more than one application (source of data), then you must identify the application to load; otherwise, the load fails. When you run the ARSLOAD program, you can use the -A parameter to specify the part of the file name that identifies the application (MVS, JOBNAME, DATASET, or FORMS). For example, to use the DATASET part of the file name to identify the application, run the ARSLOAD program with the -A DATASET parameter.

-b <index #,field_name>

Specify the name of an index field and a number that identifies the part of the input file name that the ARSLOAD programs assigns to that index field. For index_number, you can specify 1 - 8 and the number must match a part of the input file name that is identified by the -B parameter.

In the following example, assume that the input file name is ApplGroup1.App1.ARD:

arsload -b "1,field1" -B "AG.1APP.ARD" -g ApplGroup1 ...

During the load, the ARSLOAD program assigns the value App1 from the input file name to the index field "field1" of application group "ApplGroup1".

-B "format"

Use this parameter to do the following tasks:

Define the file name formats for MVS download files and files that are processed by the ARSLOAD daemon.
Identify the parts of the file name that the ARSLOAD program assigns to an index field specified by the -b parameter.

Use the following identifiers to define the file name format:

1 - 8: A number prefixed to a part of the file name that identifies that part as a value to assign to an index field.
AG: Application group name
APP: Application name
DAT: Abbreviation for DATASET
EXT: Extension
FLD: Field place holder for indexing
FOR: Abbreviation for FORMS
HH: Abbreviation for HHMMM
IGN: Ignore
JOB: Abbreviation for JOBNAME
MVS: MVS
WRI: Abbreviation for WRITER
YY: Abbreviation for YYDDD

The following example uses the full word of the JOB, DAT, FOR, YY, and HH identifiers to define the file name format:

MVS.JOBNAME.DATASET.FORMS.YYDDD.HHMMM.ARD

The following example shows the same file name format with the abbreviated words:

MVS.JOB.DAT.FOR.YY.HH.EXT

The following example shows the same file name format and indicates that the ARSLOAD program assigns the JOB part of file name to index field 1:

MVS.1JOB.DAT.FOR.YY.HH.EXT

The following examples show different ways that you can define the file name formats:

ARSLOAD -G FORMS -D “-“ -B “WRItER-MVS-IGN-IGN-FORms”
ARSLOAD -G JOBNAME -B “WRITER.IGN.JOB.IGN.DAT.IGN.EXT”
ARSLOAD -D “-“ -B “IGN-IGN-AG-APP-IGN.EXT”
ARSLOAD -B “APP.IGN.AG.IGN.IGN”

The following examples show how to identify the parts of the file name to assigns to an index field:

Single index format, where the ARSLOAD daemon assigns the DAT part of the file name to index field account_num:
```
arsload -b “1,account_num” -B “AG.APP.1DAT”
```

Multiple index format, where the ARSLOAD daemon assigns the different parts of the file name to different index fields:

arsload -b “1,report_name” -b "2,run_date" -b "3,app_name" -B “AG.3APP.1FLD.2YY”

The following table maps the index field name to the part of the file name:

Index field name	Part of the file name
report_name	FLD
run_date	YY
app_name	APP

You can use the -B parameter or combine the -g and -a parameters, but you cannot use all three of them together. If you specify the -B parameter, you identify the application group name and the application name as parts of the file name.

-c indexDir

The file system in which IBM® Content Manager OnDemand temporarily stores data that is created by the indexing program. The default location is the directory from which the ARSLOAD program was started.

-d dataDir

The directory that contains input files to process.

Any file with a file type extension of .ARD or .PDF is processed (.ARD files are transmitted to the server by a z/OS download utility; .PDF files are created by Acrobat Distiller). The case of the file type extension is not significant.

You can specify this parameter one or more times. The ARSLOAD program searches for input files to load in each of the directories that you specify.

To specify more than one directory, specify the -d parameter multiple times. In the following example:

arsload ... -d dir1 -d dir2 -d dir3...

the ARSLOAD program searches for input files in the dir1, dir2, and dir3 directories.

You cannot specify the -i, -n, or -v parameters when you specify the -d parameter.

-e

Specify this parameter to allow the ARSLOAD program to process loads that contain empty document files. If you specify the -n parameter with the -e parameter, the empty file is retained after processing, however no data is loaded into Content Manager OnDemand. If you are running the ARSLOAD program as a daemon with the -e parameter, the empty file will not cause an error and the ARSLOAD daemon will not exit.

-f

Use to unload the data if the load process fails. If the database manager step fails, then Content Manager OnDemand should remove any index data that was added to the database. If the storage manager step fails, then Content Manager OnDemand should remove any storage objects that were copied to storage volumes.

Important: If an input file fails to load, you should review the message log that was created during the load process. You can retrieve a message log from the system log. If the message log contains a Load ID, then it means that for some reason, Content Manager OnDemand stored at least some of the input data in the application group. Before you attempt to reload the input data, you must remove the data that was created during the failed load process by using the RMVRPTOND command.

See Deleting a report for help with removing the data that is created when a file is loaded into the system.

-F Trace output format

Optional parameter when tracing is specified. The default output is text format. The possible values are C, T, and X:

C or CSV: The CSV format is a comma-separated file that is useful in spreadsheets.
T or TEXT: Default output format.
X or XML: The XML format outputs XML structured data. Using the XML output requires a header and trailer to be added to the trace file to complete the XML syntax and create valid XML. After the XML structured data is combined with .XSL and .DTD files, it can be viewed in a browser or XML editor.

-g applGroup

The name of the application group to load. This parameter is required if you specify a load file name to process. This parameter is optional if you specify the -d parameter. However, if you specify the -d parameter, unless you specify otherwise, the ARSLOAD program uses the FORMS part of the file name to determine the name of the application group to load. If you plan to automate the loading of files into different application groups and applications, then you should use the -g parameter to specify the part of the file name that identifies the application group to load.

-G applGroupID

Determines the part of the file name that the ARSLOAD program uses to identify the name of the application group to load.

You typically use this parameter when you run the ARSLOAD program as a monitor to automate the loading of files into different application groups and applications. For example, a file that is transmitted from an OS/390® or z/OS download utility might use the following file naming convention:

MVS.JOBNAME.DATASET.FORMS.YYYYDDD.HHMMSST.ARD

Important: The .ARD file name extension is required to initiate a load process.

Unless you specify otherwise, the ARSLOAD program uses the FORMS part of the file name to identify the application group to load. You can use the -g parameter to specify a different part of the file name that identifies the application group (MVS, JOBNAME, or DATASET). For example, arsload -G JOBNAME.
If the application group to load contains more than one application (source of data), then you must identify the application to load; otherwise, the load fails. When you run the ARSLOAD program, you can use the -A parameter to specify the part of the file name that identifies the application (MVS, JOBNAME, DATASET, or FORMS). For example, to use the DATASET part of the file name to identify the application, run the ARSLOAD program with the -A DATASET parameter.

-h instance

The name of the Content Manager OnDemand instance to process. This is a required parameter.

Important: If you run multiple instances of Content Manager OnDemand, always specify the -h or -I parameter to identify the name of the instance that you want to process. See IBM Content Manager OnDemand for i: Planning and Installation Guide for information on configuring instances.

Tip: The ARSLOAD program also supports the -I parameter. You can use either parameter to specify the name of the instance to process. If you specify both, the value of the last parameter specified is used.

-i

Use to run the data indexing program only; do not copy report data to storage volumes or add the index data to the database.

-I instance

The name of the Content Manager OnDemand instance to process. By default, the QUSROND instance is used. You can use an instance other than QUSROND as your default by defining the QDFTINST data area as described in Using Content Manager OnDemand data areas. You must specify the -h or -I parameter and name the instance if you are running more than one instance on the same IBM i system and you want to process an instance other than the default instance.

Tip: The ARSLOAD program also supports the -h parameter. You can use either parameter to specify the name of the instance to process. If you specify both, the value of the last parameter that is specified is used.

-j parmFile

Use to specify the name of a parameter file that contains additional indexing parameters.

When you specify the -j parameter and name a parameter file, the ARSLOAD program adds the indexing parameters from the specified parameter file to the indexing parameters that it extracts from the application. (Indexing parameters are typically specified on the Indexing Information page in the application definition.) If an indexing parameter appears in both the application and the parameter file that you specify, unexpected results might occur.

-J File name delimiter

Use this parameter to define file name formats for MVS download files and files that are processed by the ARSLOAD daemon. By default, this parameter is "."

-l fieldID

Indicates that the entire name of the input file should be captured and placed into the field identifier specified.

-n

Determines whether Content Manager OnDemand deletes the input files when the ARSLOAD program terminates.

If you specify the -n parameter, then Content Manager OnDemand does not delete the input files when the ARSLOAD program ends.
If you do not specify the -n parameter, then Content Manager OnDemand deletes the input files when the ARSLOAD program ends.

In either case, if the ARSLOAD program fails in the load step because of a device or system problem, then you can restart the load step after you correct the problem by using the intermediate files that were created by the ARSLOAD program. The ARSLOAD program stores the intermediate files in the directory that is named with the -c parameter (or the directory from which you started the ARSLOAD program, if you did not specify the -c parameter). The intermediate files have the same file name as the original input file.

-p password

The password for the user that is specified with the -u parameter. If the user is not assigned a password, enter a null password (that is, specify -p "").

-t seconds

Determines the polling time in seconds. This is the interval of time in which the ARSLOAD program checks the input directory (specified by the -d parameter) for input files to process. The default value is 600 seconds, which means that the ARSLOAD program checks the input directory every 10 minutes.

-u userid

The user ID of a Content Manager OnDemand user with administrator authority for the application group. The user must have permission to add documents to the application group.

-v

Enables verbose mode, which displays all messages (informational and error). By default, the ARSLOAD program displays error messages.

-X indexer

Allows you to override the indexing program that was specified on the Indexer Information page for the application. The possible values are 4, G, P, and X:

Specify -X 4 to use the 400 Indexer.
Specify -X G to use the Content Manager OnDemand Generic Indexer.
Specify -X P to use the Content Manager OnDemand PDF Indexer.
Specify -X X to use the Content Manager OnDemand XML Indexer.

You must specify an indexing program if the input contains index data in a format other than the one supported by the indexing program that was specified for the application. For example, assume that you defined an application and specified 400 Indexer as the indexing program. Later, you used the ARSDOC program to extract documents from an application group. The ARSDOC program generates index data that is in the Generic indexer format. To load the index data into the application, you must specify:

arsload -X G . . .

loadFilename

Specifies an input file to process.

You can specify the names of one or more input files to process. If you specify more than one input file, separate the file names with a blank character.

The ARSLOAD program concatenates the following file type extensions to the file name that you specify: .IND, .OUT, .RES, .ANN, and .ANG.

The .IND file contains the index data
The .OUT file contains the report data
The .RES file contains the resource data
The .ANN file contains text annotations
The .ANG file contains graphic annotations

For example, if you specify arsload -g BILLS po3510, the ARSLOAD program looks for and processes the following files:

po3510.ind
po3510.out
po3510.res
po3510.ann
po3510.ang

If the ARSLOAD program does not find a file with the IND file type extension, it automatically calls the indexing program to process the input file.

If you omit an input file name, the ARSLOAD program runs in daemon mode and attempts to load input data from the directories that are specified by the -d parameter. If you omit an input file name and do not specify the daemon mode parameter (-d), the ARSLOAD program issues a usage note and exits.

-1 trace_file

Specify a fully qualified trace file name as directed by IBM Software Support.

-2 level

Specify a value as directed by IBM Software Support.