>Sheelagh,
>
>thanks a lot. But on typing "MOVE MEDIA vvvvvv " in the adsm admin command
>line mode, I get "unknown command".
>
>I'll have to further investigate if this command is really available on the
>MVS ADSM server , V3.1 .
>
>Thanks, René
>
>-----Original Message-----
>From: Sheelagh Treweek
>[SMTP:sheelagh.treweek AT computing-services.oxford.ac DOT uk]
>Sent: Wednesday, December 17, 1997 3:31 PM
>To: Lambelet,Rene,VEVEY,FC-SIL/INF.
>Subject: Re: Storagepool overflow
>
>
>Here's the move media command spec from V3!
>
>Regards, Sheelagh
>
>-----------------------------------------------------------------------------
>-
>-
>Sheelagh Treweek Email:
>sheelagh.treweek AT oucs.ox.ac DOT uk
>Oxford University Computing Services Tel: +44 (0)1865 273205
>13 Banbury Road, Oxford, OX2 6NN, UK Fax: +44 (0)1865 273275
>-----------------------------------------------------------------------------
>-
>-
>
>
>
>MOVE MEDIA (Move Sequential Access Storage Pool
>Media)
>
>Use the MOVE MEDIA command to identify, move, and track sequential access
>primary and copy storage pool volumes that are managed by an automated
>library
>(including an external library).
>
>This command processes one or more sequential access storage pool volumes.
>The
>volumes moved by MOVE DRMMEDIA for offsite recovery will not be processed
>by MOVE MEDIA command.
>
>This command generates a background process that can be cancelled with the
>CANCEL PROCESS command. To display information on background processes,
>use the QUERY PROCESS command.
>
>You can use the QUERY ACTLOG command to view whether the MOVE MEDIA
>command was successful. You can also view this information from the server
>console.
>
>Privilege Class
>
>To issue this command, you must have system, unrestricted storage, or
>operator
>privilege.
>
>Syntax
>
>>>-MOVe MEDia--volname---STGpool--=--poolname------------------->
>
> +-FULl--=--Yes----+
>>--+-----------------+-+-------------------------------+-------->
> +-FULl--=--+-No--++ +-OVFLOcation--=--locationname--+
> +-Yes-+
>
> +-REMove--=--Yes-----+
>>--+--------------------+--------------------------------------->
> +-REMove--=--+-No---++
> +-Yes--+
> +-Bulk-+
>
>>--+--------------------------------------------------------+--->
> +-CMd--=--"string substitution string substitution ..."--+
>
> +-APPend--=--No-----+
>>--+---------------------------+-+-------------------+---------><
> +-CMDFilename--=--filename--+ +-APPend--=--+-No--++
> +-Yes-+
>
>
>Parameters
>
>volname
>
> Specifies the name of the sequential access primary or copy storage
>pool
> volume to be checked out of the library and transitioned to
> MOUNTABLENOTINLIB state. You can use a pattern matching
> expression to specify the name. All matching volumes are considered for
> processing. This parameter is required.
>
>STGpool=poolname
>
> Specifies the name of the sequential access primary or copy storage
>pool
> that is used to select the volumes for processing. This parameter is
>required.
> You can use a pattern matching expression to specify the name. All
> matching storage pools are processed. If the storage pool specified is
>not
> managed by an automated library, no volumes are processed.
>
>FULl=fullvalue
>
> Specifies whether only full volumes are included in the selection for
> processing. This parameter is optional. The default is YES. Possible
>values
> are:
>
> Yes
>
> Specifies to process only full volumes.
>
> No
>
> Specifies to process both full and partial volumes.
>
>OVFLOcation=locationname
>
> Specifies the destination overflow location of the volumes being
>processed.
> This parameter is optional. The maximum length of the location is 255
> characters. The location must be enclosed in quotation marks if it
>contains
> any blank characters. If the destination overflow location is not
>specified
> with the OVFLOCATION parameter, the location defined by the
> DEFINE/UPDATE STGPOOL command, OVFLOCATION parameter will
> be used. If the location is not specified with the MOVE MEDIA command,
> OVFLOCATION parameter, nor with the DEFINE/UPDATE STGPOOL
> command, OVFLOCATION parameter, the location of the ejected storage
> pool volume is updated to a null string ("").
>
>REMove=removevalue
>
> Specifies whether ADSM ejects the volumes from the library during MOVE
> DRMEDIA processing. This parameter is optional. The default is YES.
> Possible values are:
>
> Yes
>
> Specifies that the volume is ejected from the library during MOVE
> DRMEDIA processing. The volume entry is deleted from the ADSM
> library inventory. This option applies to all automated
>libraries.
>
> No
>
> Specifies that the volume is not ejected from a SCSI library
>during
> MOVE DRMEDIA processing. This option only applies to a SCSI
> library. This option deletes the volume entry from the ADSM
>library
> inventory and leaves the volume in its slot. REMOVE=NO option
> does not apply to a 349x library. For a 349x library, the volume
>is
> always ejected from the library even if REMOVE=NO is specified on
> the MOVE DRMEDIA command.
>
> Bulk
>
> Specifies that the volume is ejected to a predefined high
>capacity
> area, instead of an I/O station, in the library. This parameter
>only
> applies to libraries with a defined bulk eject area (for example,
>349X
> libraries). This parameter does not apply to a library type of
>SCSI
>or
> EXTERNAL.
>
>CMd="string substitution string substitution ..."
>
> Specifies the creation of executable commands. This parameter is
>optional.
> You must enclose your command specification in quotation marks. The
> maximum length of the command specification is 255 characters. For each
> volume successfully processed by the MOVE MEDIA command, ADSM
> writes the associated commands to a file. The filename used by MOVE
> MEDIA is the filename specified with the CMDFILENAME parameter on
> the MOVE MEDIA command. If the filename is not specified on the MOVE
> MEDIA command, MOVE MEDIA will generate a default filename by
> appending the string "exec.cmds.media" to the ADSM server directory.
>
> If the length of the command written to the file exceeds 255
>characters,
>it is
> split into multiple lines and a continuation character, +, is added to
>all
>but the
> last line of the command. You may need to alter the continuation
>character
> according to the requirements of the product that executes the
>commands.
>
> If you do not specify CMD or specify a null string ("") for CMD, MOVE
> MEDIA will not generate any executable commands.
>
> string
>
> Specifies the string to build an executable command. You can
>specify
> any free form text for the string. Enclose the full string in
>quotation
> marks. For example, the following is a valid executable command
> specification:
>
> CMD="UPDATE VOLUME &VOL"
>
> The following is an invalid executable command specification:
>
> CMD=""UPDATE VOLUME" &VOL"
>
> substitution
>
> Specifies a substitution variable to tell MOVE MEDIA to
>substitute a
> value for the variable. The possible substitution variables are:
>
> &VOL
>
> Specifies the volume name is to be substituted for &VOL.
>You
> can specify lowercase characters, &vol. No spaces or blanks
> are allowed between ampersand, &, and VOL. If there are
> spaces or blanks between ampersand and VOL, MOVE
> MEDIA will treat them as strings and no substitution will
>be
> set. If &VOL is not specified, no volume name is set in the
> executable command.
>
> &LOC
>
> Specifies the volume location is to be substituted for
>&LOC.
> You can specify lowercase characters, &loc. No spaces or
> blanks are allowed between ampersand, &, and LOC. If there
> are spaces or blanks between ampersand and LOC, MOVE
> MEDIA will treat them as strings and no substitution will
>be
> set. If &LOC is not specified, no location name is set in
>the
> executable command.
>
> &VOLDSN
>
> Specifies the volume file name, that is to be substituted
>for
> &VOLDSN. An example of a storage pool tape volume file
> name using the default prefix ADSM is ADSM.BFS. If
> &VOLDSN is not specified, no volume file name is set in the
> executable command.
>
> &NL
>
> Specifies the new line character is to be substituted for
>&NL.
> When &NL is specified, MOVE MEDIA command will split
> the command at the position where the &NL is and will not
> append any continuation character. The user is responsible
>for
> specifying the proper continuation character before the &NL
>if
> one is required. The user is also responsible for the
>length
>of
> the line written. If the &NL is not specified and the
>length
>of
> the command line exceeds 255, the command line is split
>into
> multiple lines and a continuation character, +, is added to
>all
> but the last line of the command.
>
>CMDFilename=filename
>
> Specifies the full path name that will contain the commands specified
>with
> CMD. This parameter is optional. The maximum length of the file name is
> 1279 characters. If you do not specify a file name or specify a "" with
>the
> CMDFILENAME parameter, MOVE MEDIA will generate a default file
> name by appending the string "exec.cmds.media" to the ADSM server
> directory. The server directory is determined in the following order:
>
> 1.If defined, the directory pointed to by the DSMSERV_DIR
> environment variable.
>
> 2.If the DSMSERV_DIR environment variable is not defined, the
> current working directory of the ADSM server process.
>
> MOVE MEDIA automatically allocates the file name specified or
>generated.
> If the file name exists, MOVE MEDIA will attempt to use it and the
>existing
> data, if any, in the file to be overwritten. If this should happen and
>the
> executable commands in the file have not been run, issue QUERY MEDIA
> command to rebuild the executable commands for the desired volumes. You
> can specify APPEND=YES to prevent the existing data from being
> overwritten. If the MOVE MEDIA command fails after the command file is
> allocated, the file is not deleted.
>
>APPend=appendvalue
>
> Specifies whether to open the command file in append mode. This
>parameter
> is optional. The default is NO. Possible values are:
>
> No
>
> Specifies to write the data from the beginning of the command
>file.
>If
> the given command file exists, its contents are destroyed.
>
> Yes
>
> Specifies to open the command file in append mode for writing at
>the
> end of the file.
>
>Examples
>
>Task 1
>
>Move all full volumes that are in the ARCHIVE sequential primary storage pool
>out
>of the library.
>
>Command:
> move media * stgpool=archive
>
>Related Commands
>
>Table 117. Commands Related to MOVE MEDIA
> Command
> Description
> QUERY MEDIA
> Displays information about storage pool volumes moved by the
> MOVE MEDIA command.
>
>
>
>> René Lambelet - (3543 - *A581
>> Nestec SA - 55, Av. Nestlé - CH-1800 Vevey
>> Tél: ++41/21/924'35'43 / Fax: ++41/21/924'45'89
>> E-Mail: rene.lambelet AT nestle DOT com
>>
|