CL Command Reference - CFGDEVMLB
CL Command List > CFGDEVMLB Reference
Description:
The Configure Device Media Library (CFGDEVMLB) command connects the media library device description with the communication interface for media library devices that require a communication interface. The CFGDEVMLB command will configure the necessary communication information based on the input to the command, will update the necessary information in the device description specified, and will attempt to vary on the media library device description.
For a LAN-attached media library device, the information on the Library Manager console must also be updated. To determine the necessary information for the Library Manager, use the Display LAN Media Library (DSPLANMLB) command.
This command must be issued once for each media library device description that uses a communication interface.
User *PUBLIC will be given *USE authority to any objects that this command creates: controller, device, and so on. The objects that the CFGDEVMLB command creates will be named the same as the resource name specified on the command for ADPTTYPE(*RS232) and same as the remote location name for ADPTTYPE(*LAN). The owner of the objects will be the user profile of the user executing the command.
Restrictions
. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
. You must have use (*USE) authority for the following CL commands: CRTDEVAPPC, CRTCTLAPPC, CRTDEVASC, CRTCTLASC, CRTLINASC, CHGDEVMLB, and VRYCFG.
Examples:
Example 1: Configuring a RS232-attached Media Library Device
CFGDEVMLB MLB(TAPLIB01) ADPTTYPE(*RS232) RSRCNAME(CMN01)
This command will create the necessary RS-232 communication line, controller, and device and change the necessary parameters in the media library device description. It will also attempt to vary on the media library device. The command does this in the following order:
. Create Line Description (Async) - CRTLINASC CMN01 with a resource name of CMN01.
. Create Controller Description (Async) - CRTCTLASC CMN01.
. Create Device Description (Async) - CRTDEVASC CMN01.
. Change Device Description - CHGDEVMLB TAPLIB01 to change the parameter robot device to ROBOTDEV(CMN01) and to change the parameter online at IPL to ONLINE(*YES).
. Vary Configuration - VRYCFG TAPLIB01 to vary on the media library device
If any of these commands is not successful, the CFGDEVMLB command will not be successful. Note that multiple media library device descriptions could have the same communication line. In this case, the line description, controller, and device will not be recreated, but the CHGDEVMLB and VRYCFG commands will still be used.
Example 2: Configuring a LAN-attached Media Library Device
CFGDEVMLB DEV(TAPLIB02) ADPTTYPE(*LAN) LIND(TRNLINE)
RMTLOCNAME(APPN.MLD01) ADPTADR(0123456789AB)
This command will create the necessary LAN communication controller and device and change the necessary parameters in the media library device description. It will also attempt to vary on the media library device. Note that the line description must exist prior to using the CFGDEVMLB command. The command does this in the following order:
. Create Controller Description (APPC) - CRTCTLAPPC MLD01 with ONLINE(*YES).
. Create Device Description (APPC) - CRTDEVAPPC MLD01.
. Vary Configuration - VRYCFG MLD01 to vary on MLD01 APPC controller that was created.
. Change Device Description - CHGDEVMLB TAPLIB02 to change the parameter robot device to ROBOTDEV(MLD01) and to change the parameter online at IPL to ONLINE(*YES).
. Vary Configuration -VRYCFG TAPLIB02 to vary on the media library device.
If any of these commands is not successful, the CFGDEVMLB command will not be successful. Note that multiple media library device descriptions could have the same communication line. In this case, the controller description, and device will not be recreated, but the CHGDEVMLB and VRYCFG commands will still be used
Example 3: Configuring a LAN-attached Media Library Device with Two Remote Locations
CFGDEVMLB DEV(TAPLIB02) ADPTTYPE(*LAN) PROTOCOL(*APPC)
LIND(TRNLINE)
RMTLOCNAME(APPN.MLD01A APPN.MLD01B)
ADPTADR(0123456789AB 0123456789CD)
This command will create the necessary LAN communication controllers and devices and change the necessary parameters in the media library device description. It will also attempt to vary on the media library device. Note that the line description must exist prior to using the CFGDEVMLB command. The command does this in the following order:
. Create Controller Description (APPC) - CRTCTLAPPC MLD01A with ONLINE(*YES).
. Create Device Description (APPC) - CRTDEVAPPC MLD01A.
. Vary Configuration -VRYCFG MLD01A to vary on MLD01A APPC controller that was created.
. Create Controller Description (APPC) - CRTCTLAPPC MLD01B with ONLINE(*YES).
. Create Device Description (APPC) - CRTDEVAPPC MLD01B.
. Vary Configuration -VRYCFG MLD01B to vary on MLD01B APPC controller that was created.
. Change Device Description - CHGDEVMLB TAPLIB02 to change the parameter robot device to ROBOTDEV(MLD01A MLD01B) and to change the parameter online at IPL to ONLINE(*YES).
. Vary Configuration -VRYCFG TAPLIB02 to vary on the media library device.
If any of these commands is not successful, the CFGDEVMLB command will not be successful. Note that multiple media library device descriptions could have the same communication line. In this case, the controller description, and device will not be recreated, but the CHGDEVMLB and VRYCFG commands will still be used.
Example 4: Configuring a LAN-attached Media Library Device to Communicate Using TCP/IP
CFGDEVMLB DEV(TAPLIB02) ADPTTYPE(*LAN) PROTOCOL(*TCP)
ROBOTHOST(MLD01A) LCLINTNETA(10.1.2.3)
This command will change the robot information in the device description to the TCP/IP information provided. It will also attempt to vary on the media library device. Note that TCP/IP should be configured prior to using the CFGDEVMLB command. The command does this in the following order:
. Change Device Description - CHGDEVMLB TAPLIB02 to change the parameter robot host to ROBOTHOST(MLD01A) and the internet address to LCLINTNETA(10.1.2.3).
. Vary Configuration - VRYCFG TAPLIB02 to vary on the media library device.
If any of these commands is not successful, the CFGDEVMLB command will not be successful.