Host Environment Commands › ADDRESS MIM Command › TAPE Function › TAPE Function—Keyword Variables

TAPE Function—Keyword Variables

This section discusses the keyword variables unique to the ADDRESS MIM TAPE functions.

• Specify GLOBAL or LOCAL to limit the range of devices returned

  GLOBAL|LOCAL(name[FOR number]|[TO name]|[,name[,name…]])
  

  LOCAL

  Searches for devices based on their hardware address.

  GLOBAL

  Searches for devices based on the symbolic CA MIM names and then returns information for all devices on all systems in the CA MIA complex that match the specified criteria.

  There are 3 methods to specify devices within the GLOBAL|LOCAL keyword:

  • List - A list of up to 50 device names, delimited by a comma, can be stipulated. ADDRESS MIM TAPE will limit its enquiry to the devices in this list. For example:

    ADDRESS MIM “TAPE 'GLOBAL(R180,R182,R18A,R18F)'”
    

  • Range - Using TO as the second parameter between two device names will cause ADDRESS MIM TAPE to examine every device in-between, inclusive of the device names specified. An example of its use could be:

    ADDRESS MIM “TAPE 'GLOBAL(R180 TO R18F)'”
    

    Please note that the first device specified, in this case R180, must be the lower value.

  • Count - Using FOR as the second parameter will cause ADDRESS MIM TAPE to examine every device from the 1st parameter for the number specified in the 3rd parameter. An example of its use could be:

    ADDRESS MIM “TAPE 'GLOBAL(R180 FOR 16)'”
    

• Specify TAPE to choose the type of device on which to collect and return the Tape information

  TYPE(3420|3480|3490|3495|3590)
  

  You can choose only one of these five device types at any one time. If the TYPE keyword is omitted, all device types within the criteria are examined.

  Note: Device Type is only known for devices managed on the local system. Specifying this keyword automatically excludes any device not managed on the local system. Therefore, if the GLOBAL keyword is used in conjunction with the TYPE keyword, all results will be for devices that match the criteria on the local system only.

• Specify STATUS to restrict the returned data to only those devices that match the parameters on this keyword

  STATUS(ONLINE|OFFLINE|ALLOC|MPEND|OPEND)
  

  Only one of these five possible parameters can be used at a time.

  ALLOC

  Refers to devices that have been allocated to a job

  MPEND

  Refers to devices that are mount-pending

  OPEND

  Refers to devices that are offline-pending.

  If the STATUS keyword is omitted, data will be returned for devices under any status, provided they match the rest of the specified criteria.