LOAD

Batch Processing › SARBCH Control Statements › LOAD

LOAD

The LOAD control statement loads an archived SYSOUT group from tape to disk. The SYSOUT is either temporarily loaded to the CA View database or loaded to a user-defined data set.

If you use the expanded access server for tape and robotics, and the server becomes inactive when a report is selected online, CA View LOADs the report to disk. The report can then viewed without the server.

We recommend that LOAD jobs execute on the system with the TYPE=PRIMARY server. This method prevents all the data from having to be transmitted across systems using XCF or LSERV.

Note: For more information about the expanded access server, see the section Expanded Access Server for Tape and Robotics in the chapter "Configuring."

The following table indicates the destination of the SYSOUT group:

If the DDname parameter is	And if a SARLOAD DD statement is	Then the Product
Specified	Specified or not specified	Loads the SYSOUT group to the data set named with the ddname.
Not specified	Specified	Loads the SYSOUT group to the SARLOAD data set.
Not specified	Not specified	Temporarily loads the SYSOUT group to the CA View database, and you can view it online. The SYSOUT is automatically be deleted by the backup cycle using the HOLDTEMP initialization parameter.

Syntax:

The syntax of the control statement is:

/LOAD  DDNAME=xxxxxxxx

GEN=nnnnn
ID=id
RESOURCE=xxx
INDEX
SEQ=nnnnn
TAPE

where:

DDNAME= xxxxxxxx

Specifies the DD statement name to which the SYSOUT group is loaded.

This parameter overrides the SARLOAD DD statement, if it is specified. If DCB attributes for the DD statement are omitted, the following are used:

A record format of VBM
A record size of the SYSOUT group record size plus four
A block size of 32760

GEN=nnnnn

Specifies the absolute or relative number of the generation for which SYSOUT is loaded to disk.

If omitted, the most recently archived SYSOUT group for the ID loaded to disk.

ID=id

Specifies the SYSOUT identifier on the SYSOUT or the resource group to be loaded.

This value can be 1 to 32 characters. This parameter is required.

The SARTDR utility can also be used to reload an AFP resource to DISK.

Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".

INDEX

Specifies to LOAD any page indexes defined for the report to the disk database.

Page indexes on disk are used by the CA View online cross report indexing capability. (The DDname parameter does not apply to page indexes.)

RESOURCE=

Specifies the name of an AFP RESOURCE rather than a Report ID.

Do not specify ID= when using the RESOURCE parameter.

This parameter allows an AFP resource to be deleted. This type of control statement is generated through SARTSLST.

SEQ=nnnnn

Specifies the absolute or relative sequence number of the SYSOUT group to be loaded to disk.

If omitted, the most recently archived group for the ID and generation specified is loaded to disk.
If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.

EX: SEQ=-1: The second most recently archived SYSOUT is processed regardless of its generation and sequence number.
EX: SEQ=-2: The third most recently archived SYSOUT is processed regardless of its generation and sequence number.

TAPE

Specifies to LOAD only from tape.

This parameter can be used to bypass LOADing from optical disk.