The Load and Run Media Program (LODRUN) command restores a user-written program object from tape, diskette, or optical device into the library QTEMP. The system passes the device name to the restored program and transfers control to the restored program.

When the LODRUN command is run:

1. The media is searched for the user-written program, which must be named QINSTAPP and saved from library QTEMP.

   Note: The program QINSTAPP must be owned by a user profile that resides on the target system. If QINSTAPP is restored to a system that does not have the owning user profile, control is not transferred and the program is not run.

2. If a QINSTAPP program already exists in the QTEMP library on the user's system, it is deleted.
3. The QINSTAPP program is restored to the QTEMP library using the RSTOBJ command. The following values are specified on the RSTOBJ command:
   • OBJ(QINSTAPP)
   • OBJTYPE(*PGM)
   • SAVLIB(QTEMP)
   • ENDOPT(*LEAVE)
   • MBROPT(*ALL)
   • ALWOBJDIF(*NONE)
   • RSTLIB(QTEMP)
   • VOL(*MOUNTED)

   If the device is an optical device, the ENDOPT and the VOL parameters are not specified.

   If the device is optical, then the value specified for the DIR for this command is used for the OPTFILE parameter for the Restore Object (RSTOBJ) command.

   The SEQNBR parameter is specified according to the SEQNBR parameter on the LODRUN command.

   The device used for the restore operation is determined by the LODRUN command. If *TAP, *DKT, or *OPT are specified on the DEV parameter, the LODRUN command examines the QDEVNAMING system value to determine if the system uses iSeries or System/36 naming conventions for devices:

   • If QDEVNAMING is *NORMAL (iSeries convention)
     • The device TAP01 is used for DEV(*TAP).
     • The device DKT01 is used for DEV(*DKT).
     • The device OPT01 is used for DEV(*OPT).
   • If QDEVNAMING is *S36 (System/36 convention)
     • The device TC is used for DEV(*TAP) if a tape cartridge is found. Otherwise, device T1 is used.
     • The device I1 is used for DEV(*DKT).
     • The device OPT01 is used for DEV(*OPT). System/36 naming conventions do not apply to optical devices.

   Any other value specified on the DEV parameter is used as is.

4. Control of the system is passed to the QINSTAPP program. The QINSTAPP program can be used, for example, to restore other applications to the user's system and run those applications.
5. When the user signs off, the QINSTAPP program is removed from the system.
6. The settings of three system values work together to determine if the QINSTAPP program is allowed to be restored or if it is converted during the restore. The three system values are:
   • QVFYOBJRST Verify object restore
   • QFRCCVNRST Force conversion on restore
   • QALWOBJRST Allow object restore option

   The LODRUN command does not transfer control to the QINSTAPP program if these values do not allow the restore and conversion of the QINSTAPP program.

The user supplying the QINSTAPP program is responsible for writing and supporting it. The QINSTAPP program is not supplied by IBM. The program can be designed to accomplish many different tasks. For example, the program could:

• Restore and run other programs or applications
• Restore a library
• Delete another program or application
• Create specific environments
• Apply fixes to existing applications

The QINSTAPP program is run only once each time the LODRUN command is entered. The LODRUN command passes only one parameter (DEV), which specifies the device from which the QINSTAPP program is restored. The QINSTAPP program should not attempt to use the LODRUN command again. This will have unpredictable results.

In addition to writing the QINSTAPP program, the user suppling the program is responsible for providing the user with the media containing the program. To distribute the program on a tape, diskette, or optical device, do the following:

1. Prepare the tape or diskette. For tape, use the Initialize Tape (INZTAP) command. For diskette, use the Initialize Diskette (INZDKT) command with FMT(*SAVRST) specified.
2. Use the Create Duplicate Object (CRTDUPOBJ) command to create the QINSTAPP program into the QTEMP library.
3. Use the Save Object (SAVOBJ) command to save the QINSTAPP program from QTEMP to the desired tape device or diskette unit. The program must be the only object in the media file that contains it. Specify the following:
   • LIB(QTEMP)
   • LABEL(*LIB)
   • CLEAR(*ALL)

   Specifying LABEL(*LIB) ensures that the label will be QTEMP. If the QINSTAPP program is being saved to a tape device, and if additional applications, programs, or libraries will be saved to tape, ENDOPT(*LEAVE) also must be specified. The correct value for the TGTRLS parameter must also be entered if the target release is not the default, *CURRENT.

4. Use the Save Object (SAVOBJ), Save Library (SAVLIB), or Save License Program (SAVLICPGM) command to save any other necessary applications, programs, or libraries to the tape or diskette. This step is optional and is used to save applications that the QINSTAPP program restores to the user's system when the LODRUN command is run.

   If the QINSTAPP program is saved to tape, the tape is not rewound after the QINSTAPP program is restored; the application or series of applications that the QINSTAPP program restores to the user's system should be next on the tape.

Restriction: The QINSTAPP program that is loaded from the media and called may require specific authority in order to run correctly. The user supplying the QINSTAPP program should inform you if any specific authorities are required.

Parameters

Keyword	Description	Choices	Notes
DEV	Device	Name, *TAP, *DKT, *OPT	Optional, Positional 1
SEQNBR	Sequence number	Decimal number, *FIRST, *SEARCH	Optional
VOL	Volume identifier	Character value, *MOUNTED, *SAVVOL	Optional
DIR	Directory	Character value, '/'	Optional

Top

Device (DEV)

Specifies the I/O device from which the program is loaded.

This is a required parameter.

The possible values are:

*TAP

The program is loaded from the default tape device connected to the system.

*DKT

The program is loaded from the default diskette device connected to the system.

*OPT

The program is loaded from the default optical device connected to the system.

tape-device

Specify the name of the tape device from which the program is loaded onto the system.

diskette-device

Specify the name of the diskette device from which the program is loaded onto the system.

Optical-device

Specify the name of the optical device from which the program is loaded onto the system.

Sequence number (SEQNBR)

Specifies, only when tape is used, the sequence number used for the restore operation.

The possible values are:

*FIRST

The volume on a tape device is searched starting from the first data file for a data file with an identifier that is a match for the QTEMP label. When the first match is found, the object is restored.

*SEARCH

The volume on a tape device is searched starting from the first data file beyond the current tape position for a data file with an identifier that is a match for the QTEMP label. When a match is found, the object is restored.

sequence-number

Specify the sequence number of the file. Valid values range from 1 through 16777215.

Volume identifier (VOL)

Specifies, only when tape is used, the volume identifier for the tape devices.

The possible values are:

*MOUNTED

The volume currently mounted on the tape device is used.

volume-identifier

Specify the volume identifier mounted on the tape device.

Directory (DIR)

Specifies, only when an optical device is used, the directory used for the restore operation. If the file named QTEMP.;1 is found in the specified directory, the object is restored.

The possible values are:

'/'

The root directory (/) is used.

directory-name

Specify the directory to search for a file named QTEMP.

Examples

Example 1: Restoring a Program from Tape

LODRUN   DEV(TAP01)

This command restores the program object from the tape on device TAP01 to the library QTEMP. Control is then transferred to the restored program.

Example 2: Restoring the Program QINSTAPP from Tape

LODRUN   DEV(TAP01)  SEQNBR(5)

This command restores the program object QINSTAPP from the tape at sequence number 5 on device TAP01 to the library QTEMP. Control is then transferred to the restored program. If the sequence number is not found, an escape message is sent. If the file label at that sequence number is not QTEMP, an escape message is sent.

Example 3: Restoring the Program QINSTAPP from CD-ROM

LODRUN   DEV(*OPT)  DIR('/APP1/INST')

This command restores the program object QINSTAPP from the CD-ROM on device OPT01 to the library QTEMP. The filename for the QTEMP library on the CD-ROM is /APP1/INST/QTEMP. Control is then transferred to the restored program. If the file is not found, an escape message is sent.

Error messages

None