Loop

The loop command starts an interactive command line session that is maintained until you enter quit.

If you are required to enter a password, you are prompted for it before the loop mode prompt appears.
Note: It is not possible to enter loop mode without a valid server contact. One of the consequences is that certain commands, such as restore backupset -location=file, are only accepted on the initial command line when a valid server is not available.

In an interactive command line session, it is unnecessary to precede each command name with dsmc and your password, if one is required.

Windows operating systemsIn interactive mode, options that you enter on the initial command line override the value that you specified in your client options file (dsm.opt). This value remains in effect for the entire interactive session unless overridden by a different value on a given interactive command. For example, if you set the subdir option to yes in your client options file (dsm.opt), and you specify subdir=no on the initial command line, the subdir=no setting remains in effect for the entire interactive session unless overridden by the subdir=yes value on a given interactive command. However, the subdir=yes value only affects the command it is entered on. When that command completes, the value reverts back to subdir=no, the value at the beginning of the interactive session.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsIn interactive mode, options that you enter on the initial command line override the value that you specified in your client user-options file (dsm.opt) or dsm.sys file. This value remains in effect for the entire interactive session unless overridden by a different value on a given interactive command. For example, if you set the subdir option to yes in your client user-options file (dsm.opt), and you specify subdir=no on the initial command line, the subdir=no setting remains in effect for the entire interactive session unless overridden by the subdir=yes value on a given interactive command. However, the subdir=yes value only affects the command it is entered on. When that command completes, the value reverts back to subdir=no, the value at the beginning of the interactive session.

You can enter all valid commands in interactive mode except the schedule and loop commands.

There are some options that you cannot use in the interactive session created by the loop command and are identified in the option description by this statement: This option is valid only on the initial command line. It is not valid in interactive mode.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsNote:
  1. In loop mode, following a restore operation directly from tape, the mount point is not released in case additional restore requests are made to that volume. If you request a backup operation in the same session and that mount point is the only one available, the backup operation stops with the following message:
      Waiting for mount of offline media
    In this case, the mount point is not released until one of the following conditions is met:
    • The device class MOUNTRETENTION limit is satisfied.
    • The client idletimeout period is satisfied.
    • The dsmc loop session is closed after the restore operation completes, allowing you to start a subsequent loop mode session to perform the backup operation.
  2. In interactive mode, you cannot enter a file specification that contains national language characters. If a command contains national characters, process the command in batch mode by preceding the command with the executable program name, dsmc.
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systems

Supported Clients

This command is valid for all clients.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-LOOP--------------------------------------------------------><

Parameters

There are no parameters for this command.

Examples

Task
Start an interactive command line session.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsWindows operating systemsCommand: dsmc

At the tsm> prompt, enter a command.

Windows operating systemsTo end an interactive session, enter quit

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsThere are two methods for ending an interactive session:

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systems
  • Enter quit
  • If you set editor=yes, you can do the following:
    1. Press the Escape key (Esc).
    2. Type Q and press the Enter key.
    AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsNote: The default setting is editor=yes.
Note: To interrupt a dsmc command before Tivoli® Storage Manager has finished processing, enter QQ on the Tivoli Storage Manager console. In many cases, but not all, this interrupts the command.