| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Restore System/36 Library Members (RSTS36LIBM) command reads a file containing library members, creates database source or data file members on this system, and copies the member data from the file into each restored member.
The input file can be a diskette file, tape file, or database physical file on this system.
The file could have been created on a System/36, a System/34, or a System/32 using either the FROMLIBR or SAVELIBR system operator control language (OCL) procedure (or the equivalent use of $MAINT), or by using the Save System/36 Library Members (SAVS36LIBM) command.
Diskette files created on a System/34 using the BACKUP procedure or $BACK utility are not accepted by this command. Compressed SAVELIBR diskette files (used by IBM to distribute system libraries for System/36 after release 5.0) are not accepted by this command.
In System/36 terms, the input file format could be a SAVELIBR diskette file or tape file, a record-mode LIBRFILE diskette file, tape file, or physical file, or a sector-mode LIBRFILE diskette file, tape file, or physical file. In other words, the input file can be any diskette file, tape file, or physical file created by the System/36 $MAINT SSP utility.
If the library identified by the value specified for the To library prompt (TOLIB parameter) does not exist, it is created. Also, the source files QS36SRC and QS36PRC are created if they do not exist in the restore-to library. If the restore operation creates the library, the new library is owned by the user running the RSTS36LIBM command and the library is created with a default authority of *ALL (that is, the same as AUT(*ALL)).
If a sector-mode FROMLIBR file or a SAVELIBR file created on a System/36 is being restored, data files QS36LOD and QS36SBR may also be created to hold restored load and subroutine members. Restored load and subroutine members are not converted on the current system.
Restrictions:
If a generic member name or *ALL is specified, a member may be selected to be restored that has a name containing characters not allowed in an AS/400 system simple object name. In this case, the member name is restored using the AS/400 system extended name syntax (for example, A!B would become ''A!B'').
If the name contains a blank, a single quotation mark (') a double quotation mark ("), an asterisk (*), a question mark (?), or a device control character (hexadecimal '00'-'3F' or hexadecimal 'FF'), these characters are replaced by underlines and the member is restored using the resulting simple or extended name (for example, A*/? would become A_/_ and A? would become A_).
An informational message is sent each time invalid characters are replaced to get a valid name. An additional informational message is sent if the resulting name change caused a member to be replaced. No message is sent if a member is restored using the extended name syntax without replacing invalid characters.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TOMBR | To member | Generic name, name, *ALL | Required, Positional 1 |
| TOLIB | To library | Name | Required, Positional 2 |
| DEV | Device | Single values: *PHYFILE Other values (up to 4 repetitions): Name |
Required, Positional 3 |
| SRCMBRS | S/36 source members | *ALL, *SRC, *PRC, *NONE | Optional |
| MBROPT | Data base member option | *NEW, *OLD, *ALL | Optional |
| IGCDTA | User specified DBCS data | *NO, *YES | Optional |
| FROMLABEL | File label | Character value | Optional |
| CRTDATE | Creation date | Date, *NONE | Optional |
| SEQNBR | Sequence number | 1-9999, *SEARCH | Optional |
| VOL | Volume identifier | Values (up to 50 repetitions): Character value, *MOUNTED | Optional |
| ENDOPT | End of tape option | *REWIND, *LEAVE, *UNLOAD | Optional |
| PHYFILE | Physical file | Qualified object name | Optional |
| Qualifier 1: Physical file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OBJMBRS | S/36 object members | *NONE, *SBR, *LOD, *ALL | Optional |
| Top |
Specifies the names of the members to restore.
This is a required parameter.
| Top |
Specifies the library to contain the members to restore from the input file.
This is a required parameter.
| Top |
Specifies the names of the devices to use for the restore operation. A maximum of four device names may be specified.
This is a required parameter.
| Top |
Specifies which source member types (source and procedure members on System/36) are restored.
| Top |
Specifies, for database files currently on the system, which file members are restored.
| Top |
Specifies whether the source and procedure members being restored can contain double-byte character set (DBCS) data. This attribute is used if the restore operation needs to create source files QS36SRC and QS36PRC to hold the restored library members.
Note: If the QS36SRC or QS36PRC source file already exists in the library specified on the To library prompt (TOLIB parameter) and the file's DBCS capability does not match this parameter, an error message is sent and no members are restored.
| Top |
Specifies the label value (eight characters maximum) of the diskette or tape file that contains the members to be restored. If *PHYFILE is not specified for the Device prompt (DEV parameter), a value must be specified here.
| Top |
Specifies the creation date of the diskette file or tape file used for the restore operation. The specified date is changed to Julian format (cyyddd) for tape or international format (yymmdd) for diskette.
| Top |
Specifies, when tape is used, which sequence number is used for the restore operation.
| Top |
Specifies the volume identifiers of the tapes or diskettes used for restoring the file.
| Top |
Specifies, only when tape is used, what positioning operation is automatically performed on the tape volume after the restore operation ends. This parameter applies only to the last reel used.
| Top |
Specifies the name of the database physical file that is used as the input file for the restore operation. If the specified file does not exist or is not a physical file, no library members are restored. If the file contains multiple members, the first member of the file is used.
The possible library values are:
| Top |
Specifies which object member types (load and subroutine members on System/36) are restored. Because the System/36 and the AS/400 system are not object compatible, any restored members are not immediately useable after the restore operation. IBM-supplied commands or user-written operations must be run to convert the object member to a useable AS/400 system object.
| Top |
Example 1: Restoring All Members
RSTS36LIBM TOMBR(XYZ1) TOLIB(JOHNSON) DEV(I1)
SRCMBRS(*PRC) MBROPT(*ALL) FROMLABEL('XYZ1')
This command restores the single OCL procedure member XYZ1 as a member of source file QS36PRC in library JOHNSON. Assuming I1 refers to a diskette device, the input diskette file must have the label XYZ1.
Example 2: Restoring Members from a File
RSTS36LIBM TOMBR(X*) TOLIB(ORDER) DEV(*PHYFILE)
PHYFILE(NETLIB/S36SRC)
This command restores all source and procedure members with names starting with the character 'X' and that do not already exist as members of QS36SRC and QS36PRC in library ORDER. The members are restored from file S36SRC in library NETLIB.
| Top |
*ESCAPE Messages
*STATUS Messages
| Top |